Previous Topic: Network Installation Management Commands

Next Topic: dpmnim image Command—Deploy an IBM AIX Image Using a Resource Group


dpmnim image Command—Deploy an IBM AIX Image Using Individual Resources

The dpmnim image command deploys an IBM AIX image from a NIM master server to a target IBM AIX server using individual resources.

This command has the following format:

dpmnim image [-sc sc_url] -type individual_res [-install_type {rte|mksysb}] -spot spotResource [mksysb mksysbResource] [-lpp lppResource]  [-boinst_data bosdataResource] [-resolv_conf resolveconf] [-fb_script fbscript] [-post_inst_scripts script1, script2, script3] [-image_data imageDataResource] -machine_res_name machineresourcename -auto_deploy {Yes|No} -target_username targetusername [-target_password targetpassword] [-auth_file authorizationfile] [-auth_comp componentID] -nim_master_host_name nimmasterhostname [-scalability_server servername] [-deploy_template templatename] [-wait [timeout]] [-pre] [-post][-locale iso629value]
-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

-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.

-install_type {rte|mksysb}

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

-spot spotResource [mksysbResource]

Defines the shared product object tree to use for an imaging request.

-mksysb mksysbResource

mksysb resource. Only valid if –install_type is mksysb.

-lpp lpp_resource

Specifies the licensed program product files to use for an imaging request. Optional if –install_type is mksysb. Required if -install_type is rte.

-bosinst_data bos_install_data_resource

Specifies a file that contains information for the base operating system (BOS) installation program. Optional if –install_type is mksysb. Required if -install_type is rte.

-resolve_conf resolveconf

(Optional) Defines a file that contains valid /etc/resolv.conf entries that define Domain Name Protocol name-server information for local resolver routines.

-fb_script fbscript

(Optional) Defines the name of the file to use to configure devices when a NIM client is initially booting after the BOS installation process is complete.

-post_inst_scripts script1,script2,script3

(Optional) Specifies a comma-separated list of scripts to run after installation.

-image_data imageDataResource

(Optional) Specifies the image data resource file that describes how physical disks, volume groups, logical volumes, file systems, and paging space are configured on the root volume.

-machine_res_name machineresourcename

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

-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 ITCM scalability server for software distribution.

-deploy_template templatename

(Optional) Specifies the name of the generic template created in CA Server Automation.

Note: Do not confuse this template with the templates created and managed by VMware vCenter.

-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 to override the default English output, for example, fr_FR for French. To use the locale of the command prompt, specify "native".

Example: Deploy an IBM AIX image to a server using individual resources

This example deploys an IBM AIX image from a NIM Master server to a server using individual resources.

dpmnim image -type individual_res -machine_res_name development_1 -lpp 5301l_res -spot 530spot_res -bosinst_data 530_bid_ow -resolv_conf master_net_conf -fb_script fb1 -post_inst_scripts script1,script2 -auto_deploy yes -target_username root -target_password testpw -nim_master_host_name main_master

Example: Deploy an IBM AIX image by specifying individual resources with a MKSYSB image.

This example deploys an IBM AIX image from a NIM Master server to a server using MKSYSB installation.

dpmnim image -type individual_res -install_type mksysb -machine_res_name development_1 -spot 530spot_res -mksysb 5300_mksysb_image -target_username root -target_password testpw -nim_master_host_name main_master

Example: Deploy an IBM AIX image to a server using RTE installation by specifying individual resources.

This example deploys an IBM AIX image from a NIM Master server using RTE installation using individual resource to an IBM AIX server.

dpmnim image -type individual_res -install_type rte -machine_res_name development_1 -lpp 5301l_res -spot 530spot_res -bosinst_data 530_bid_ow -resolv_conf master_net_conf -fb_script fb1 -post_inst_scripts script1,script2 -target_username root -target_password testpw -nim_master_host_name main_master