nim_clients_setup Command

Purpose

Define clients and initialize BOS install operation on NIM client objects.

Syntax

nim_clients_setup [ -m mksysb_resource] [ -n ] [ -c ] [ -r ] [ -v ] client_object(s)

Description

The nim_clients_setup command defines new client objects and initializes the BOS install operation for clients in the NIM environment by performing the following tasks:
  • Exports the environment variable NIM_LICENSE_ACCEPT=yes.
    • Used for accepting software license agreement during network install.
  • Adds variable entry NSORDER=local,bind in /etc/environment.
    • Necessary for name resolution when hosts only exist in /etc/host.
  • Defines client objects using client.defs file (if -c flag specified).
    • User must edit stanzas in /export/nim/client.defs file prior to using nim_clients_setup.
  • Prepares client objects for install.
    • If -c flag is used, defined clients are initialized for install.
    • If client objects are given, specified clients are initialized for install.
    • If -c or client objects are omitted, all existing NIM clients are initialized for install.
  • Resources contained in the group name basic_res_grp are used as resources during the BOS install operation.
Note: Thebasic_res_grp resource group is populated with resources created during nim_master_setup command execution. If this group is not present, it must be defined with NIM install resources prior to using the nim_clients_setup command.

Flags

Item Description
-m mksysb_resource Specifies an alternate backup image to restore during BOS install. The value for mksysb_resource may specify a NIM object name or absolute path location used for defining a new mksysb resource. By default, the mksysb resource is assigned from the basic_res_grp NIM resource group.
-n Enables native (rte) install and ignores restoring backup image (mksysb) during BOS install. By default, mksysb restore is performed during BOS install.
-c Defines client objects from the client.defs file. The /export/nim/client.defs file must exist and have valid client definition information. The client.defs file is created during nim_master_setup command execution. If the file is not present, a sample client.defs file may be copied from /usr/samples/nim/client.defs and edited by the user.
-r Reboots client objects after initiating BOS install operation. By default, clients are not rebooted. Resources are assigned for install and clients may be rebooted when desired.
-v Enables verbose debug output during command execution.

Security

Access Control: You must have root authority to run the nim_clients_setup command.

Location

/usr/sbin/nim_clients_setup

Examples

  1. To define client objects from /export/nim/client.defs file, initialize the newly defined clients for BOS install using resources from the basic_res_grp resource group, and reboot the clients to begin install, type: 
    nim_clients_setup -c -r
  2. To initialize clients client1 and client2 for BOS install, using the backup file /export/resource/NIM/530mach.sysb as the restore image, type: 
    nim_clients_setup -m /export/resource/NIM/530mach.sysb \ client1 client2
  3. To initialize all clients in the NIM environment for native (rte) BOS install using resources from the basic_res_grp resource group, type: 
    nim_clients_setup -n

Files

Item Description
/etc/niminfo Contains variables used by NIM.