[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Commands Reference, Volume 4

nimconfig Command


Initializes the Network Installation Management (NIM) master package.


To Initialize the NIM master package

nimconfig -a pif_name=Pif -a netname=Objectname [ -a master_port=PortNumber ] [ -a platform=Value ] [ -a registration_port=PortNumber ] [-a ring_speed=Speed | -a cable_type=CableType ]

To Rebuild the /etc/niminfo file:

nimconfig -r


The nimconfig command initializes the NIM master package. You must initialize the package before any other NIM commands can be used. When you use the -a flag to supply the proper attributes, the nimconfig command initializes the NIM environment by performing the following tasks:


-a Assigns the following attribute=value pairs:

Designates the primary network interface for the NIM master. This value must be a logical interface name (such as tr0 or en0) which is in the available state.

Specifies the port number of the nimesis daemon used for NIM client communication.

Specifies the platform. The supported platforms are:

Micro Channel-based, uniprocessor models

Micro Channeled-based, symmetric multiprocessor models

PowerPC PCI bus-based, uniprocessor models

PowerPC PCI bus-based, symmetric multiprocessor models

Specifies the name you want the nimconfig command to use when creating the network object to represent the network which the master's primary interface connects to.

Speed in Mbps. When the pif_name refers to a token ring network, this value must be given. Acceptable values are:



Specifies the ethernet cable type. When the pif_name refers to an ethernet network, this value must be given. Acceptable values are:




AIX 4.2 or later Attributes:

Specifies the port number used for NIM client registration. This attribute applies only to AIX 4.2 or later.

Note: If you do not specify port numbers on the command line, the port numbers in the /etc/services file for NIM are 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.
-r Rebuilds the /etc/niminfo file on the master using the information which already exists in the NIM database. Note that if the bos.sysmgt.nim.master package has not been configured on this machine, this option will fail. This option is provided in case the /etc/niminfo file is accidentally removed by a user.


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


  1. To initialize the NIM environment using token ring and the default NIM ports for network communications, enter:

    nimconfig -a pif_name=tr0 -a netname=net1 -a ring_speed=16
  2. To initialize the NIM environment using ethernet and the default NIM ports, enter:

    nimconfig -a pif_name=en0 -a master_port=1058 \
    -a netname = net2 -a cable_type=bnc
  3. To rebuild the /etc/niminfo file on the NIM master when that machine has already been correctly configured as a master, enter:

    nimconfig -r
  4. To initialize the NIM master using an ATM network interface, enter:

    nimconfig -a pif_name=at0 -a master_port=1058 -a netname=ATMnet

    Note: Because an interface to an ATM network does not currently support booting over the network, this operation will define a generic network object corresponding to the master's subnet.

AIX 4.2 or later Examples

  1. To initialize the NIM environment using TCP/IP port 1060 for NIM client communications and TCP/IP port 1061 for NIM client registration, enter:

    nimconfig -a pif_name=tr0 -a netname=net2 -a master_port=1060 \
    -a registration_port=1061 -a ring_speed=16


/etc/niminfo Contains variables used by NIM.

Related Information

The lsnim command, nim command, nimclient command, niminit command.

The .info file.

[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]