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]
Specifies to use the imaging operation type resource group or individual resources.
Specifies to use the resource group for imaging.
Specifies to use individual resources for imaging.
(Optional) Defines the URL for the service controller host.
Example: https://hostname:port/...
Defines the fully qualified host where the service controller is installed.
Example: localhost.ca.com
Defines the listening port for the service controller server.
Example: 80
(Optional) NIM installation type. Accepted values are rte or mksysb. rte is the default if –install_type is not specified.
Defines the name of the machine resource. This name must be predefined at the NIM Master.
Specifies name of the resource group.
Indicates whether the logical partition is imaged. Options are:
Images the logical partition.
Treats partition as machine to provision to, if basic NIM requirements are met.
Default: No
Specifies the Hardware Management Console (HMC) or Integrated Virtualization Manager (IVM) that controls the managed systems where the logical partition resides.
Specifies the managed system on which the logical partition resides. The managed system must exist on the HMC/IVM.
Specifies the logical partition to which the resources are going to be applied. The partition must exist on the managed system.
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.
Specifies whether CA Server Automation agents are deployed automatically. Options include the following:
Deploys CA Server Automation agents automatically.
Prevents CA Server Automation agents from being deployed automatically.
Default: no
Defines the user name used for deploying agents to the target host server to which you are deploying the image.
(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.
(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.
(Optional) Specifies a component ID that you can use to group hosts and users.
Defines the NIM master host name to perform the image deployment.
(Optional) Specifies the CA DSM scalability server for software distribution.
(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.
Wait indefinitely.
(Optional) Specifies whether to generate an event before the operation is performed.
(Optional) Specifies whether to generate an event after the operation is performed.
(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
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.
| Copyright © 2011 CA. All rights reserved. | Tell Technical Publications how we can improve this information |