上一主题: dpmlpar getresources 命令-获取 LPAR 资源下一主题: dpmlpar imgjobcheck 命令-检索 IBM AIX 映像作业的状态


dpmlpar image 命令-创建 IBM AIX LPAR

dpmlpar image 命令用于创建使用 HMC/IVM 的 IBM AIX LPAR 和目标 IBM AIX 受管系统。 (可选)可以在创建 LPAR 之后部署 IBM AIX 操作系统。

此命令具有以下格式:

dpmlpar image [-sc sc_url] 
-hmc name 
-managed_system managedsystemname 
-partition_name partitionname 
-profile_name lparprofile(仅 HMC)
[-profile_name lparname](仅 IVM)
-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]

用于使用 NIM MKSYSB 实用工具为 AIX 制作的参数

[-install_type {rte|mksysb}]
-mksysb	mksysb_resource
-lpp lpp_resource
-bosinst_data bos_install_data_resource
-image_data image_data_resource

使用资源组开通 AIX 的参数

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

使用单个资源开通 AIX 的参数

-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]]
-sc sc_url

(可选)为服务控制器主机定义 URL。

示例:https://hostname:port/...

hostname

定义安装了服务控制器的完全限定主机。

示例:localhost.ca.com

port

定义服务控制器服务器的侦听端口。

示例:80

-hmc name

指定控制逻辑分区所在的受管系统的硬件管理控制台 (HMC) 或集成虚拟化管理器 (IVM)。

-managed_system managedsystemname

指定逻辑分区所驻留的受管系统。 受管系统必须存在于 HMC/IVM 上。

-partition_name partitionname

指定要创建的逻辑分区的名称。

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

指定激活逻辑分区时要使用的分区配置文件。 对于 HMC 为必需。 对于 IVM 为可选,如果已指定,该名称必须与分区名称匹配。

-min_mem size

定义分区的最小内存量。

-desired_mem size

定义分区所需的内存量。

-max_mem size

定义分区的最大内存量。

-proc_mode {shared|dedicated}

指定分区的处理器模式的类型。 选项包括:

shared

与其他分区共享处理器资源。

dedicated

指定分区具有专用处理器资源。

-min_proc_units units

定义该分区的最小处理单元数。

限制:.01 增量

注意:该选项仅适用于共享处理器。

-desired_proc_units units

定义为该分区分配的处理单元的数量。

限制:.01 增量

注意:该选项仅适用于共享处理器。

-max_proc_units units

定义该分区的处理单元的最大数量。

限制:.01 增量

注意:该选项仅适用于共享处理器。

-min_procs number

定义分区的虚处理器的最小数量。

注意:该选项仅适用于共享处理器。

-desired_procs number

定义为该分区分配的虚处理器的数量。

注意:该选项仅适用于共享处理器。

-max_procs number

定义该分区的虚拟处理器的最大数量。

注意:该选项仅适用于共享处理器。

-shared_mode {capped|uncapped}

指定受管系统是否允许逻辑分区使用共享处理器池中未指派给其他分区的空闲处理单元。

注意:该选项仅适用于共享处理器。

选项包括:

capped

指定分区只能使用指派给它的特定数量的处理单元。

uncapped

指定分区可以使用共享处理器池中空闲的处理器单元(当它们可用时)。

-uncap_weight weight

(可选)定义在选择不受限共享模式时处理优先级的加权平均值。

限制:0 - 255

-max_virtual_slots number

定义该分区的虚拟适配器的最大数量。

默认值:2

限制:2 - 65,536

-io_slot DRC-Index,{true|false}

(可选)指定物理组件的 I/O 插槽。 您可以为不同的 I/O 设备多次指定该值。

DRC-Index

指定插槽动态重新配置连接器 (DRC) 索引。

指定 DRC 索引对于 I/O 插槽是必需的。

指定 DRC 索引对于 I/O 插槽不是必需的。

-io_pool_id id {,id ...}

(可选)定义 I/O 适配器组,这些适配器可在没有来自 HMC 的任何活动干预的情况下被任何指定的逻辑分区组接管并使用。 分区组可以是逗号分隔列表形式的 I/O 池 ID。

-virtual_serial_adapter slot_num, remote_lpar_name, remote_slot_num, is_required

(可选)定义该逻辑分区的虚拟串行适配器。 变量 is_required 可以设置为 true 或 false。 仅支持客户端串行适配器,但可以多次指定。

默认值:在插槽 1 和 2 中创建两个服务器串行适配器。

注意:不支持在 IVM 上创建 LPAR。

-virtual_eth_adapter_client slot_num, is_IEEE, port_vlan_id1 (vlanid2,vlanid3,...), trunk_priority, is_required

(可选)定义该逻辑分区的虚拟以太网适配器,可以多次指定。 可选值有 vlan_idn 和 trunk_priority。 变量 is_IEEEis_required 可以设置为 true 或 false。 其他 vlan_ids 必须使用逗号分隔,并且包含在圆括号内。

注意:在 IVM 上创建 LPAR 时,slot_num 必须大于或等于 4。

示例:4,false,1,,,true

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

(可选)在 VIO 服务器上定义虚拟光纤通道 (FC) 客户端适配器、FC 服务器适配器,并将 FC 服务器适配器与物理 FC 端口关联。 将 -provision_aix 选项设置为 true 时,该选项无效。 该参数可以多次指定。 变量 is_required 可以设置为 true 或 false。

-virtual_scsi_client_adapter slot_num, remote_lpar_name, remote_slot_num, is_required

(可选)定义该逻辑分区的虚拟客户端 SCSI 适配器,可以多次指定。 变量 is_required 可以设置为 true 或 false。

-virtual_scsi_server_client_adapter virtual_io_server_name, backing_device_name, client_slot_num, is_required

(可选)定义虚拟 SCSI 服务器设备和虚拟 SCSI 客户端设备,在创建服务器设备并确定服务器插槽号之后自动链接客户端设备。 该参数可以多次指定。 变量 is_required 可以设置为 true 或 false。

示例:CUST-VIOSERVER,hdisk5,3,true

注意:如果使用 dpmlpar image 命令创建逻辑卷,并将 -create_logical_volume 选项设置为“是”,则 -virtual_scsi_server_client_adapter 选项不是必需的,应忽略。

-pre

(可选)指定是否在执行操作之前生成事件。

-post

(可选)指定是否在执行操作之后生成事件。

-ws_user username -ws_password password

(可选)指定要用于 Web 服务安全检查的凭据。 如果不包含凭据,系统会提示您输入凭据。 通过使用 caaipsecurity 设置自己的会话来避免提示输入凭据。

-locale iso639value

(可选)指定 IS0 639_3166 组合以覆盖默认的英语输出(例如:法语为 fr_FR)。 要使用命令提示符的区域设置,请指定“native”。

-encrypted_password {no|yes}

(可选)指定用户密码是否加密。

默认值:No

-prompt {yes|no}

(可选)指定是否提示您输入 Web 服务用户 ID 和密码。

默认值:Yes

-ws_remote_user username

(可选)指定 CA Server Automation 远程用户名。

-ws_remote_password password

(可选)指定 CA Server Automation 远程密码。

-locale iso639value

(可选)指定 IS0 639_3166 组合以覆盖默认的英语输出(例如:法语为 fr_FR)。 要使用命令提示符的区域设置,请指定“native”。

-create_logical_volume {no|yes}

(可选)指定是否创建逻辑卷。

默认值:no

注意:如果使用 dpmlpar image 命令创建逻辑卷,并将 -create_logical_volume 选项设置为“是”,则 -virtual_scsi_server_client_adapter 选项不是必需的,应忽略。

-logical_volume_size logical_volume_size

(可选)定义逻辑卷的大小 (MB)。

-volume_group_names volume_group_1, volume_group_2, volume_group_3

(可选)以逗号分隔的列表形式指定逻辑卷组名称。

-logical_volume_name logical_volume_name

(可选)定义逻辑卷的名称。

-use_logical_volume_name_as_prefix {no|yes}

(可选)指定是否将逻辑卷名称用作前缀。

默认值:no

-default_vio_server_name vioserver

(可选)指定用于创建逻辑卷的 VIO 服务器。

-itcm_server itcm_servername

(可选)指定 CA ITCM 服务器的名称。

用于使用 NIM mksysb 制作映像的参数

-install_type {rte|mksysb}

(可选)NIM 安装类型。 接受的值为 rte 或 mksysb。 如果未指定 -install_type,则 rte 为默认值。

-mksysb mksysbResource

mksysb 资源。 仅在 -install_type 为 mksysb 时有效。

-lpp lpp_resource

指定许可的程序产品文件,以用于映像请求。 如果 -install_type 为 mksysb,则为可选。 如果 -install_type 为 rte,则为必需。

-bosinst_data bos_install_data_resource

指定包含基础操作系统 (BOS) 安装程序的信息的文件。 如果 -install_type 为 mksysb,则为可选。 如果 -install_type 为 rte,则为必需。

-image_data imageDataResource

(可选)指定映像数据资源文件,该文件描述如何在根卷上配置物理磁盘、卷组、逻辑卷、文件系统和分页空间。

用于开通的参数

-auth_file authorizationfilename

(可选)指定用于检索加密密码的授权文件的完整路径名称。 该文件包含使用 dpmutil set auth 命令生成的 CA Server Automation 管理员凭据。 如果不指定该选项,将使用默认的授权文件。

-auth_comp componentID

(可选)指定可用于对主机和用户进行分组的组件 ID。

-auto_deploy {yes|no}

指定是否自动部署 CA Server Automation 代理。 选项包括:

自动部署 CA Server Automation 代理。

防止自动部署 CA Server Automation 代理。

默认值:no

-bosinst_data bos_install_data_resource

指定包含基础操作系统 (BOS) 安装程序的信息的文件。 如果 -install_type 为 mksysb,则为可选。 如果 -install_type 为 rte,则为必需。

-deploy_template templatename

(可选)指定在 CA Server Automation 中创建的通用模板的名称。

注意:请勿将该模板与由 VMware vCenter 创建并管理的模板相混淆。

-fb_script fbscript

(可选)定义在 BOS 安装过程完成之后,NIM 客户端初始启动时用于配置设备的文件的名称。

-lpp lpp_resource

指定许可的程序产品文件,以用于映像请求。 如果 -install_type 为 mksysb,则为可选。 如果 -install_type 为 rte,则为必需。

-machine_res_name machineresourcename

定义计算机资源的名称。 该名称必须在 NIM 主服务器中预定义。

-nim_master_host_name nimmasterhostname

定义用于执行映像部署的 NIM 主服务器主机名。

-post_inst_scripts script1,script2,script3

(可选)指定安装后运行的逗号分隔脚本列表。

-provision_aix {true|false}

表示创建分区之后,是否使用 NIM 对其进行映像。

使用 NIM 对创建的分区进行映像。 如果您将其设置为 true,则使用 NIM 资源组或 NIM 单个资源参数。 请参阅 dpmnim image 命令 | 使用资源组和 dpmnim image 命令部署 IBM AIX 映像 | 使用单个资源部署 IBM AIX 映像。 NIM 开通开始时,返回作业 ID。

不使用 NIM 对创建的分区进行映像。 不返回作业 ID。

-res_group_name resource group name

定义资源组的名称。

-resolve_conf resolveconf

(可选)定义一个文件,该文件包含为本地解析程序例程定义域名协议名称服务器信息的有效 /etc/resolv.conf 条目。

-scalability_server servername

(可选)指定要用于软件分发的 CA ITCM 可扩展性服务器。

-spot spotResource [mksysbResource]

定义共享产品对象树,以用于映像制作请求。

-target_password targetpassword

(可选)定义用于将代理部署到的目标主机服务器(要将映像部署到该服务器)的用户密码。 如果未指定密码,将从授权文件检索密码。

注意:可使用 dpmutil CLI 设置授权文件。

-target_username targetusername

定义用于将代理部署到的目标主机服务器(要将映像部署到该服务器)的用户名。

-type {res_group|individual_res}

指定使用映像操作类型资源组或单个资源。

res_group

指定使用资源组进行映像。

individual_res

指定使用单个资源进行映像。

-wait timeout

(可选)表示是否显示作业的状态并直到操作完成、失败或达到超时时长(如果您指定了超时值)才返回。 如果不指定该选项,CLI 不等待完成即返回。 如果无响应,可选的超时值将定义超时时长(分钟)。 如果输入不带超时值的等待选项,CLI 将使用 caimgconf.cfg 文件中的默认等待时间或默认等待 120 分钟。 除所有正整数之外,也可使用下列超时值:

""

无超时值。

0

无限等待。

示例:创建 IBM AIX 逻辑分区

本示例创建逻辑分区,但不开通。

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

示例:创建 IBM AIX 逻辑分区并使用单个资源对其进行映像

本示例创建逻辑分区并使用单个资源将其开通。

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

示例:创建 IBM AIX 逻辑分区并使用资源组对其进行映像

本示例创建逻辑分区并使用资源组将其开通。

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