mpathadm - マルチパスの発見および管理
mpathadm subcommand direct-object [options] [operand ]
mpathadm コマンドは、マルチパスの発見および管理を可能にします。mpathadm はサブコマンドのセットとして実装されており、それらの多くには独自のオプションがあり、そのサブコマンドに関するセクションで説明されています。特定のサブコマンドに関連付けられていないオプションは、「オプション」で説明されています。mpathadm サブコマンドは、直接オブジェクト (direct-object) に対して動作します。これらについては、このセクションでサブコマンドごとに説明します。サブコマンド内の direct-objects、initiator-port、target-port、および logical-unit は、SCSI 規格の定義と整合しています。
mpathadm コマンドは次のサブコマンドをサポートしており、それらについては、以降のサブセクションで詳細に説明します。
特定のオブジェクトについて発見されたインスタンスのリストを表示します。
特定のオブジェクトインスタンスに関する情報を表示します。
オブジェクトのプロパティーを変更します。
オブジェクトを有効にします。
オブジェクトを無効にします。
論理ユニットのターゲットポートグループをフェイルオーバーさせます。
論理ユニットのほかのパスに置き換えて使用するパスを設定します。
mpathadm サブコマンドは、直接オブジェクト (direct-object) に対して動作します。これらについては、このセクションでサブコマンドごとに説明します。
list サブコマンドの構文は次のとおりです。
# mpathadm list direct-object [ operands...]
list サブコマンドは、次の直接オブジェクトのデータを表示します。
この CLI で管理できるマルチパスサポートを一覧表示します。これは、MPAPI フレームによって登録されたライブラリ名の形式で表示されます。マルチパスサポートの名前 mpath-support-name が指定されていない場合は、登録されているすべてのマルチパスサポートライブラリが表示されます。
このシステムで発見されたイニシエータポートを一覧表示します。initiator-port-name が指定されていない場合は、発見されたすべてのイニシエータポートが表示されます。
マルチパス論理ユニットに関する情報を一覧表示します。logical-unit-name が指定されていない場合は、検出されたすべての論理ユニットが表示されます。
list logical-unit のオプションは次のとおりです。
指定された name 文字列に関連付けられている論理ユニット名を返します。この名前は、mpathadm show lu コマンドの出力から抽出できます。
指定された target-port-name に関連付けられている論理ユニット名のリストを返します。
show サブコマンドの構文は次のとおりです。
# mpathadm show direct-object [options] [ operands...]
show サブコマンドは、次の直接オブジェクトの詳細情報を表示します。
指定された名前 mpath-support-name が存在する場合は、その詳細情報を表示します。指定された mpath-support-name が限られたデバイス製品だけをサポートしている場合は、出力の一部としてデバイス製品のリストが表示されます。
指定された initiator-port-name に関する詳細情報を表示します。initiator-port-name が指定されていない場合は、検出されたすべてのイニシエータポートの詳細が表示されます。
パスおよびターゲットポートグループの情報など、マルチパス論理ユニットに関する詳細情報を表示します。logical-unit-name が指定されていない場合は、検出されたすべての論理ユニットの詳細が表示されます。論理ユニット情報内の name プロパティーは、ハードウェアから取得されこのシステムで使用される、この LUN の識別子を表します。この名前が SCSI 照会 VPD (Vital Product Data) ページ 83h から取得される場合、名前タイププロパティーは、SCSI 規格で定義されている関連付けられた識別子タイプを表します。
show logical-unit のオプションは次のとおりです。
検出された論理ユニットの全体的な情報のうち、パスが見つからないもののみを表示します。
modify サブコマンドの構文は次のとおりです。
# mpathadm modify direct-object [ options] [operands...]
modify サブコマンドは、次の直接オブジェクトの特性を変更します。
マルチパスサポートの構成の管理。modify mpath-support のオプションは次のとおりです。
自動フェイルバックを設定します。マルチパスサポートが自動フェイルバックのサポートを提供している場合に限り適用できます。
自動プローブを設定します。マルチパスサポートが自動プローブのサポートを提供している場合に限り適用できます。
デフォルトの負荷分散タイプを変更します。loadbalance タイプは、show mpath-support の出力に一覧表示されるサポートされているタイプのいずれかです。
論理ユニットの構成の管理。logical-unit を変更するためのオプションは次のとおりです。
自動フェイルバックを設定します。マルチパスサポートが自動フェイルバックのサポートを提供している場合に限り適用できます。
自動プローブを設定します。マルチパスサポートが自動プローブのサポートを提供している場合に限り適用できます。
論理ユニットの負荷分散タイプを設定します。論理ユニットレベルで負荷分散構成がサポートされている場合に限り適用できます。
enable サブコマンドの構文は次のとおりです。
# mpathadm enable [options]
enable サブコマンドは、次の直接オブジェクトの有効化をサポートします。
指定されたイニシエータポート、ターゲットポート、および論理ユニットから成るパスが有効にされます。
disable サブコマンドの構文は次のとおりです。
# mpathadm disable [options]
disable サブコマンドは、次の直接オブジェクトの無効化をサポートします。
指定されたイニシエータポート、ターゲットポート、および論理ユニットから成るパスが無効にされます。
failover サブコマンドの構文は次のとおりです。
# mpathadm failover direct-object [ operand]
failover サブコマンドは、次の直接オブジェクトのフェイルオーバーをサポートします。
指定された論理ユニットが非対称で、明示的な状態変更をサポートしている場合に、ターゲットポートグループがフェイルオーバーします。現在アクティブなターゲットポートグループは待機状態に変更され、待機ターゲットポートグループがアクティブになります。使用できないターゲットポートグループの状態は変更できません。
override サブコマンドの構文は次のとおりです。
# mpathadm override [options]
override サブコマンドは、次の直接オブジェクトが別のオブジェクトをオーバーライドするかどうかを制御します。
指定されたイニシエータポート、ターゲットポート、および論理ユニットから成るパスで、論理ユニット上のほかのパスをオーバーライドします。あるパスによってほかのパスがオーバーライドされたあとは、ほかのパス選択構成にかかわらず、マルチパスサポートはそのパスだけを使用します。–c オプションは設定を取り消します。指定されたイニシエータポート、ターゲットポート、および論理ユニットから成るパスが無効にされます。
override path のオプションは次のとおりです。
パスのイニシエータポート要素を表します。オプション –t および –l も含める必要があります。
パスのターゲットポート要素を表します。オプション –i および –l も含める必要があります。
パスの論理ユニット要素を表します。オプション –i および –t も含める必要があります。
特定の論理ユニットのオーバーライド設定を取り消します。オプション –l も含める必要があります。
サポートしているオプションは、次のとおりです。
バージョン情報を表示します。
コンテキストヘルプを表示します。引数のない mpathadm コマンドのあと、サブコマンドのあと、またはサブコマンドと直接オブジェクトの組み合わせのあとに使用できます。入力に適したヘルプ情報が表示されます。たとえば、次の行を入力したとします。
# mpathadm add mpath-support-help
... mpathadm によって、そのサブコマンドと直接オブジェクトの組み合わせに使用可能なオプションの表示が返されます。
次のコマンドは、list サブコマンドを使用して、現在登録されているすべての mpath-support ライブラリを一覧表示します。
# mpathadm list mpath-support mpath-support: libmpscsi_vhci.so使用例 2 特定のマルチパスサポートのプロパティーを表示する
次のコマンドは、show サブコマンドを使用して、現在登録されている mpath-support ライブラリのプロパティーを表示します。
# mpathadm show mpath-support libmpscsi_vhci.so mpath-support: libmpscsi_vhci.so Vendor: Sun Microsystems Driver Name: scsi_vhci Default Load Balance: round-robin Supported Load Balance Types: round-robin logical-block Allows To Activate Target Port Group Access: yes Allows Path Override: no Supported Auto Failback Config: 1 Auto Failback: on Failback Polling Rate (current/max): 0/0 Supported Auto Probing Config: 0 Auto Probing: NA Probing Polling Rate (current/max): NA/NA Supported Devices: Vendor: SUN Product: T300 Revision: Supported Load Balance Types: round-robin Vendor: SUN Product: T4 Revision: Supported Load Balance Types: round-robin使用例 3 mpath-support ライブラリによって検出されたイニシエータポートのリストを取得する
次のコマンドは、list initiator-port サブコマンドを使用して、現在登録されている mpath-support ライブラリによって検出されたイニシエータポートのリストを表示します。
# mpathadm list initiator-port Initiator-Port: iqn.1986-03.com.sun:01:080020b7ac2b.437a3b3e,4000002a0000 Initiator-Port: 2000000173018713 Initiator-Port: 2000000173818713使用例 4 特定のイニシエータポートのプロパティーを表示する
次のコマンドは、show initiator-port サブコマンドを使用して、上記の例の list initiator-port サブコマンドで発見された特定のイニシエータポートのプロパティーを表示します。
# mpathadm show initiator-port 2000000173018713 initiator-port: 2000000173018713 Transport Type: Fibre Channel OS device File: devices/pci@1f,4000/pci@2/SUNW,qlca@5/fp@0,0:fc使用例 5 特定の論理ユニットのプロパティーを表示する
次のコマンドは、show logical-unit サブコマンドを使用して、指定された名前を持つ論理ユニットのプロパティーを表示します。
# mpathadm show lu /dev/rdsk/c4t60003BA27D2120004204AC2B000DAB00d0s2 Logical Unit: /dev/rdsk/c4t60003BA27D2120004204AC2B000DAB00d0s2 mpath-support libmpscsi_vhci.so Vendor: SUN Product: T4 Revision: 0301 Name Type: SCSI Inquiry VPD Page 83 type 3 Name: 60003ba27d2120004204ac2b000dab00 Asymmetric: yes Current Load Balance: round-robin Logical Unit Group ID: NA Aauto Failback: on Auto Probing: NA Paths: Initiator Port Name: 2000000173818713 Target Port Name: 20030003ba27d212 Override Path: NA Path State: OK Disabled: no Initiator Port Name: 2000000173018713 Target Port Name: 20030003ba27d095 Override Path: NA Path State: OK Disabled: no Target Port Group: ID: 2 Explicit Failover: yes Access State: standby Target Ports: Name: 20030003ba27d212 Relative ID: 0 ID: 5 Explicit Failover: yes Access State: active Target Ports Name: 20030003ba27d095 Relative ID: 0使用例 6 パスを有効にする
次のコマンドは、enable path サブコマンドを使用して、指定されたイニシエータポート、ターゲットポート、および論理ユニットを持つパスを有効にします。
# mpathadm enable path -i 2000000173018713 -t 20030003ba27d095 \ -l /dev/rdsk/c4t60003BA27D2120004204AC2B000DAB00d0s2使用例 7 マルチパスサポートを変更して自動フェイルバックを有効にする
# mpathadm modify mpath-support -a on libmpscsi_vhci.so使用例 8 ホストのイニシエータポートに関する全体的な情報を表示する
次のコマンドは、ホストのイニシエータポートに関する全体的な情報を表示します。
# mpathadm show initiator-port Initiator Port: 210100e08ba41feb Transport Type: Fibre Channel OS Device File: /devices/pci@1,0/pci1022,7450@1/pci1077,141@2,1/fp@0,0 Initiator Port: iqn.1986-03.com.sun:01:ffffffffffff.519c6677,4000002a00ff Transport Type: iSCSI OS Device File: /devices/iscsi使用例 9 パスが見つからない論理ユニットに関する全体的な情報のみを表示する
次のコマンドは、パスが見つからない論理ユニットに関する全体的な情報のみを表示します。
# mpathadm show lu -e Logical Unit: /dev/rdsk/c0t600A0B800026D63A000091344DBF39C4d0s2 mpath-support: libmpscsi_vhci.so Vendor: SUN Product: CSM200_R Revision: 0660 Name Type: unknown type Name: 600a0b800026d63a000091344dbf39c4 Asymmetric: yes Current Load Balance: round-robin Logical Unit Group ID: NA Auto Failback: on Auto Probing: NA Paths: Initiator Port Name: 210100e08ba41feb Target Port Name: 200900a0b826d63b Override Path: NA Path State: OK Disabled: no Initiator Port Name: 210100e08ba41feb Target Port Name: 200800a0b826d63c Override Path: NA Path State: unavailable Disabled: no Target Port Groups: ID: 1 Explicit Failover: yes Access State: active Target Ports: Name: 200900a0b826d63b Relative ID: 0 ID: 3 Explicit Failover: yes Access State: unavailable Target Ports: Name: 200800a0b826d63c Relative ID: 0
属性についての詳細は、マニュアルページの attributes(5) を参照してください。
|