前のトピック: dpmlpar getresources コマンド -- LPAR リソースの取得次のトピック: dpmlpar imgjobcheck コマンド -- IBM AIX イメージング ジョブ ステータスの取得


dpmlpar image コマンド -- IBM AIX LPAR を作成する

dpmlpar image コマンドは、HMC/IVM とターゲット IBM AIX LPAR 管理対象システムを使用して IBM AIX LPAR を作成します。 (オプション)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)または Integrated Virtualization Manager (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

(オプション)共有モードとして uncapped を選択した場合に、処理優先度の加重平均を定義します。

値の範囲: 0 ~ 255

-max_virtual_slots number

このパーティションの最大仮想アダプタ数を定義します。

デフォルト: 2

値の範囲: 2 ~ 65,536

-io_slot DRC-Index,{true|false}

(オプション)物理コンポーネントの I/O スロットを指定します。 異なる I/O デバイスにこの値を複数回指定できます。

DRC-Index

スロットの動的再構成コネクタ(DRC)インデックスを指定します。

true

I/O スロットに DRC インデックスが必須であることを指定します。

false

I/O スロットに DRC インデックスは必須でないことを指定します。

-io_pool_id id {,id ...}

(オプション)HMC のアクティブな介入なしで、指定された論理パーティション グループが引き継いで使用できる I/O アダプタ グループを定義します。 パーティション グループは、I/O プール ID をカンマで区切って指定します。

-virtual_serial_adapter slot_num, remote_lpar_name, remote_slot_num, is_required

(オプション)この論理パーティションの仮想シリアル アダプタを定義します。 変数 is_required は、true または false に設定します。 サポートされているのはクライアント シリアル アダプタのみですが、複数回指定できます。

デフォルト: スロット 1 と 2 で作成された 2 つのサーバ シリアル アダプタ

注: IVM 上で LPAR を作成する場合にはサポートされていません。

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

(オプション)この論理パーティションの仮想イーサネット アダプタを定義します。複数回指定できます。 オプションの値は vlan_idtrunk_priority です。 変数 is_IEEEis_required は、true または false に設定します。 追加の vlan_id は、カンマ区切りかっこで囲む必要があります。

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

(オプション)仮想ファイバ チャネル(FC)クライアント アダプタ(VIO サーバ上の 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 オプションを「yes」に設定した場合、-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}

(オプション)ユーザ パスワードが暗号化されているかどうかを指定します。

デフォルト: 「いいえ」

-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 オプションを「yes」に設定した場合、-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 認証情報設定コマンドを使用して生成した CA Server Automation 管理者の認証情報が含まれます。 このオプションを指定しないと、デフォルトの認証ファイルが使用されます。

-auth_comp componentID

(オプション)グループ ホストとユーザに対して使用できるコンポーネント ID を指定します。

-auto_deploy {yes|no}

CA Server Automation エージェントを自動的に展開するかどうかを指定します。 オプションは、以下のとおりです。

yes

CA Server Automation エージェントを自動的に展開します。

no

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 を使用してイメージを作成するかどうかを指定します。

true

作成したパーティションのイメージに NIM を使用します。 true に設定すると、NIM リソース グループまたは NIM の個別リソース パラメータが使用されます。 詳しくは、「dpmnim image コマンド - リソース グループを使用した IBM AIX イメージの展開」、「dpmnim image コマンド - 個別リソースを使用した IBM AIX イメージの展開」を参照してください。 ジョブ ID は、NIM プロビジョニングが開始されると返されます。

false

作成したパーティションのイメージに 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

(オプション)ジョブ ステータスを表示し、操作が完了、失敗、またはタイムアウト(timeout の値を指定している場合)するまで待機するかどうかを指定します。 このオプションを指定しない場合、CLI は完了を待たずに戻ります。 応答がない場合、オプションの timeout の値(分)がタイムアウトするまでの時間となります。 timeout の値を指定せずに wait オプションを入力すると、CLI は caimgconf.cfg ファイルのデフォルト待機時間の 120 分を使用します。 任意の正の整数のほかに、timeout には以下の値も使用できます。

""

タイムアウト値はありません。

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