cfgadm コマンドを使用して、システムの IB デバイスを構成したり、構成を解除したりできます。このコマンドは、ホストから見た IB ファブリック全体の動的再構成 (DR) を管理します。また、このコマンドを使用すると、次の操作を行うことができます。
IB ファブリックの表示
通信サービスの管理
P_key テーブルデータベースの更新
詳細は、cfgadm_ib(1M) のマニュアルページを参照してください。
すべての IB デバイス (Port、VPPA、HCA_SVC、IOC、疑似デバイスなど) で cfgadm の操作がサポートされます。
IB デバイスの情報を表示するには、次のコマンド構文を使用します。
# cfgadm -[a]l
ここで、–a オプションを指定すると、–l オプションのみを使用した場合よりも多くの情報が表示されます。
次の出力例では、関連する IB 情報のみが表示されるように情報が切り捨てられています。
# cfgadm -al Ap_Id Type Receptacle Occupant Condition ib IB-Fabric connected configured ok hca:21280001A0A478 IB-HCA connected configured ok ib::21280001A0A47A,0,ipib IB-PORT connected configured ok ib::21280001A0A479,0,ipib IB-PORT connected configured ok ib::1730000008070,0,hnfs IB-HCA_SVC connected configured ok ib::daplt,0 IB-PSEUDO connected configured ok ib::iser,0 IB-PSEUDO connected configured ok ib::rdsib,0 IB-PSEUDO connected configured ok ib::rdsv3,0 IB-PSEUDO connected configured ok ib::rpcib,0 IB-PSEUDO connected configured ok ib::sdpib,0 IB-PSEUDO connected configured ok ib::sol_umad,0 IB-PSEUDO connected configured ok ib::sol_uverbs,0 IB-PSEUDO connected configured ok
cfgadm コマンドは接続点についての情報を表示します。「接続点」とは、DR 操作を行うことができるシステム内の特定の場所のことです。
接続点の詳細は、接続点を参照してください。cfgadm コマンドでサポートされる接続点については、cfgadm_ib(1M) のマニュアルページを参照してください。
接続点は、受容体と占有装置で構成されます。次の表は、対応する受容体、占有装置、および状態の組み合わせの状態に応じたデバイスの状態を示しています。
|
デバイスは接続点 ID (Ap_Id) でリストされます。IB の Ap_Id は、すべて connected と表示されます。次のリストは、出力例の特定の Ap_Id の情報を示しています。
ポート GUID に接続され、ipib サービスにバインドされている IB ポートデバイスを識別しています。
擬似デバイスを識別しています。
HCA デバイスを識別しています。
hnfs サービスにバインドされている IB HCA_SVC デバイスを識別しています。
擬似デバイスを識別しています。
cfgadm コマンドのほかのオプションを使用すると、表示される情報をさらにカスタマイズできます。次の例は、いくつかのオプションの使用方法を示しています。
使用例 14 ポートデバイスに関する情報の表示次の例は、ポートデバイス ib::21280001A0A47A,0,ipib に関する情報を表示しています。
# cfgadm -al -s "cols=ap_id:info" ib::21280001A0A47A,0,ipib Ap_Id Information ib::21280001A0A47A,0,ipib ipib使用例 15 HCA デバイスのポートおよび GUID 情報の表示
この例は、HCA デバイス hca::1730000008070 のポートの数、およびそれぞれのポートの GUID を示しています。
# cfgadm -al -s "cols=ap_id:info" hca::1730000008070 Ap_Id Information hca::1730000008070 VID: 0x15b3, PID: 0x5a44, #ports: 0x2, port1 GUID: 0x1730000008071, port2 GUID: 0x1730000008072使用例 16 HCA デバイスのカーネルクライアントの表示
この例は、HCA hca:173000007F50 のカーネルクライアントを表示しています。
$ cfgadm -x list_clients hca:173000007F50 Ap_Id IB Client Alternate HCA ib::1730000007F51D0 ibgen no ib::1730000007F51D1 ibgen no ib::1730000007F51,0,ipib ibd no ib::ibgen,0 ibgen no - ibdm no - ibmf no - nfs/ib no
この出力例で、カーネル IB クライアントが hca:173000007F50 以外の HCA を使用している場合は、列 Alternate HCA のエントリに yes が示されます。この HCA を使用しない IB マネージャーおよびカーネルクライアントの場合、Ap_Id は表示されません。また、EoIB は Solaris IB フレームワークを使用していますが、このコマンドは EoIB をカーネル IB クライアントとしてリストしません。
使用例 17 サポートされる通信サービスの表示次の例は、IBTF (InfiniBand Transport Framework) によって現在使用されている IB 通信サービスをリストしています。
# cfgadm -x list_services ib Port communication services: srp VPPA communication services: ibd HCA_SVC communication services: hnfs
prtconf コマンドを使用して IB デバイスの一般的な情報を表示することもできます。次の例では、pci15b3,673c は IB HCA を示しています。
$ prtconf . . . ib, instance #0 rpcib, instance #0 rdsib, instance #0 daplt, instance #0 rdsv3, instance #0 sdpib, instance #0 sol_umad, instance #0 sol_uverbs, instance #0 iser, instance #0 . . . pci15b3,673c, instance #0 ibport, instance #0 ibport, instance #1
IB デバイスを構成または構成解除するには、次のコマンドを使用します。これらのコマンドは、IB ポート、HCA_SVC、または VPPA デバイスに適用されます。
cfgadm -c configure device は IB デバイスを構成します。
cfgadm -c unconfigure device は IB デバイスを構成解除します。
どちらのコマンドの場合も、device は Ap_Id で指定します。
実用的な手順として、デバイスの構成または構成解除の実際の手順の前後に、システムデバイスに関する情報を表示するようにしてください。この情報は次のように役に立ちます。
動的再構成するバスまたはデバイスを正しく識別できます。
バスまたはデバイスの状態によって、再構成が正常に完了したことを確認できます。
次の例は、cfgadm コマンドを使用して、IB デバイスに対して DR を実行する方法を示しています。
使用例 18 IB ポートデバイスの構成次の例は、IB ポートデバイス ib::1730000007F51,*0*,ipib を構成して、その操作を検証しています。
# cfgadm -c configure ib::1730000007F51,*0*,ipib
# cfgadm -a ib::1730000007F51,*0*,ipib
Ap_Id Type Receptacle Occupant Condition
ib::1730000007F51,*0*,ipib IB-Port connected configured okこのポートデバイスは構成されています。
以前ポートが構成解除されていたときに EoIB データリンクを IB ポートを介して構成した場合は、それらの EoIB データリンクに対応する VNIC を新しい IB HCA ポートの GUID で EoIB ゲートウェイに再作成する必要があります。IB Port を再構成する前に、VNIC を再作成する必要があります。ゲートウェイに VNIC を作成する方法については、Sun Network QDR InfiniBand ゲートウェイスイッチに関する管理ガイド (http://docs.oracle.com/cd/E36256_01/pdf/E36260.pdf) を参照してください。
使用例 19 IB ポートデバイスの構成解除次の例は、IB ポートデバイス ib::1730000007F51,*0*,ipib を構成解除して、その操作を検証しています。
# cfgadm -c unconfigure ib::1730000007F51,*0*,ipib
Unconfigure the device: /devices/ib:fabric::1730000007F51,*0*,ipib
This operation will suspend activity on the IB device
Continue (yes/no)? Y
# cfgadm -a ib::1730000007F51,*0*,ipib
Ap_Id Type Receptacle Occupant Condition
ib::1730000007F51,*0*,ipib IB-Port connected unconfigured unknownこのポートデバイスは構成解除されています。
使用例 20 IB 擬似デバイスの構成
次の例は、疑似デバイス ib::ibgen,0 を構成して、その操作を検証しています。
# cfgadm -yc configure ib::ibgen,0
# cfgadm -a ib::ibgen,0
Ap_Id Type Receptacle Occupant Condition
ib::ibgen,0 IB-PSEUDO connected configured okこのデバイスは構成されています。
使用例 21 IB 擬似デバイスの構成解除
次の例は、疑似デバイス ib::ibgen,0 を構成解除して、その操作を検証しています。
# cfgadm -c unconfigure ib::ibgen,0
Unconfigure the device: /devices/ib:fabric::ibgen,0
This operation will suspend activity on the IB device
Continue (yes/no)? Y
# cfgadm -a ib::ibgen,0
Ap_Id Type Receptacle Occupant Condition
ib::ibgen,0 IB-PSEUDO connected unconfigured unknownこのデバイスは構成解除されています。
このセクションでは、次の cfgadm コマンドを使用して、既存の IB 構成を変更する例を示します。
cfgadm -o hardware-options
cfgadm -x hardware-functions (表示する情報をカスタマイズするためにも使用します。IB デバイス情報の表示を参照してください。)
追加の P_key を有効にするか、それらを無効にすると、HCA のポートの P_key テーブルの情報が変更されます。整合性を保つために、IBTF (InfiniBand Transport Framework) および IBDM の内部の P_key データベースでも対応する更新が行われる必要があります。
次の例は、IBTF および IBDM の P_key データベースを更新する方法を示しています。
# cfgadm -x update_pkey_tbls -y ib
詳細は、ibtl(7D) および ibdm(7D) のマニュアルページを参照してください。
使用例 23 通信サービスの追加次の例は、VPPA 通信サービスを IB デバイスに追加して、その操作を検証しています。
# cfgadm -o comm=vppa,service=new -x add_service ib
# cfgadm -x list_services ib
Port communication services:
srp
VPPA communication services:
ibd
newサービスが追加されました。
HCA_SVC communication services:
nfs_service
使用例 24 既存の通信サービスの削除
この例では、前の例で追加された通信サービスを削除しています。通信サービスの名前は new です。削除後に、操作が完了したことを検証しています。
# cfgadm -o comm=vppa,service=new -x delete_service ib # cfgadm -x list_services ib Port communication services: srp VPPA communication services: ibd HCA_SVC communication services: hnfs