Performs network installation operations on OS_install objects. This command is operable only in an Integrated Virtualization Manager environment.
Traditional usage:
OS_install {-o Operation} [ -a attr=value... ] {ObjectName}
For listing OS_install objects (list mode):
The OS_install command performs a network installation operation on an OS_install object. The type of operation is dependent on the type of object specified by the ObjectName parameter. The object pointed to by the ObjectName parameter can be one of three types: client, OS_Resource, or ControlHost. Command operations involve the creation and management of OS_install objects in order to perform network installation of operating systems on client systems.
The list mode of the OS_install command is used to list the current configuration of objects in the OS_install environment.
Flag name | Description |
---|---|
-a attr=value | Assigns the specified value to the specified attribute. Operations lists the required and optional attributes for a specific operation. |
-l | Lists all OS_install objects in the environment by default. |
-o Operation | Specifies an operation to perform on an OS_install object. |
-t object_type | object_name | Narrows the list returned by the -l flag to only objects of type object_type or to the single OS_install object specified by object_name. |
-v | Displays the list returned by the -l flag. |
Operation | Description | Required Attributes | Optional Attributes |
---|---|---|---|
define_client [-a attr=value...] {ClientObjectName} | Defines a new client object. |
|
|
define_resource [-a attr=value...] {ResourceObjectName} | Defines a new OS_Resource object. |
|
|
define_ctrl_host [-a attr=value...] {ControlHostObjectName} | Defines a new Hardware Control Host object. |
|
None. |
allocate [-a attr=value...] {ClientObjectName} | Allocates an OS_Resource object to a client object. Both objects must already exist in the OS_install environment. An error will occur if the client object has an OS_Resource object already allocated to it. |
|
None. |
netboot {ClientObjectName} | Instructs the hardware control host of the client object to initiate a network boot. | None. | None. |
monitor_installation {ClientObjectName} | Monitors the installation status of the client object. | None. | None. |
deallocate {ClientObjectName} | Deallocates the OS_Resource object that was allocated to the client object by an allocate operation. | None. | None. |
remove {ObjectName} | Removes the object from the OS_install environment. | None. | None. |
Return code | Description |
---|---|
0 | The command completed successfully. |
>0 | An error occurred. |
OS_install -o define_client -a ip_addr=128.0.64.117
-a mac_addr=ab:cc:de:10:23:45 -a gateway=128.0.64.1
-a subnet_mask=255.255.255.0 -a ctrl_host=myhmc -a lpar=AIX1
-a profile=AIX1 -a managed_system=myMngSys myclient01
OS_install -o define_resource -a location=/images/AIX/53ML3 -a type=AIX
-a version=53ML3 my53resource
OS_install -o allocate -a os_resource=my53resource myclient01
OS_install -o deallocate myclient01
OS_install -o define_ctrl_host -a type=ivm -a hostname=ivm_hostname
-a communication_method=ssh myivm
OS_install -o monitor_installation myclient01
OS_install -o remove my53resource
OS_install -o remove myclient01