(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.
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
Produces full help text.
Returns verbose output. A second invocation activates openib debugging, a third invocation activates libibumad debugging.
Issues query in legacy InfiniBand* format.
HFI, numbered 1..n. Using 0 specifies that the -p port port is a system-wide port number. Default is 0.
Port, numbered 1..n. If -h hfi is 0, then port is a system-wide port number. Default is 1.
Output type for query (default is node). See Output Types for details.
Query a specific LID.
Query by node type. See Node Types for details.
Query by system image GUID.
Query by node GUID.
Query by port GUID.
Query a specific PKey.
Query a specific vfindex.
Query a specific service ID.
Query by service level.
Query by port GID. See GIDs for details.
Query by multicast GID. See GIDs for details.
Query by node name/description.
Query by a pair of port GUIDs.
Query by a pair of GIDs. See GIDs for details.
Query by a list of port GUIDs.
Query by a list of GIDs. See GIDs for details.
First active port in system (default).
First active port in system.
First active port on HFI x.
First active port on HFI x.
Port y within system (no matter which ports are active).
HFI x, port y.
Specify a 64-bit subnet and 64-bit interface ID in the form: subnet:interface
For example:
0xfe80000000000000:0x00117500a0000380
classportinfo of the SA.
List of system image GUIDs.
List of node GUIDs.
List of port GUIDs.
List of LIDs.
List of node descriptions/names.
List of path records.
List of node records.
List of port info records.
List of SM info records.
List of switch info records.
List of link records.
List of SC to SC mapping table records.
List of SL to SC mapping table records.
List of SC to SL mapping table records.
List of SC to VLt table records.
List of SC to VLnt table records.
List of VL arbitration table records.
List of PKey table records.
List of service records.
List of multicast member records.
List of inform info records.
List of switch linear forwarding database (FDB) records.
List of switch random FDB records.
List of switch multicast FDB records.
List of trace records.
List of vFabrics.
List of vFabrics in CSV format.
List of vFabrics in CSV format with enums.
List of quarantined nodes.
List of Congestion Info Records.
List of Switch Congestion Settings.
List of HFI Congestion Settings.
List of HFI Congestion Control Settings.
List of buffer control tables.
List of Cable Info records.
List of AR Port Group records.
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.
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
The following list shows the input (assorted query by options) and outputs (-o) that are permitted.
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.
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
trace