niminit Command

Purpose

Configures the Network Installation Management (NIM) client package.

Syntax

To Configure the NIM Client Package

niminit  {  -a name=Name -a pif_name=Pif -a master=Hostname  } [ -a master_port=PortNumber ] [ -a registration_port=PortNumber ] [ -a cable_type=Type  |  -a ring_speed=Speed  ] [  -a iplrom_emu=Device ] [ -a  platform=PlatformType ] [ -a netboot_kernel=NetbootKernelType ] [  -a  adpt_addr=AdapterAddress  ]

To Rebuild the /etc/niminfo File

niminit {-a name=Name -a master=Hostname  -a master_port=PortNumber}

Description

The niminit command configures the NIM client package. This must be done before the nimclient command can be used. When the required attributes are supplied to the niminit command, a new machine object will be created to represent the machine where the niminit command is being executed. When the niminit command completes successfully, the machine will be able to participate in the NIM environment.

Once the NIM client package has been successfully configured, the niminit command may be run again to rebuild the /etc/niminfo on the client. The /etc/niminfo file is used by the nimclient command and must be rebuilt if it is accidentally removed by a user.

Flags

AIX Version 4.2 or later Attributes:

Notes:

1. If you do not specify port numbers on the command line, the port numbers in the /etc/services file for NIM is used. If the /etc/services file does not contain entries for the NIM ports nim and nimreg , the default values of 1058 for master_port and 1059 for registration_port are used.
2. The values used for master_port and registration_port should match the values used by the NIM master. To display the values used by the NIM master, run the command lsnim -l master on the NIM master.

   netboot_kernel=NetbootKernelType	Specifies the type of kernel to use when booting the client over the network. The netboot_kernel values are: up Kernel for uniprocessor machines mp Kernel for multiprocessor machines
   	The default is up.

Security

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

Examples

1. To configure the NIM client package on a machine which has a BOOTP-enabled IPL ROM such that it will be known as scuba in the NIM environment, using en0 as its primary interface and an ethernet cable type of bnc , and specifying that it communicates with the NIM master using the master's hostname of manta and the default NIM ports located in /etc/services for network install communications, enter:

   niminit -a name=scuba -a pif_name=en0 -a cable_type=bnc \
   -a master=manta

2. To rebuild the /etc/niminfo file when it has accidentally been removed by a user, using a hostname of superman for the master's hostname and a port number of 1058 , enter:

   niminit -a name=robin -a master=superman -a master_port=1058

3. To configure the NIM client package on a machine that is a PowerPC PCI bus-based, uniprocessor system that has a BOOTP-enabled IPL ROM such that it will be known as starfish in the NIM environment, using en0 as its primary interface and an Ethernet cable type of dix , and specifying that it communicates with the NIM master using the master's host name of whale and a port number of 1058 , enter:

   niminit -a name=starfish -a pif_name=en0 -a cable_type=dix \
   -a master=whale -a master_port=1058 -a platform=rspc

4. To configure the NIM client, on a machine to be known as bluefish in the NIM environment, using at0 as its primary interface and specifying that it communicates with the NIM master using the master's host name redfish and a port number of 1058 , enter:

   niminit -a name=bluefish -a pif_name=at0 -a master=redfish \
   -a master_port=1058

   Note: Because an interface to an ATM network does not currently support booting over the network, this operation will define a machine object on the NIM master if a Generic network object corresponding to the client's subnet is already defined.

5. To configure the NIM client on a machine that is a PowerPC PCI bus-based, symmetric multiprocessor system that has a BOOTP-enabled IPL ROM such that it will be it will be known as jellyfish in the NIM environment, using en0 as its primary interface and an Ethernet cable type of dix , and specifying that it communicates with the NIM master using the master's host name of whale and a port number of 1058 , enter:

   niminit -a name=jellyfish -a pif_name=en0 -a cable_type=dix \
   -a master=whale -a master_port=1058 -a platform=rspcsmp

AIX Version 4.2 or later Examples:

1. To configure the NIM client package on a machine which will use an IPL ROM emulation in device /dev/fd0 , such that it will be known as octopus in the NIM environment and uses tr0 as its primary interface and a ring speed of 16 , and communicates with the NIM master using the master's hostname of dolphin and a port number of 1700 for client communications and 1701 for client registration, enter:

   niminit -a iplrom_emu=/dev/fd0 -a name=octopus -a pif_name=tr0 \
   -a ring_speed=16 -a master=dolphin -a master_port=1700 \
   -a registration_port=1701

File

Related Information

The lsnim command, nim command, nimclient command, nimconfig command.

The .info file.