installios Command

Purpose

Sets up the environment and creates NIM resources from the Virtual I/O Server DVD to install the Virtual I/O logical partition and the Integrated Virtualization Manager.

Syntax

To set up the environment and create NIM resources for installing a Virtual I/O logical partition or Integrated Virtualization Manager:

installios [ -p partition_name -i ipaddrorhostname -S subnet_mask -g gateway -d path -s system_name -r profile [ -n ] [ -P speed ] [ -D duplex ] [ -l language ] [ -L location ] [ -V vlan_tag ] [ -Y vlan_priority ] ]

To clean up tasks from the setup process:

installios -u [ -f | -U ]

Description

The installios command creates NIM resources from the Virtual I/O Server DVD to install a Virtual I/O logical partition and Integrated Virtualization Manager. When invoked on a NIM client, the -L flag must be specified with the location of the bos.sysmgt.nim.master fileset. The installios command configures the client as a NIM master and creates the resources from the Virtual I/O Server DVD to install the ioserver logical partition or the Integrated Virtualization Manager. After the logical partition or Integrated Virtualization Manager have been installed, the installios command can return the NIM master back to its original state by removing the created resources from the DVD or by unconfiguring the NIM master. All of the flags are optional. If no flags are specified, the installios wizard runs and the user is prompted to interactively enter the flag information.

Flags

Item Description
-d path Specifies the path to the installation images (/dev/cd0 or the path to a system backup of the Virtual I/O Server created by the backupios command. The path may also specify a remote NFS-mountable location such as hostname:/path_to_backup.
-D duplex Specifies duplex (optional). This is the duplex setting with which to configure the network interface of a client. The network interface of the client must support the value of the duplex parameter. This value can be full, half, or auto. The default value is full if you do not specify this flag.
-f Forces a cleanup to deallocate and remove resources which are not yet installed on a Virtual I/O logical partition or Integrated Virtualization Manager.
-g gateway Specifies the client gateway (the default gateway that the client will use during network installation of the Virtual I/O Server operating system).
-i ipaddrorhostname Specifies the client IP address or hostname (the IP address or hostname with which the network interface of a client will be configured for network installation of the Virtual I/O Server operating system).
-l language Specifies the language (optional). This is the language in which the license agreement will be displayed before the installation. When the license is viewed, a prompt displays asking if the license is to be accepted. If the prompt is answered with y, then the installation will proceed and the Virtual I/O Server license is automatically accepted after installation. If the prompt is answered with n, the installios command exits and the installation does not proceed. If this flag is not specified, the installation proceeds, but the Virtual I/O Server will not be usable until the license is manually accepted after installation.
-L location Specifies the location of the bos.sysmgt.nim.master fileset to configure a client to become a NIM master.
-n Specifies that the network interface of a client should not be configured. If this flag is specified, the network interface of a client will not be configured with the IP settings that were specified in the flags given to the installios command after the installation has completed.
-p partition_name Specifies the partition name. This is the name of the LPAR that will be installed with Virtual I/O Server operating system. This partition must be of type Virtual I/O Server and the partition name must match the name shown on the HMC; the name is not a host name.
-P speed Specifies speed (optional). This is the communication speed to use when configuring the network interface of a client. The network interface of the client must support the value of the speed parameter. This value can be 10, 100, 1000, or auto. The default value is 100 if you do not specify this flag.
-r profile Specifies the profile name. This is the name of the profile that will contain the hardware resources that will be installed.
-s system_name Specifies the managed system (the name of the managed system maintained by the HMC). This name must match the name shown on the HMC; the name is not a host name.
-S subnet_mask Specifies the client subnet mask (the subnet mask with which the network interface of a client will be configured for network installation of the Virtual I/O Server operating system).
-u Cleans up the environment to return the NIM master back to its original state.
-U Unconfigures the NIM master.
-V vlan_tag Specifies the virtual local area network (VLAN) tag identifier (0 to 4094) that is used for tagging Ethernet frames during the network installation for virtual network communication.
-Y vlan_priority Specifies the virtual local area network (VLAN) tag priority (0 to 7) that is used for tagging Ethernet frames during the network installation for virtual network communication.

Exit Status

Item Description
0 The installios command was successful.

Security

You must have root authority to run the installios command

Examples

  1. To create Virtual I/O resources on a NIM master for installing client 9.3.6.234, type:
    installios -d /dev/cd0 -i 9.3.6.234 -g 9.3.6.1 -S 255.255.255.0
  2. To create Virtual I/O resources on a NIM client for installing client 9.3.6.234 where /tmp contains the bos.sysmgt.nim.master fileset, type:
    installios -d /dev/cd0 -i 9.3.6.234 -g 9.3.6.1 -S 255.255.255.0 -L /tmp
  3. To clean up tasks performed while creating Virtual I/O resources, type:
    installios -u
  4. To clean up tasks performed during the creation of Virtual I/O resources on a logical partition which has not yet been installed, type:
    installios -u -f
  5. To clean up tasks and unconfigure NIM after creating Virtual I/O resources , type:
    installios -u -U

Location

/usr/sbin/installios

Files

Item Description
/usr/sbin/installios Contains the installios command
/etc/niminfo Contains variables used by NIM