opasaquery

(All) Performs various queries of the subnet manager/subnet agent and provides detailed fabric information.

opareport and opareports can provide a more powerful tool, however, in some cases opasaquery is preferred, especially when dealing with virtual fabrics, service records, and multicast.

The command opasaquery is installed on all hosts as part of the Intel® Omni-Path Fabric Host Software, but it is also included in Intel® Omni-Path Fabric Suite FastFabric Toolset.

By default, opasaquery uses the first active port on the local system. However, if the Fabric Management Node is connected to more than one fabric (for example, a subnet), the Intel® Omni-Path Host Fabric Interface (HFI) and port may be specified to select the fabric whose SA is to be queried.

Syntax

opasaquery [-v [-v] [-v]] [-I] [-h hfi] [-p port] [-o type] [-l lid] [-t type] 
[-s guid] [-n guid] [-g guid] [-k pkey] [-i vfIndex] [-S serviceId] 
[-L sl] [-u gid] [-m gid] [-d name] [-P 'guid guid'] [-G 'gid gid'] 
[-a 'sguid...;dguid...'] [-A 'sgid...;dgid...']

or

opasaquery --help

Options

--help

Produces full help text.

-v/--verbose

Returns verbose output. A second invocation activates openib debugging, a third invocation activates libibumad debugging.

-I/--IB

Issues query in legacy InfiniBand* format.

-h/--hfi hfi

HFI, numbered 1..n. Using 0 specifies that the -p port port is a system-wide port number. Default is 0.

-p/--port port

Port, numbered 1..n. If -h hfi is 0, then port is a system-wide port number. Default is 1.

-o/--output type

Output type for query (default is node). See Output Types for details.

-l/--lid lid

Query a specific LID.

-t/--type node_type

Query by node type. See Node Types for details.

-s/--sysguid system_image_guid

Query by system image GUID.

-n/--nodeguid node_guid

Query by node GUID.

-g/--portguid port_guid

Query by port GUID.

-k/--pkey pkey

Query a specific PKey.

-i/--vfindex vfIndex

Query a specific vfindex.

-S/--serviceId serviceId

Query a specific service ID.

-L/--SL SL

Query by service level.

-u/--portgid port_gid

Query by port GID. See GIDs for details.

-m/--mcgid multicast_gid

Query by multicast GID. See GIDs for details.

-d/--desc node_description

Query by node name/description.

-P/--guidpair guid guid

Query by a pair of port GUIDs.

-G/--gidpair gid gid

Query by a pair of GIDs. See GIDs for details.

-a/--guidlist sguid ...;dguid ...

Query by a list of port GUIDs.

-A/--gidlist sgid ...;dgid ...

Query by a list of GIDs. See GIDs for details.

-h 0

First active port in system (default).

-h 0 -p 0

First active port in system.

-h x

First active port on HFI x.

-h x -p 0

First active port on HFI x.

-h 0 -p y

Port within system (no matter which ports are active).

-h x -p y

HFI x, port y.

Node Types

fi

Fabric Interface

sw

Switch

GIDs

Specify a 64-bit subnet and 64-bit interface ID in the form: subnet:interface

For example:

0xfe80000000000000:0x00117500a0000380

Output Types

classportinfo

classportinfo of the SA.

systemguid

List of system image GUIDs.

nodeguid

List of node GUIDs.

portguid

List of port GUIDs.

lid

List of LIDs.

desc

List of node descriptions/names.

path

List of path records.

node

List of node records.

portinfo

List of port info records.

sminfo

List of SM info records.

swinfo

List of switch info records.

link

List of link records.

scsc

List of SC to SC mapping table records.

slsc

List of SL to SC mapping table records.

scsl

List of SC to SL mapping table records.

scvlt

List of SC to VLt table records.

scvlnt

List of SC to VLnt table records.

vlarb

List of VL arbitration table records.

pkey

List of PKey table records.

service

List of service records.

mcmember

List of multicast member records.

inform

List of inform info records.

linfdb

List of switch linear forwarding database (FDB) records.

ranfdb

List of switch random FDB records.

mcfdb

List of switch multicast FDB records.

trace

List of trace records.

vfinfo

List of vFabrics.

vfinfocsv

List of vFabrics in CSV format.

vfinfocsv2

List of vFabrics in CSV format with enums.

quarantine

List of quarantined nodes.

conginfo

List of Congestion Info Records.

swcongset

List of Switch Congestion Settings.

hficongset

List of HFI Congestion Settings.

hficongcon

List of HFI Congestion Control Settings.

bfrctrl

List of buffer control tables.

cableinfo

List of Cable Info records.

portgroup

List of AR Port Group records.

portgroupfdb

List of AR Port Group FWD records.

The vfinfocsv and vfinfocsv2 output formats are designed to make it easier to script vfinfo queries. One line is output per vFabric of the form:

name:index:pkey:sl:mtu:rate

The only difference between these two formats is how the MTU and rate are output. vfinfocsv outputs MTU and rate in human/text format, such as 2048 and 40g. vfinfocsv2 outputs MTU and rate as the IBTA enumerations defined for the SMA protocol, such as 4 and 7. The opagetvf command can be a useful tool which is based on this capability of opasaquery.

Example

opasaquery -o desc -t fi
# get list of node description records for HFIs

opasaquery -o portinfo -l 2
# get list of port info records for lid 2

opasaquery -o pkey
# get list of PKey table records

opasaquery -o vlarb
# get list of VL arbitration records

opasaquery -o swinfo
# get list of switch info records

opasaquery -o slsc
# get list of SL to SC mapping table records

opasaquery -o scsl
# get list of SC to SL mapping table records

Input Options vs. Output Permitted

The following list shows the input (assorted query by options) and outputs (-o) that are permitted.

Note:

In this release, the combinations displayed in bold are currently not available. This includes the path-given input of node description, node type, system image GUID, node GUID, and port GUID list.

None
-o output permitted

systemguid, nodeguid, portguid, lid, desc, path, node, portinfo, sminfo, swinfo, link, slvl, vlarb, pkey, guids, service, mcmember, inform, linfdb, ranfdb, mcfdb, vfinfo, vfinfocsv, vfinfocsv2, vswinfo

-o output not permitted

trace

-t node_type
-o output permitted

systemguid, nodeguid, portguid, lid, link, desc, path, node

-o output not permitted

portinfo, sminfo, swinfo, slvl, vlarb, pkey, guids, service, mcmember, inform, linfdb, ranfdb, mcfdb, trace, vfinfo, vfinfocsv, vfinfocsv2, vswinfo

-l lid
-o output permitted

systemguid, nodeguid, portguid, lid, desc, path, node, portinfo, swinfo, slvl, vlarb, pkey, guids, service, mcmember, linfdb, ranfdb, mcfdb, vswinfo

-o output not permitted

sminfo, link, inform, trace, vfinfo, vfinfocsv, vfinfocsv2

-k pkey
-o output permitted

mcmember, path, vfinfo, vfinfocsv, vfinfocsv2

-o output not permitted

systemimageguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, slvl, vlarb, pkey, guids, service, mcmember, inform, linfdb, ranfdb, mcfdb, vswinfo

-i vfindex
-o output permitted

vfinfo, vfinfocsv, vfinfocsv2

-o output not permitted

systemimageguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, slvl, vlarb, pkey, guids, service, mcmember, inform, linfdb, ranfdb, mcfdb, vswinfo

-s system_image_guid
-o output permitted

systemguid, nodeguid, portguid, lid, desc, path, node

-o output not permitted

portinfo, sminfo, swinfo, link, slvl, vlarb, pkey, guids, service, mcmember, inform, linfdb, ranfdb, mcfdb, trace, vfinfo, vfinfocsv, vfinfocsv2, vswinfo

-n node_guid
-o output permitted

systemguid, nodeguid, portguid, lid, desc, path, node

-o output not permitted

portinfo, sminfo, swinfo, link, slvl, vlarb, pkey, guids, service, mcmember, inform, linfdb, ranfdb, mcfdb, trace, vfinfo, vfinfocsv, vfinfocsv2, vswinfo

-g port_guid
-o output permitted

systemguid, nodeguid, portguid, lid, desc, path, node, service, mcmember, inform, trace

-o output not permitted

portinfo, sminfo, swinfo, link, slvl, vlarb, pkey, guids, linfdb, ranfdb, mcfdb, vfinfo, vfinfocsv, vfinfocsv2, vswinfo

-u port_gid
-o output permitted

path, service, mcmember, inform, trace

-o output not permitted

systemguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, slvl, vlarb, pkey, guids, linfdb, ranfdb, mcfdb, vfinfo, vfinfocsv, vfinfocsv2, vswinfo

-m multicast_gid
-o output permitted

mcmember, vfinfo, vfinfocsv, vfinfocsv2

-o output not permitted

systemguid, nodeguid, portguid, lid, desc, path, node, portinfo, sminfo, swinfo, link, slvl, vlarb, pkey, guids, service, inform, linfdb, ranfdb, mcfdb, trace, vswinfo

-d name
-o output permitted

systemguid, nodeguid, portguid, lid, desc, path, node

-o output not permitted

trace

-P port_guid_pair
-o output permitted

path, trace

-o output not permitted

systemguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, slvl, vlarb, pkey, guids, service, mcmember, inform, linfdb, ranfdb, mcfdb, vswinfo

-S serviceId
-o output permitted

path, vfinfo, vfinfocsv, vfinfocsv2

-o output not permitted

systemimageguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, slvl, vlarb, pkey, guids, service, mcmember, inform, linfdb, ranfdb, mcfdb, vswinfo

-L SL
-o output permitted

path, vfinfo, vfinfocsv, vfinfocsv2

-o output not permitted

systemimageguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, slvl, vlarb, pkey, guids, service, mcmember, inform, linfdb, ranfdb, mcfdb, vswinfo

-G gid_pair
-o output permitted

path, trace

-o output not permitted

systemguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, slvl, vlarb, pkey, guids, service, mcmember, inform, linfdb, ranfdb, mcfdb, vswinfo

-a port_guid_list
-o output permitted

path

-o output not permitted

systemguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, slvl, vlarb, pkey, guids, service, mcmember, inform, linfdb, ranfdb, mcfdb, trace, vswinfo

-A gid_list
-o output permitted

path

-o output not permitted

systemguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, slvl, vlarb, pkey, guids, service, mcmember, inform, linfdb, ranfdb, mcfdb, trace, vswinfo