The dpmlpar image command creates an IBM AIX LPAR using the HMC/IVM and a target IBM AIX managed system. (Optional) You can deploy the IBM AIX operating system after you create the LPAR.
This command has the following format:
dpmlpar image [-sc sc_url] -hmc name -managed_system managedsystemname -partition_name partitionname -profile_name lparprofile (HMC only) [-profile_name lparname] (IVM only)
-min_mem size -desired_mem size -max_mem size
-proc_mode {shared|dedicated} -min_proc_units units -desired_proc_units units -max_proc_units units
-min_procs number -desired_procs number -max_procs number
-max_virtual_slots number -share_mode {capped|uncapped} [-uncap_weight weight] [-io_slot DRC index,{true|false}] [-lpar_io_pool_id id {,id, …}]
[-virtual_serial_adapter slot_num, remote_lpar_name, remote_slot_num, is_required] [-virtual_scsi_client_adapter slot_num, remote_lpar_name, remote_slot_num, is_required] | [-virtual_scsi_server_client_adapter virtual_io_server_name, backing_device_name, client_slot_num, is_required] [-virtual_eth_adapter slot_num, is_IEEE, port_vlan_id, (additional_vlan_id, additional_vlan_id, …), trunk_priority, is_required] [-virtual_fc_server_client_adapter virtual_io_server_name, physical_fc_port_name, client_slot_num, is_required [virtual_io_server_name,physical_fc_port_name,client_slot_num,is_required;...]]
[-pre] [-post] [-ws_user username] [-ws_password password]
[-encrypted_password {no|yes}] [-prompt <no|yes>]
[-ws_remote_user username] [-ws_remote_password password]
[-create_logical_volume <false|true>] [-logical_volume_size <value>] [-volume_group_names <value>] [-logical_volume_name <value>] [-use_logical_volume_name_as_prefix {no|yes}] [-default_vio_server_name vioserver] [-itcm_server itcmservername] [-locale iso639value]
Parameters for imaging AIX using the NIM MKSYSB utility
[-install_type {rte|mksysb}]
-mksysb mksysb_resource
-lpp lpp_resource
-bosinst_data bos_install_data_resource
-image_data image_data_resource
Parameters for provisioning AIX using a resource group
-provision_aix true -type res_group -res_group_name resourcegroupname -machine_res_name machineresourcename -target_username targetusername [-target_password targetpassword] [-auth_file authorizationfilename] [-auth_comp componentID] -nim_master_host_name nimmasterhostname [-scalability_server servername] [-deploy_template templatename] -auto_deploy {yes|no} [-wait [timeout]]
Parameters for provisioning AIX using individual resources
-provision_aix true -type individual_res -machine_res_name machineresourcename -lpp lppresource -spot spotresource -bosinst_data bosdata -resolv_conf resolveconf -fb_script fbscript -post_inst_scripts script1,script2,script3 -target_username targetusername [-target_password targetpassword] [-auth_file authorizationfilename] [-auth_comp componentID] -nim_master_host_name nimmasterhostname [-scalability_server servername] [-deploy_template templatename] -auto_deploy {yes|no} [-wait [timeout]]
(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
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 name of a logical partition to create.
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.
Defines the minimum amount of memory for the partition.
Defines the desired amount of memory for the partition.
Defines the maximum amount of memory for the partition.
Specifies the type of processor mode for the partition. Options include the following:
Shares processor resources with other partitions.
Specifies that the partition has dedicated processor resources.
Defines the minimum number of processing units for this partition.
Limits: .01 increments
Note: This option can only be used with shared processors.
Defines the assigned number of processing units for this partition.
Limits: .01 increments
Note: This option can only be used with shared processors.
Defines the maximum number of processing units for this partition.
Limits: .01 increments
Note: This option can only be used with shared processors.
Defines the minimum number of virtual processors for this partition.
Note: This option can only be used with shared processors.
Defines the assigned number of virtual processors for this partition.
Note: This option can only be used with shared processors.
Defines the maximum number of virtual processors for this partition.
Note: This option can only be used with shared processors.
Specifies whether the managed system allows the logical partition to use idle processing units that are not committed to another partition from the shared processor pool.
Note: This option can only be used with shared processors.
Options include the following:
Specifies that the partition can only use the number of processing units that are committed to it.
Specifies that the partition can use idle processor units from the shared processor pool when they are available.
(Optional) Defines a weighted average of processing priority when you select uncapped sharing mode.
Limits: 0 - 255
Defines the maximum number of virtual adapters for this partition.
Default: 2
Limits: 2 - 65,536
(Optional) Specifies the I/O slot for a physical component. You can specify this value multiple times for different I/O devices.
Specifies the slot dynamic reconfiguration connector (DRC) index.
Specifies that a DRC index is required for the I/O slot.
Specifies that a DRC index is not required for the I/O slot.
(Optional) Defines the group of I/O adapters that can be taken over and used by any of a specified group of logical partitions without any active intervention from the HMC. The group of partitions can be a comma-separated list of I/O pool IDs.
(Optional) Defines the virtual serial adapters for this logical partition. The variable is_required can be set to true or false. Only client serial adapter is supported, but can be specified multiple times.
Default: Two server serial adapters created in slots 1 and 2.
Note: Not supported for creating an LPAR on IVM.
(Optional) Defines the virtual ethernet adapters for this logical partition and can be specified multiple times. Optional values are vlan_idn and trunk_priority. The variables is_IEEE and is_required can be set to true or false. Additional vlan_ids must be comma-separated and enclosed in parentheses.
Note: When creating an LPAR on IVM, slot_num must be greater than or equal to 4.
Example: 4,false,1,,,true
(Optional) Defines a virtual Fibre Channel (FC) client adapter, FC server adapter on VIO server, and associates the FC server adapter to the physical FC port. This option is not valid when the -provision_aix option is set to true. This parameter can be specified multiple times. The variable is_required can be set to true or false.
(Optional) Defines the virtual client SCSI adapters for this logical partition and can be specified multiple times. The variable is_required can be set to true or false.
(Optional) Defines a virtual SCSI server device and virtual SCSI client device, which is automatically linked after the server device is created and the server slot number is identified. This parameter can be specified multiple times. The variable is_required can be set to true or false.
Example: CUST-VIOSERVER,hdisk5,3,true
Note: If you create Logical Volume using the dpmlpar image command and set the -create_logical_volume option to 'yes', the -virtual_scsi_server_client_adapter option is not required and shall be omitted.
(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 the credentials to use for the web service security check. If you do not include credentials, you are prompted to enter them. Avoid the prompt for credentials by setting up your own session using caaipsecurity.
(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".
(Optional) Specifies whether the user password is encrypted.
Default: No
(Optional) Specifies whether you are prompted for the web service user ID and password.
Default: Yes
(Optional) Specifies the CA Server Automation remote user name.
(Optional) Specifies the CA Server Automation remote password.
(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".
(Optional) Specifies whether to create Logical Volume.
Default: no
Note: If you create Logical Volume using the dpmlpar image command and set the -create_logical_volume option to 'yes', the -virtual_scsi_server_client_adapter option is not required and shall be omitted.
(Optional) Defines the size of the Logical Volume in MB.
(Optional) Specifies the Logical Volume group names as a comma-separated list.
(Optional) Defines the name of the Logical Volume.
(Optional) Specifies whether to use the Logical Volume Name as a prefix.
Default: no
(Optional) Specifies the VIO server that is used for creation of Logical Volumes.
(Optional) Specifies the name of the CA ITCM Server.
Parameters used for imaging with NIM mksysb
(Optional) NIM installation type. Accepted values are rte or mksysb. rte is the default if –install_type is not specified.
mksysb resource. Only valid if –install_type is mksysb.
Specifies the licensed program product files to use for an imaging request. Optional if –install_type is mksysb. Required if -install_type is rte.
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.
(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.
Parameters used for provisioning
(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.
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
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.
(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.
(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.
Specifies the licensed program product files to use for an imaging request. Optional if –install_type is mksysb. Required if -install_type is rte.
Defines the name of the machine resource. This name must be predefined at the NIM Master.
Defines the NIM master host name to perform the image deployment.
(Optional) Specifies a comma-separated list of scripts to run after installation.
Indicates whether the partition is imaged using NIM, after you create it.
Uses NIM to image the partition that you created. If you set to true, the NIM resource group or NIM individual resource parameters are used. See the dpmnim image Command|Deploy an IBM AIX Image Using a Resource Group and dpmnim image Command|Deploy an IBM AIX Image Using an Individual Resource. The job ID is returned when NIM provisioning starts.
Does not use NIM to image the partition that you created. No job ID is returned.
Defines the name of the resource group.
(Optional) Defines a file that contains valid /etc/resolv.conf entries that define Domain Name Protocol name-server information for local resolver routines.
(Optional) Specifies the CA ITCM scalability server for software distribution.
Defines the shared product object tree to use for an imaging request.
(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.
Defines the user name used for deploying agents to the target host server to which you are deploying the image.
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) 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.
Example: Create an IBM AIX Logical Partition
This example creates a logical partition, but does not provision it.
dpmlpar image -hmc ivm01 -managed_system testMS -partition_name lpartest01 -profile_name lpartest01 -max_virtual_slots 10 -min_mem 128 -desired_mem 256 -max_mem 2048 -min_procs 1 -desired_procs 2 -max_procs 5 -proc_mode shared -share_mode uncapped -uncap_weight 123 -min_proc_units .5 -max_proc_units 3.25 -desired_proc_units 1.75 -virtual_serial_adapter 2,serial_partition,1,true -virtual_scsi_client_adapter 3,scsi_partition,7,true -virtual_eth_adapter 4,true,1,(22,35,54),,true -io_slot 21020003,false
Example: Create an IBM AIX Logical Partition and Image it Using Individual Resources
This example creates a logical partition and provisions it using individual resources.
dpmlpar image -hmc hmc01 -managed_system testMS -partition_name IRTEST -profile_name Default -max_virtual_slots 10 -min_mem 128 -desired_mem 256 -max_mem 2048 -min_procs 1 -desired_procs 1 -max_procs 1 -proc_mode dedicated -virtual_serial_adapter 2,SerialPartition,1,true -virtual_scsi_client_adapter 3,SCSIPartition,7,true -virtual_eth_adapter 4,true,1,(22,35,54),0,true -io_slot 21020003,false -provision_aix true -type individual_res -lpp 530lpp_res -spot 530spot_res -bosinst_data 530_bid_ow -resolv_conf master_net_conf -post_inst_scripts piScript -machine_res_name MachineName -nim_master_host_name machine.mydomain.com -auto_deploy no -target_username root -target_password password
Example: Create an IBM AIX Logical Partition and Image it Using a Resource Group
This example creates a logical partition and provisions it using a resource group.
dpmlpar image -hmc hmc02 -managed_system testMS -partition_name RGTEST -profile_name Default -max_virtual_slots 10 -min_mem 128 -desired_mem 256 -max_mem 2048 -min_procs 1 -desired_procs 2 -max_procs 5 -proc_mode dedicated -virtual_serial_adapter 2,SerialPartition,1,true -virtual_scsi_client_adapter 3,SCSIPartition,7,true -virtual_eth_adapter 4,true,1,(22,35,54),,true -io_slot 21020003,false -provision_aix true -type res_group -res_group_name Res_grp -machine_res_name Machine -nim_master_host_name machine.mydomain.com -auto_deploy no -target_username root -target_password password
Copyright © 2013 CA. All rights reserved. |
|