| ナビゲーションリンクをスキップ | |
| 印刷ビューの終了 | |
|
マニュアルページセクション 1M: システム管理コマンド Oracle Solaris 11.1 Information Library (日本語) |
| ナビゲーションリンクをスキップ | |
| 印刷ビューの終了 | |
|
|
マニュアルページセクション 1M: システム管理コマンド Oracle Solaris 11.1 Information Library (日本語) |
- マルチパスの発見および管理
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 [operands...]
show サブコマンドは、次の直接オブジェクトの詳細情報を表示します。
指定された名前 mpath-support-name が存在する場合は、その詳細情報を表示します。指定された mpath-support-name が限られたデバイス製品だけをサポートしている場合は、出力の一部としてデバイス製品のリストが表示されます。
指定された initiator-port-name に関する詳細情報を表示します。
パスおよびターゲットポートグループの情報など、マルチパス論理ユニットに関する詳細情報を表示します。論理ユニット情報内の name プロパティーは、ハードウェアから取得されこのシステムで使用される、この LUN の識別子を表します。この名前が SCSI 照会 VPD (Vital Product Data) ページ 83h から取得される場合、名前タイププロパティーは、SCSI 規格で定義されている関連付けられた識別子タイプを表します。
modify サブコマンドの構文は次のとおりです。
# mpathadm modify direct-object [options] [operands...]
modify サブコマンドは、次の直接オブジェクトの特性を変更します。
マルチパスサポートの構成の管理。modify mpath-support のオプションは次のとおりです。
自動フェイルバックを設定します。マルチパスサポートが自動フェイルバックのサポートを提供している場合に限り適用できます。
自動プローブを設定します。マルチパスサポートが自動プローブのサポートを提供している場合に限り適用できます。
デフォルトの負荷分散タイプを変更します。loadbalance タイプは、show mpath-support の出力に一覧表示されるサポートされているタイプのいずれかです。
論理ユニットの構成の管理。modify 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 によって、そのサブコマンドと直接オブジェクトの組み合わせに使用可能なオプションの表示が返されます。
例 1 マルチパスサポートのリストを取得する
次のコマンドは、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
属性についての詳細は、マニュアルページの attributes(5) を参照してください。
|
|