chpath コマンド

目的

パスの操作可能状況をマルチパス I/O (MPIO) 対応デバイスに変更する、あるいは、 パスに関連した属性を MPIO 対応デバイスに変更します。

構文

chpath -dev Name -op OpStatus [ -pdev Parent ] [ -conn Connection ]

chpath -dev Name -pdev Parent [ -conn Connection ] [ -perm ] -attr Attribute=Value...

説明

chpath コマンドは、 パスの操作可能状況を指定したデバイス (-dev Name フラグ) に変更するか、特定パスに関連した 1 つ以上の属性を、指定したデバイスに変更します。必要な構文は、変更内容に応じて若干異なります。

上に示した最初の構文は、1 つ以上のパスの操作可能状況を、特定デバイスに変更します。変更するパスのセットは、以下の基準に一致するパスのセットをとることによって取得できます。

• ターゲット・デバイスが、指定したデバイスに一致する。
• 親デバイスが指定した親 (-pdev Parent) に一致する (親が指定された場合)。
• 接続が指定した接続 (-conn Connection) に一致する (接続が指定された場合)。
• パスの状況が PATH_AVAILABLE である。

パスの操作可能状況とは、パスが MPIO パス選択の一部として使用されることを意味します。 enable という値は、 パスが使用されることを示し、「disable」はパスが使用されないことを示します。パスを「disable」にセットすることは、すでに進行中の I/O に影響するのではなく、将来の I/O に影響するということに注意してください。 したがって、パスを使用不可にしても、すでに進行中の I/O のすべてが完了するまで、 まだ未解決の I/O が存続することがありえます。したがって、 あるパスに -op disable が指定され、そのパスに未解決の I/O がある場合、この事実が表示されます。

パスを使用不可化にすると、デバイス・ドライバー・レベルのパスの選択に影響を与えます。パスの path_status は、デバイス構成データベース内で変更されません。 パスの現在の操作可能状況を表示するには、lspath コマンドを使用する必要があります。

上に示した 2 番目の構文は、 特定のパスに関連した 1 つ以上のパス特定の属性を特定のデバイスに変更します。 chpath コマンドの一回の呼び出しで複数の属性を変更できることに注意してください。 ただし、すべての属性は、1 つのパスに関連付けられていなければなりません。 言い換えると、 複数のパスにまたがる属性を、chpath コマンドの一回の呼び出しで変更することはできません。 複数のパスにまたがる属性を変更するには、chpath の呼び出しを、 変更するそれぞれのパスごとに分離することが必要です。

フラグ

終了状況

バーチャル I/O サーバーのコマンドの終了状況を参照してください。

例

1. scsi0 と hdisk1 ディスク・デバイスとの間のパスを使用不可にするには、次のように入力します。

   chpath -dev hdisk1 -pdev scsi0 -op disable

   システムは、以下のようなメッセージを表示します。

   paths disabled

   または

   some paths disabled

   最初のメッセージは、scsi0 から hdisk1 へのすべての PATH_AVAILABLE パスが正常に使用可能になったことを示します。 2 番目のメッセージは、scsi0 から hdisk1 への一部の PATH_AVAILABLE パスだけが正常に使用不可になったことを示します。

関連情報

cfgdev コマンド、 chdev コマンド、 lsdev コマンド、 lsmap コマンド、 lspath コマンド、 mkpath コマンド、 mkvdev コマンド、 rmdev コマンド、および rmpath コマンド。