cfgadm_ib - cfgadm の InfiniBand ハードウェア固有のコマンド
/usr/sbin/cfgadm -f [-y | -n] [-v] -c function ap_id...
/usr/sbin/cfgadm [-f] [-y | -n] [-v] [-o hardware_options]
-x hardware_function ap_id...
/usr/sbin/cfgadm -v [-a] [-s listing_option] [-] [ap_id | ap_type...]
/usr/sbin/cfgadm -v -h [ap_id]...
InfiniBand ハードウェア固有のライブラリ /usr/lib/cfgadm/ib.so.1 は、cfgadm(1M) ユーティリティーを使用してファブリックを管理する機能を提供します。cfgadm は、接続点で実行されます。cfgadm(1M) を参照してください。
InfiniBand (IB) デバイスは、IB デバイスマネージャー (IBDM)に基づいて IB 連結ドライバ ib(7D) によって列挙されます。
IB 連結ドライバは、5 種類の子デバイスノードを作成して初期化します。
IB Port デバイス
IB HCA サービス (HCA-SVC) デバイス
IB 仮想物理接続点 (VPPA) デバイス
入出力コントローラ (IOC)
IB 擬似デバイス
IB Port、IB VPPA、および IB HCA-SVC デバイスの列挙の詳細については、ib(7D) を参照してください。IBDM についての追加情報は、ibdm(7D) を参照してください。IB 擬似デバイスについての詳細は、ib(4) を参照してください。
IB 管理では、特定のホストで認識されるように、ファブリック管理用に 2 種類の静的接続点が作成されます。静的接続点 ib が 1 つあり、ファブリックの IB デバイス (IOC、ポート、VPPA、HCA-SVC、または擬似デバイス) はすべてここから分離される動的接続点として表現されます。ホストの各ホストチャネルアダプタ (HCA) には、そのノードのグローバル一意識別子 (GUID) 値に基づく別の静的接続点があります。
接続点には、ap_id を通じて名前が付けられます。論理 ap_id と物理 ap_id の 2 種類の ap_id が定義されます。物理 ap_id は、物理パス名に基づきます。IB ファブリックの場合、/devices/ib:fabric です。論理 ap_id は、より短く、ユーザーにわかりやすい名前を持ちます。
IB ファブリックの静的 ap_id は ib です。IB デバイスは動的接続点であり、物理 ap_id はありません。IOC の論理 ap_id に含まれる GUID は ib::IOC-GUID です。IOC ap_id の例は ib::80020123456789a です。擬似デバイスの論理 ap_id (詳細は ib(4) を参照) の形式は ib::driver_name,unit-address です。擬似 ap_id の例は ib::sdp,0 です。ここで、「sdp」はドライバ名、「0」はその unit-address プロパティーです。ポート、VPPA、および HCA-SVC デバイスの論理 ap_id には、パーティションキー (P_Key)、Port GUID / Node GUID、および通信に関する service-name が含まれます。ap_id の形式は次のとおりです。
ib::PORT_GUID,0,service-name
ib::PORT_GUID,P_Key,service-name
ib::HCA_GUID,0,servicename
Port デバイスおよび HCA-SVC デバイスの場合、パーティションキー (P_Key) は 0 です。P_Key は、VPPA デバイスノード用にこのポートが属するパーティションを特定する際に役立ちます。ポートには複数の P_Key がある場合があります。VPPA デバイスの論理 ap_id ポイントの例は ib::80245678,ffff,ipib です。port-GUID は 80245678、P_Key は 0xffff、サービス名は ipib です。service-name 情報は、service-name 文字列が含まれるファイル /etc/driver/drv/ib.conf から取得されます。HCA の論理 ap_id に含まれるノード GUID 値は hca:HCA-GUID です。例は hca:21346543210a987 です。
IB 接続点の一覧には、ホストで参照されず、使用されるように構成されていない場合でも、ファブリック内のすべての IB デバイス (IBDM および IB 連結ドライバで参照される IOC、VPPA、HCA-SVC、Pseudo、および Port デバイス) に関する情報が含まれます。
次の一覧は、5 つの IB デバイス (2 つの IOC、1 つの VPPA、1 つの Port、1 つの HCA-SVC) と 1 つの HCA を示しています。
example# cfgadm -al Ap_Id Type Receptacle Occupant Condition hca:21346543210a987 IB-HCA connected configured ok ib IB-FABRIC connected configured ok ib::80020123456789a IB-IOC connected configured ok ib::802abc9876543 IB-IOC connected unconfigured unknown ib::80245678,ffff,ipib IB-VPPA connected configured ok ib::12245678,0,nfs IB-PORT connected configured ok ib::21346543,0,hnfs IB-HCA-SVC connected configured ok ib::sdp,0 IB-PSEUDO connected configured ok
ap_id ib::802abc9876543 は、ホストで使用されるように構成されていない、または明示的な操作によって事前にオフラインにされていない IOC デバイスを
cfgadm –c unconfigure
示しています。Condition 列に表示される情報で区別されます。P_Key と HCA GUID がゼロの IB デバイスは HCA-SVC デバイスです。接続点の一覧表示については、cfgadm(1M) を参照してください。
接続点の受容体の状態は、次の意味を持ちます。
IOC/VPPA/Port/Pseudo/HCA-SVC デバイスでは、connected はホストで参照されていることを意味します。デバイスは Solaris で使用されるように構成されてない場合もあります。
HCA 接続点では、connected はデバイスが構成されていて、使用中であることを意味します。
すべての IB ap_id は、常に connected と表示されます。
接続点の占有装置の状態は、次の意味を持ちます。
IB デバイスおよび HCA ap_id が構成され、Solaris で使用可能です。
ap_id の IB デバイスは cfgadm –c unconfigure を使用して明示的にオフラインにされましたが、正常に構成されませんでした。これは、デバイスが Solaris で使用されるように正常に構成されなかったか (ドライバがない、またはデバイスの問題のため)、IB 連結ドライバで使用されるように構成されなかったことが原因になっている可能性があります。
HCA 接続点では、unconfigured 操作はサポートされていません。システムに IB ハードウェアがない場合は、IB の静的 apid (ib) は unconfigured と表示されます。
接続点の条件は次のとおりです。
使用されていません。
使用されていません。
通常の状態です。使用できます。
この状態は、IBDM で検索されたものの、Solaris で使用されるように構成されていない IB デバイスでのみ有効です。また、cfgadm –c unconfigure 操作で明示的にオフラインになったデバイスにも表示されます。この状況は、HCA 接続点には適用されません。
使用されていません。
サポートしているオプションは、次のとおりです。
IB ハードウェア固有のライブラリでは、2 つの汎用コマンド (関数) がサポートされています。これらのコマンドは、静的接続点 (つまり、HCA ap_id および IB の静的 ib ap_id) ではサポートされていません。
次の汎用コマンドがサポートされています。
Solaris で使用されるように IB デバイスを構成します。
IB デバイスの構成を解除します。正常に完了した場合、cfgadm ではこの ap_id の状況が unknown と報告されます。
サポートされていません。
IB 接続点に関する IB 固有のヘルプを取得します。
IB 接続点の状態および状況を一覧表示します。–l オプションは、cfgadm(1M) で説明されているように機能します。
–a オプションとともに使用すると、動的接続点 (IOC、VPPA、ポート、擬似、および HCA-SVC デバイス) も同様に表示されます。
–v オプションとともに使用すると、ap_id に関する詳細データが表示されます。IOC の場合、出力の Info フィールドには、
cfgadm –avl
IOCControllerProfile にある VendorID、IOCDeviceID、DeviceVersion、SubsystemVendorID、SubsystemID、Class、Subclass、Protocol、ProtocolVersion、および IDString に関する情報が表示されます。ID 文字列が指定されていない場合、その場所には何も表示されません。これらのフィールドは、『InfiniBand Specification Volume 1』(http://www.infinibandta.org) に定義されています。
VPPA、ポート、または HCA-SVC デバイスの場合、cfgadm -lav の Info フィールドには、このデバイスがバインドされたサービス名に関する情報が表示されます。このような情報が存在しない場合は、何も表示されません。
擬似デバイス cfgadm -alv の場合、ドライバ名とその unit-address 情報が表示されます。HCA の場合、詳細一覧には VendorID、HCA の ProductID、ポートの数、およびそのポートの PortGUID 値が表示されます。「使用例」を参照してください。
このオプションは、現在定義されていません。
select サブオプションを使用すると、クラス ib の接続点を一覧表示できます。詳細は、cfgadm(1M) のマニュアルページを参照してください。
ハードウェア固有の関数を実行します。name は 4 文字よりも長くできないことに注意してください。
次のハードウェア固有の関数がサポートされています。
このハードウェア固有の関数は、静的 IB 接続点でサポートされています。これを使用すると、新しいサービスを /etc/driver/drv/ib.conf ファイルに追加したり、ib(7D) ドライバを更新したりできます。
新しいサービスが追加されるように指定するには、service=name オプションを使用する必要があります。name サービスを /etc/driver/drv/ib.conf ファイルの port-svc-list または hca-svc-list に追加するには、comm=[port|vppa|hca-svc] オプションを使用する必要があります。「使用例」を参照してください。
このハードウェア固有の関数は、静的 IB 接続点でのみサポートされています。これを使用すると、既存のサービスを /etc/driver/drv/ib.conf ファイルから削除したり、ib(7D) ドライバのデータベースから削除したりできます。削除するサービスを指定するには、service=name オプションを使用する必要があります。このサービスを /etc/driver/drv/ib.conf ファイルの port-svc-list、vppa-svc-list、または vppa-svc-list から削除するには、comm=[port|vppa|hca-svc] オプションを使用する必要があります。「使用例」を参照してください。
HCA 接続点でサポートされています。この HCA を使用して、すべてのカーネル IB クライアントを表示します。また、これらのカーネル IB クライアントおよび代替 HCA デバイス (開いている場合) の各 ap_id も表示されます。「使用例」を参照してください。
.
特定のカーネル IB クライアントに有効な ap_id がない場合は、その列に - が表示されます。
このハードウェア固有の関数は、静的 IB 接続点でのみサポートされています。/etc/driver/drv/ib.conf ファイルから読み取られるすべてのポートおよび VPPA サービスが一覧表示されます。「使用例」を参照してください。
このハードウェア固有の関数は、静的 HCA 接続点でのみサポートされています。これを使用すると、この特定 HCA のすべてのカーネル IB クライアントを構成解除できます。代替 HCA がないカーネル IB クライアントのみが構成解除されます。「使用例」を参照してください。
このハードウェア固有の関数は、静的 IB 接続点および IOC 接続点でサポートされています。ib APID の場合、この関数はすべての IOC デバイスノードのプロパティーを更新します。IOC APID の場合、この関数は指定された IOC デバイスノードのプロパティーを更新します。このコマンドは port-list、port-entries、service-id、および service-name IOC ノードプロパティーを更新します。
ib(7D) を参照してください。
静的 ib 接続点でサポートされています。IBTL 内部の PKEY 情報を更新します。IBTL は、ホストに存在する各 HCA 上のすべてのポートについて P_Key テーブルを再度読み取ります。
ibtl(7D) を参照してください。
次のコマンドは、システム上の IB デバイスの状態および状況を一覧表示します。静的接続点のみが表示されます。
example# cfgadm hca:21346543210a987 IB-HCA connected configured ok ib IB-FABRIC connected configured ok
–a オプションは、すべての接続点を表示します。次の例では、–a オプションを使用して、すべての接続点を一覧表示します。
example# cfgadm -a hca:21346543210a987 IB-HCA connected configured ok ib IB-FABRIC connected configured ok ib::80020123456789a IB-IOC connected unconfigured ok ib::80245678,ffff,ipib IB-VPPA connected configured ok ib::21346543,0,hnfs IB-hca-svc connected configured ok ib::12245678,0,nfs IB-PORT connected configured ok ib::sdp,0 IB-PSEUDO connected configured ok使用例 2 IB VPPA デバイスの詳細ステータスの一覧表示
次のコマンドは、IB VPPA デバイスの詳細ステータスを一覧表示します。
example# cfgadm -alv ib::80245678,ffff,ipib Ap_Id Receptacle Occupant Condition Information When Type Busy Phys_Id ib::80245678,ffff,ipib connected configured ok ipib unavailable IB-VPPA n /devices/ib:fabric::80245678,ffff,ipib
IOC の詳細一覧には、追加情報が表示されます。次のコマンドは、詳細一覧を表示します。
example# cfgadm -alv ib::80020123456789a Ap_Id Receptacle Occupant Condition Information When Type Busy Phys_Id ib::80020123456789a connected configured ok VID: 0xeaea DEVID: 0xeaea VER: 0x5 SUBSYS_VID: 0x0 SUBSYS_ID: 0x0 CLASS: 0xffff SUBCLASS: 0xff PROTO: 0xff PROTOVER: 0x1 ID_STRING: Sample Host Adapter unavailable IB-IOC n /devices/ib:fabric::80020123456789a
擬似デバイスの詳細一覧は、次のものを表示します。
example# cfgadm -alv ib::sdp,0 Ap_Id Receptacle Occupant Condition Information When Type Busy Phys_Id ib::sdp,0 connected configured ok Driver = "sd p" Unit-address = "0" unavailable IB-PSEUDO n /devices/ib:fabric::sdp,0
HCA の詳細一覧は、次のものを表示します。
example# cfgadm -alv hca:21346543210a987 Ap_Id Receptacle Occupant Condition Information When Type Busy Phys_Id hca:21346543210a987 connected configured ok VID: 0x15b3, PID: 0x5a44, #ports: 0x2, port1 GUID: 0x80245678, port2 GUID: 0x80245679 unavailable IB-HCA n /devices/ib:21346543210a987
このような cfgadm クラスおよびフィールドの selection オプション (–s "select=class(ib),cols=ap_id:info") を指定すると、ユーザーにわかりやすい出力を取得できます。
次のコマンドは、IB ap_id のみを表示します。出力には、ap_id および Information フィールドのみが含まれます。
# cfgadm -al -s "cols=ap_id:info" ib::80245678,ffff,ipib Ap_Id Information ib::80245678,ffff,ipib ipib使用例 3 既存の IB IOC の構成解除
次のコマンドは、ib::80020123456789a に接続された IB IOC を構成解除してから、ap_id のステータスを表示します。
# cfgadm -c unconfigure ib::80020123456789a Unconfigure the device: /devices/ib:fabric::80020123456789a This operation will suspend activity on the IB device Continue (yes/no)?
「y」を入力します。
IB device unconfigured successfully. # cfgadm -al ib::80020123456789a Ap_Id Type Receptacle Occupant Condition ib::80020123456789 IB-IOC connected unconfigured unknown #
状況 unknown は、デバイスノードがすでに存在せず、この IB デバイスの存在が IB デバイスマネージャーにしか認識されていないことを意味します。
使用例 4 IB IOC の構成次の一連のコマンドは、ib::80020123456789a に接続された IB デバイスを構成します。
# cfgadm -yc configure ib::80020123456789a # cfgadm -al ib::80020123456789a Ap_Id Type Receptacle Occupant Condition ib::80020123456789a IB-IOC connected configured ok使用例 5 HCA のすべてのカーネル IB クライアントの一覧表示
次のコマンドは、hca:21346543210a987 に接続された HCA のすべてのカーネル IB クライアントを一覧表示します。
# cfgadm -x list_clients hca:21346543210a987 Attachment Point Clients Alternate HCA ib::80020123456789a ioc1 Yes ib::80245678,ffff,ipib ipib No ib::21346543,0,hnfs hnfs No - ibdm No - ibmf No使用例 6 ポートサービスの追加
次のコマンドは、srp という新しいポートサービスを追加します。
# cfgadm -o comm=port,service=srp -x add_service ib使用例 7 VPPA サービスの削除
次のコマンドは、ibd VPPA サービス ibd を削除します。
# cfgadm -o comm=vppa,service=ipib -x delete_service ib使用例 8 ポート、VPPA、HCA-SVC サービスの一覧表示
次のコマンドは、すべてのポート、VPPA、および HCA-SVC サービスを一覧表示します。
# cfgadm -x list_services ib
Port communication services:
srp
VPPA communication services:
ipib
nfs
HCA-SVC communication services:
hnfs
使用例 9 IOC デバイスの再検索
次のコマンドは、すべての IOC デバイスノードを再検索します。
# cfgadm -x update_ioc_config ib This operation can update properties of IOC devices. Continue (yes/no)? Enter: y #使用例 10 HCA のすべてのカーネルクライアントの構成解除
次のコマンドは、HCA のすべてのカーネルクライアントを構成解除します。
# cfgadm -x unconfig_clients hca:21346543 This operation will unconfigure clients of this HCA. Continue (yes/no)? Enter: y
汎用 InfiniBand デバイス管理のためのハードウェア固有ライブラリ
属性についての詳細は、マニュアルページの attributes(5) を参照してください。
|
cfgadm(1M), config_admin(3CFGADM), libcfgadm(3LIB), ib(4), attributes(5), ib(7D), ibdm(7D), ibtl(7D)
InfiniBand Specification Volume 1 (http://www.infinibandta.org)
一覧表示 (cfgadm –l または cfgadm –x list_clients) を除いて、接続点ではスーパーユーザーのみが関数を実行できます。