rmpath コマンド
目的
MPIO 可能なデバイスへのパスをシステムから除去します。
構文
rmpath { [ -dev Name ] [ -pdev Parent ] [ -conn Connection ] } [ -rm ]
説明
rmpath コマンドは、指定されたターゲット・デバイス (-dev Name) に関連する 1 つ以上のパスの
構成解除、および場合によっては定義の解除を行います。除去されるパスの設定は、-devName、-pdev Parent および -conn Connection フラグの組み合わせによって決まります。このコマンドによって、デバイスに関連するすべてのパスの構成解除または定義解除が行われる場合、コマンドはエラーで終了し、パスの構成解除も定義解除も行われません。
この状況では、ターゲット・デバイス自体を構成解除または定義解除する代わりに rmdev コマンドを使用する必要があります。
デフォルトのアクションでは、指定された各パスは構成解除されますが、システムからは完全に除去されません。
-rm フラグが指定されると、rmpath コマンドは、システムからのパス定義の構成解除 (必要があれば) と除去、または削除を行います。
rmpath コマンドは、終了すると状況メッセージを表示します。パスを構成解除するときは、場合によっては、このコマンドが構成解除できるパスもがあれば、できないパスもあります (例えば、I/O の途中のパスは構成解除できません)。
rmpath コマンドは、操作の結果に関する状況メッセージを出します。次のいずれかのフォーマットのメッセージが生成されます。
- path [ defined | deleted ]
- このメッセージは、単一のパスが正常に構成解除または定義解除されたときに表示されます。パスが正常に構成されると、使用可能なメッセージ・パスが表示されます。パスが正常に構成されずに、メソッドによって明示的なエラー・コードが戻されない場合は、定義されたメッセージ・パスが表示されます。
- paths [defined | deleted]
- このメッセージは、複数のパスが識別され、すべてのパスが正常に構成解除または定義解除された場合に表示されます。
-rm フラグが指定されない場合、メッセージは定義済みパスになります。
-rm フラグが指定さる場合、メッセージは「paths deleted」になります。
- some paths [ defined | deleted ]
- このメッセージは、複数のパスが識別されたが、正常に構成解除または定義解除されたのはその一部のみである場合に表示されます。
-rm フラグが指定されない場合、メッセージは一部の定義済みパスになります。
-rm フラグが指定される場合、メッセージは一部の削除済みパスになります。
- no paths processed
- このメッセージは、選択基準に一致するパスがなかった場合に生成されます。
フラグ
| -rm |
指定されたパスがシステムから削除されることを示します。 |
| -dev Name |
パスが除去されるターゲット・デバイスの論理デバイス名を指定します。除去されるパスは、-pdev および -conn フラグによって修飾されます。 |
| -pdev Parent |
除去されるパスを修飾する際に使用する親デバイスの論理デバイス名を示します。このコマンドでは、デバイスへのすべてのパスを除去できないため、このフラグか、-conn フラグか、あるいはその両方を指定する必要があります。 |
| -conn Connection |
除去されるパスを修飾する際に使用する接続情報を示します。このコマンドでは、デバイスへのすべてのパスを除去できないため、このフラグか、-pdev フラグか、あるいはその両方を指定する必要があります。 |
終了状況
バーチャル I/O サーバーのコマンドの終了状況を参照してください。
例
- 1. 接続 5、0 の scsi0 から hdisk1 へのパスを構成解除するには、次のように入力します。
rmpath -dev hdisk1 -pdev scsi0 -conn "5,0"
生成されるメッセージは、以下のようになります。
path defined
- scsi0 から hdisk1 のすべてのパスを構成解除するには、次のように入力します。
rmpath -dev hdisk1 -pdev scsi0
すべてのパスが正常に構成解除された場合に生成されるメッセージは、以下のようになります。
paths defined
ただし、正常に構成解除されたパスが一部のみの場合のメッセージは、以下のようになります。
some paths defined
- 接続 5、0 の scsi0 および hdisk1 間のパス定義を解除するには、次のように入力します。
rmpath -rm -dev hdisk1 -pdev scsi0 -conn "5,0"
生成されるメッセージは、以下のようになります。
path deleted
- scsi0 から hdisk1 のすべてのパスを構成解除するには、次のように入力します。
rmpath -rm -dev hdisk1 -pdev scsi0
生成されるメッセージは、以下のようになります。
paths deleted
関連情報
chpath コマンド、lspath コマンド、および rmpath コマンド。