rmhostport

rmhostport コマンドは、既存のホスト・オブジェクトからワールド・ワイド・ポート名 (WWPN) や Internet Small Computer System Interface (iSCSI) 名を削除するために使用します。

構文

構文図を読む構文図をスキップする
>>- rmhostport -- --+- -saswwpn -- wwpn_list ------+------------>
                    +- -fcwwpn -- wwpn_list -------+   
                    '- -iscsiname--iscsi_name_list-'   

>--+----------+-- --+- host_name -+----------------------------><
   '- -force -'     '- host_id ---'   

パラメーター

-saswwpn wwpn_list
(iscsinamefcwwpn を使用しない場合は必須) 16 文字の 16 進数ストリングを使用した Serial Attached SCSI (SAS) WWPN のコロン区切りリストを指定します。
-fcwwpn wwpn_list
(iscsinamesaswwpn を使用しない場合は必須) 16 文字の 16 進数ストリングを使用したファイバー・チャネル (FC) WWPN のコロン区切りリストを指定します。
-iscsiname iscsi_name_list
(fcwwpn または saswwpn を使用しない場合は必須) ホストから削除する iSCSI 名のコンマ区切りリストを指定します。 少なくとも 1 つの WWPN または iSCSI 名が指定されている必要があります。 このパラメーターは、fcwwpn または saswwpn パラメーターと一緒に使用することはできません。
-force
(オプション) リスト内のすべての WWPN あるいは iSCSI 名がホストにマップされているかの検査が指定変更されます。ホストに関連付けられていないポートは無視されます。
重要: force パラメーターを使用すると、アクセスが失われる可能性があります。 このパラメーターは、製品サポート情報による指示がある場合にのみ使用してください。
host_name | host_id
(必須) ホスト名またはホスト ID を指定します。

説明

このコマンドは、ホスト・バス・アダプター (HBA) WWPN または iSCSI 名のリストを指定されたホスト・オブジェクトから削除します。 WWPN ポートがまだファブリックにログインしている場合、これらのポートは未構成となり、候補 WWPN としてリストされます。

このホスト・オブジェクトにマップされたすべてのボリュームが、ポートから自動的にマップ解除されます。

要確認: 以下の場合、このコマンドは失敗します。
  • ボリューム保護が (chsystem コマンドを使用して) 有効にされている。
  • 削除される最後のホスト・ポートが、定義されたボリューム保護期間内に入出力を受け取ったいずれかのボリュームにマップされている。
複数のホストが同じボリュームへマップされている場合、ホスト・ポートの除去は、ホストがオフラインである場合に許可されます。これにより、同じシステムに含まれている可能性があるホストからポートを除去できます。
lsfcportcandidate または lssasportcandidate コマンドを発行して、候補ファイバー・チャネル (FC) またはシリアル接続 SCSI (SAS) ポートをリストします。 ホスト・オブジェクトに 追加可能なポートのリストが表示されます。現在ホストに割り当てられている WWPN をリストするには、次のコマンドを発行します。

lshost hostobjectname

ここで、hostobjectname は、ホスト・オブジェクトの名前です。
次のコマンドを発行して、既存のホスト・オブジェクトに新規ポートを追加します。

addhostport -fcwwpn one or more existing WWPNs
separated by : hostobjectname/ID

ここで、one or more existing WWPNs separated by : および hostobjectname/id は、ホスト・オブジェクトの名前または ID です。
次のコマンドを発行して、ホスト・オブジェクトから古いポートを削除します。

rmhostport -fcwwpn one or more existing WWPNs
separated by : hostobjectname/ID

ここで、one or more existing WWPNs separated by : は、前のステップでリストされた WWPNに対応します。ホスト・オブジェクトとボリュームとの間に存在するマッピングは、新しい WWPN に自動的に適用されます。

呼び出し例

rmhostport -saswwpn 210100E08B251DD4 host1

結果出力

No feedback

呼び出し例

rmhostport -fcwwpn 210100E08B251EE6 host1

結果出力

No feedback

呼び出し例

rmhostport -iscsiname iqn.localhost.hostid.7f000001 mchost13

結果出力

No feedback