Previous Topic: dpmnim image Command—Deploy an IBM AIX Image to an Existing LPAR Using Individual Resources

Next Topic: caaipaomwsclient Command--Enumerating Objects

dpmnim image Command—Deploy an IBM AIX Image to an Existing LPAR Using a Resource Group

The dpmnim image command uses a resource group to deploy an IBM AIX image from a NIM master server to an existing IBM AIX logical partition (LPAR).

This command has the following format:

dpmnim image -type res_group [-sc sc_url] [-install_type {rte|mksysb}] -res_group_name resourcegroupname -machine_res_name machineresourcename -provision_lpar {Yes|No} -hmc name -managed_system managedsystemname -partition_name partitionname [-profile_name lparprofile|lparname] -auto_deploy {Yes|No} -target_username targetusername [-target_password targetpassword] [-auth_file authorizationfile] [-auth_comp componentID] -nim_master_host_name nimmasterhostname [-scalability_server servername] [‑wait [timeout]] [-pre] [-post][-locale iso629value]
-type {res_group|individual_res}

Specifies to use the imaging operation type resource group or individual resources.

res_group

Specifies to use the resource group for imaging.

individual_res

Specifies to use individual resources for imaging.

-sc sc_url

(Optional) Defines the URL for the service controller host.

Example: https://hostname:port/...

hostname

Defines the fully qualified host where the service controller is installed.

Example: localhost.ca.com

port

Defines the listening port for the service controller server.

Example: 80

-install_type {rte|mksysb}

(Optional) NIM installation type. Accepted values are rte or mksysb. rte is the default if –install_type is not specified.

-machine_res_name machineresourcename

Defines the name of the machine resource. This name must be predefined at the NIM Master.

-res_group_name resourcegroupname

Specifies name of the resource group.

-provision_lpar {Yes|No}

Indicates whether the logical partition is imaged. Options are:

Yes

Images the logical partition.

No

Treats partition as machine to provision to, if basic NIM requirements are met.

Default: No

-hmc name

Specifies the Hardware Management Console (HMC) or Integrated Virtualization Manager (IVM) that controls the managed systems where the logical partition resides.

-managed_system managedsystemname

Specifies the managed system on which the logical partition resides. The managed system must exist on the HMC/IVM.

-partition_name partitionname

Specifies the logical partition to which the resources are going to be applied. The partition must exist on the managed system.

-profile_name lparprofile (HMC only)
[-profile_name lparname] (IVM only)

Specifies the partition profile to use when you activate the logical partition. Required for HMC. Optional for IVM, and if specified the name must match the partition name.

-auto_deploy {yes|no}

Specifies whether CA Server Automation agents are deployed automatically. Options include the following:

yes

Deploys CA Server Automation agents automatically.

no

Prevents CA Server Automation agents from being deployed automatically.

Default: no

-target_username targetusername

Defines the user name used for deploying agents to the target host server to which you are deploying the image.

-target_password targetpassword

(Optional) Defines the user password used for deploying agents to the target host server to which you are deploying the image. If you do not specify the password, it is retrieved from the authorization file.

Note: Use the dpmutil CLI to set up the authorization file.

-auth_file authorizationfilename

(Optional) Specifies the full path name of the authorization file to use to retrieve the encrypted password. This file contains the CA Server Automation administrator credentials that were generated using the dpmutil set auth command. When this option is not specified, the default authorization file is used.

-auth_comp componentID

(Optional) Specifies a component ID that you can use to group hosts and users.

-nim_master_host_name nimmasterhostname

Defines the NIM master host name to perform the image deployment.

-scalability_server servername

(Optional) Specifies the CA DSM scalability server for software distribution.

-wait [timeout]

(Optional) Indicates whether to display the status of the job and not return until the operation completes, fails, or the timeout period is met (if you specify a timeout value). If you do not specify this option, the CLI returns without waiting for completion. If there is no response, the optional timeout value defines the timeout period in minutes. If you enter the wait option with no timeout value, the CLI uses the default wait time from the caimgconf.cfg file or defaults to 120 minutes. In addition to any positive integer, the following timeout values are also possible:

""

No timeout value.

0

Wait indefinitely.

-pre

(Optional) Specifies whether to generate an event before the operation is performed.

-post

(Optional) Specifies whether to generate an event after the operation is performed.

-locale iso639value

(Optional) Specifies an IS0 639_3166 combination (for example: fr_FR for French) to override the default English output. To use the locale of the command prompt, specify "native".

Example: Deploy an IBM AIX Image Using MKSYSB Installation

This example deploys an IBM AIX image by using a resource group that contains a mksysb resource.

dpmnim image -type res_group -install_type mksysb -res_group_name mksysb_res_group -machine_res_name development_1 -auto_deploy yes -target_username root -target_password testpw -nim_master_host_name main_master -provision_lpar yes -hmc hmc01 -managed_system testMS -partition_name lpartest01 -profile_name Default

Example: Deploy an IBM AIX Image Using RTE Installation

This example deploys an IBM AIX image by RTE installation using a resource group.

dpmnim image -type res_group -install_type rte -res_group_name basic_res_group -machine_res_name development_1 -auto_deploy yes -target_username root -target_password testpw -nim_master_host_name main_master -provision_lpar yes -hmc hmc01 -managed_system testMS -partition_name lpartest01 -profile_name Default

Example: Deploy an Image to an IBM AIX LPAR Using a Resource Group

This example deploys an IBM AIX image from a NIM Master server to an IBM AIX LPAR using a resource group.

dpmnim image -type res_group -res_group_name basic_res_group -machine_res_name ResPartition -provision_lpar yes -hmc hmc01 -managed_system testMS -partition_name lpartest01 -profile_name Default -auto_deploy no -target_username root -target_password testpw -nim_master_host_name machine.domain.com

Object Model Utility Commands

Caaipaomwsclient.exe is a general utility that you can use to diagnose problems in the product infrastructure. Some of the tasks it can do include:

Be careful when performing any operation directly on the database. Generally, this utility is used only when working with CA Technologies Technical Support.