mkhost コマンドは、論理ホスト・オブジェクトを作成します。
構文
>>- svctask -- -- mkhost -- --+---------------------+-- --------> '- -name -- new_name -' >--+- -hbawwpn -- wwpn_list ------+-----------------------------> '- -iscsiname--iscsi_name_list-' >-- --+-----------------------+-- ------------------------------> '- -iogrp -iogrp_list -' >-- --+-------------------------+-- --+----------+--------------> '- -mask -port_login_mask-' '- -force -' >--+------------------------+---------------------------------->< '- -type --+- hpux ----+-' +- tpgs ----+ '- generic -'
パラメーター
- -name new_name
- (オプション) 新規のホスト・オブジェクトの名前またはラベルを指定します。
- -hbawwpn wwpn_list
- (iscsiname を使用しない場合は必須) 指定されたホスト・オブジェクトに追加するホスト・バス・アダプター (HBA) のワールド・ワイド・ポート名 (WWPN) を指定します。 このパラメーターは、iscsiname パラメーターと一緒に使用することはできません。
- -iscsiname iscsi_name_list
- (hbawwpn を使用しない場合は必須) このホストの 1 つ以上の iSCSI 名を指定します。 最大 16 個の名前を指定することができ、それぞれの名前は最大 255 文字まで含むことができます。 それぞれの名前は iSCSI 規格 (RFC 3720) に準拠している必要があります。 少なくとも 1 つの WWPN または iSCSI 名が指定されている必要があります。 このパラメーターは、hbawwpn パラメーターと一緒に使用することはできません。
- -iogrp iogrp_list
- (オプション) ホストが VDisk にアクセスする、1 つ以上の入出力グループのセットを指定できます。入出力グループは、グループ名または ID をコロンで区切って指定します。リスト内で名前と ID は混合できます。このパラメーターが指定されていない場合、ホストはすべての入出力グループに関連付けられます。
- -mask port_login_mask
- (オプション) ホストがアクセスできるノード・ターゲット・ポートを指定します。ポート・マスクは 4 つのバイナリー・ビットで、0 と 1 の組み合わせで構成されます。0 は対応するターゲット・ポートが使用できないことを示し、1 は使用できることを示しています。マスクの右端のビットは、ノードの最低番号のターゲット・ポート (4 ではなく 1) に対応します。 マスクの有効値は、0000 (ポートすべて使用不可) から 1111 (ポートすべて使用可能) の範囲です。例えば、0011 のマスクはポート 1 とポート 2 を使用可能にします。デフォルト値は 1111 (すべてのポートが使用可能) です。
- -force
- (オプション) WWPN の妥当性検査を行わずに論理ホスト・オブジェクトを作成することを指定します。
- -type hpux | tpgs | generic
- (オプション) ホストのタイプを指定します。hpux、tpgs、または generic。デフォルトは generic です。tpgs パラメーターを使用すると、追加のターゲット・ポートのユニット・アテンションが使用可能になります。type パラメーターを必要とするホストの詳細については、SAN ボリューム・コントローラー・ホスト接続資料を参照してください。
説明
mkhost コマンドは、1 つ以上の HBA WWPN あるいは iSCSI 名を論理ホスト・オブジェクトに関連付けます。 このコマンドは新規のホストを作成します。コマンドが完了すると、ID が表示されます。 後で mkvdiskhostmap コマンドを使用して仮想ディスクをホストにマッピングするときに、このオブジェクトを使用できます。
mkhost コマンドは、1 回だけ発行してください。クラスターはホスト・ゾーン内の WWPN のファブリックをスキャンします。 どの WWPN がどのホストに存在するかを判別するのに、クラスター自体をフィルターに掛けてホストにマッピングすることはできないので、 svctask mkhost コマンドを使用して、ホストを特定する必要があります。
ホストを特定した後、ホストと仮想ディスクの間でマッピングが作成されます。 これらのマッピングは、仮想ディスクを、それらがマップされるホストに効果的に提示します。 ホスト・オブジェクト内のすべての WWPN が仮想ディスクにマップされます。
HBA デバイス・ドライバーの中には、ターゲット論理装置番号 (LUN) が判明するまでファブリックにログインしないものもあります。ログインしないため、それらの WWPN は候補ポートとして認識されません。 このコマンドで force パラメーターを指定すると、WWPN リストの妥当性検査を停止することができます。
ホストの追加先の入出力グループが、クラスター内の限度によって許容される以上のホスト・ポートまたはホスト・オブジェクトに関連付けられている場合、このコマンドは失敗します。
追加情報については、svctask mkvdiskhostmap および svcinfo lshbaportcandidate コマンドの説明を参照してください。
呼び出し例
svctask mkhost -name hostone -hbawwpn 210100E08B251DD4 -force -mask 1001
結果出力
Host id [1] successfully created
呼び出し例
svctask mkhost -iscsiname iqn.localhost.hostid.7f000001 -name newhost
結果出力
Host, id [10], successfully created