addhostport
addhostport コマンドは、既存のホスト・オブジェクトからワールド・ワイド・ポート名 (WWPN) や Internet Small Computer System Interface (iSCSI) 名を追加するために使用します。
構文
>>- addhostport -- --+- -saswwpn -- wwpn_list ------+-- --------> +- -fcwwpn -- wwpn_list -------+ '- -iscsiname--iscsi_name_list-' >--+----------+-- --+- host_name -+---------------------------->< '- -force -' '- host_id ---'
パラメーター
- -saswwpn wwpn_list
- (-iscsiname または -fcwwpn を使用しない場合は必須) 16 文字の 16 進数ストリングで Serial Attached SCSI (SAS) WWPN のリストを指定します。
- -fcwwpn wwpn_list
- (-iscsiname または -saswwpn を使用しない場合は必須) 16 文字の 16 進数ストリングでファイバー・チャネル (FC) WWPN のリストを指定します。
- -iscsiname iscsi_name_list
- (-fcwwpn または saswwpn を使用しない場合は必須) ホストに追加する iSCSI 名のコンマ区切りリストを指定します。少なくとも 1 つの WWPN または iSCSI 名が指定されている必要があります。 このパラメーターは、-fcwwpn または -saswwpn パラメーターと一緒に使用することはできません。
- -force
- (オプション) WWPN または iSCSI 名の妥当性検査を行わずに、ポートのリストをホストに追加することを指定します。
- host_id | host_name
- (必須) ポートの追加先のホスト・オブジェクトを ID または名前のいずれかで指定します。
説明
このコマンドは、ホスト・バス・アダプター (HBA) WWPN または iSCSI 名のリストを、指定したホスト・オブジェクトに追加します。このホスト・オブジェクトにマップされたボリュームは、すべて自動的に新規ポートにマップされます。
ログイン済みで未構成の WWPN のみを追加することができます。 候補 WWPN のリストについては、lssasportcandidate または lsfcportcandidate コマンドを使用します。
一部の HBA デバイス・ドライバーは、ターゲットの論理装置番号 (LUN) を認識できるまではファブリックにログインしません。 ログインしないため、それらの WWPN は候補ポートとして認識されません。 force パラメーターを addhostport コマンドと一緒に指定して、WWPN リストの妥当性検査を停止することができます。
注: すべての入出力グループが iSCSI ホストから削除されている場合は、iSCSI ホストを少なくとも 1 つの入出力グループにマップするまでは、iSCSI ホストにポートを追加することはできません。 iSCSI ホストを少なくとも 1 つの入出力グループにマップした後、addhostport コマンドを再実行依頼します。 ポートをホストに追加した後、chhost コマンドを使用してホスト認証エントリーを作成する必要があります。
以下の場合、addhostport コマンドは失敗します。
- ホストがアクセス・セット内に複数の入出力グループを持つボリュームにマップされている。また、追加するホスト・ポートが Internet Small Computer System Interface (iSCSI) 名である。
- 追加されるポートが、複数の入出力グループからマップされているボリュームをサポートしないホスト・システムからのものである。
呼び出し例
addhostport -saswwpn 210100E08B251DD4 host1
結果出力
No feedback
呼び出し例
addhostport -fcwwpn 210100E08B251EE6 host1
結果出力
No feedback
呼び出し例
addhostport -iscsiname iqn.localhost.hostid.7f000001 mchost13
結果出力
No feedback