Adding VIOS management objects to the NIM environment

Follow the instructions to add a Virtual I/O Server management object.

A Virtual Input or Output Server (VIOS) object is managed by a CEC object in NIM. These operations require the dsm.core fileset to be installed on the NIM master.

To add VIOS object from the command line, follow these steps:

To define a VIOS object, the VIOSLPAR identifier must be retrieved. You can use one of the method to obtain the information.

Method 1: Use the nimquery command to retrieve the information. Define the CEC object in NIM and if the openssh.base.client fileset is installed, use the nimquery command to retrieve the VIOS attributes. On the NIM master, type:
```
# nimquery -a cec=cecObjectName -p
```
Part of the information about each LPAR of the CEC object including the Virtual I/O Server is displayed.

Method 2: Log into the HMC object and use the lssyscfg command to retrieve the VIOS information. For example, to use the following configuration:

cec name on the hmc = cec1
HMC login = hmcLogin
HMC host name = hmcHost

On the NIM master, type:

# ssh hmcLogin@hmcHost lssyscfg -r lpar -m cec1 -F name,lpar_type,lpar_id | grep vioserver
ndaf1ios_lpar,vioserver,2

If the network object that describes the network mask and the gateway used by the IVM does not exist, use the net_definition attribute.

Note: You must manually remove the file pointed to the passwd_file attribute after you remove the IVM objects.

Defining the VIOS object

On the NIM master, type the following after you have retrieved the VIOS object:

# nim -o define -t vios -a if1=InterfaceDescription \
-a mgmt_source=cecObjectName -a identity=viosLPARIdentifier \
-a net_definition=DefinitionName -a ring_speed1=SpeedValue \
-a cable_type1=TypeValue -a iplrom_emu=DeviceName ViosName

Example

To add a machine with the host name machine1 that has the following configuration:

host name=vios1
cec object name=cec1
vios lpar identifier=2
platform=chrp
kernel=64
network type=ethernet
subnet mask=255.255.240.0
default gateway=gw1
default gateway used by NIM master=gw_master
cable type=N/A
network boot capability=yes (no emulation needed)

Enter the following command sequence:

# nim -o define -t vios -a if1="find_net vios1 0" \
-a cable_type1="N/A" \
-a mgmt_source=cec1 -a identity=2 \
-a net_definition="ent 255.255.240.0 gw1 gw_master" machine1

For additional information, see the file /opt/ibm/sysmgt/dsm/doc/dsm_tech_note.pdf of the dsm.core fileset.