(All) Used for testing or debugging performance administration
(PA) operations to the Fabric Executive (FE). This tool performs custom PA
client/server queries. The output formats and arguments are very similar to
opapaquery.
Syntax
opafequery [-v] [-a ipAddr | -h hostName] [-E] [-T paramsfile] -o type [SA options | PA options]
General Options
- -v/--verbose
- Verbose output.
- -a/--ipAddr
ipAddr
- IP address of node running the FE.
- -h/--hostName
hostName
- Host name of node running the FE.
- -o/--output
output
- Output type. See
SA Output Types and
PA Output Types for details.
- -E/--feEsm
ESMName
- ESM FE name.
- -T/--sslParmsFile
filename
- SSL/TLS parameters XML file. Default =
/etc/sysconfig/opa/opaff.xml
SA Specific Options
- -I/--IB
- Issues query in legacy InfiniBand* format.
- -l/--lid
lid
- Queries a specific LID.
- -k/--pkey
pkey
- Queries a specific pkey.
- -i/--vfindex
vfindex
- Queries a specific vfindex.
- -S/--serviceId
serviceId
- Queries a specific service ID.
- -L/--SL
SL
- Queries by service level.
- -t/--type
type
- Queries by node type.
- -s/--sysguid
guid
- Queries by system image GUID.
- -n/--nodeguid
guid
- Queries by node GUID.
- -p/--portguid
guid
- Queries by port GUID.
- -u/--portgid
gid
- Queries by port GID.
- -m/--mcgid
gid
- Queries by multicast GID.
- -d/--desc
name
- Queries by node name/description.
- -P/--guidpair
'guid guid'
- Queries by a pair of port GUIDs.
- -G/--gidpair
'gid gid'
- Queries by a pair of GIDs.
- -B/--guidlist
'sguid ...;dguid ...'
- Queries by a list of port GUIDs.
- -A/--gidlist
'sgid ...;dgid ...'
- Queries by a list of GIDs.
- -x/--sourcegid
gid
- Specifies a source GID for certain queries.
PA Specific Options
- -g/--groupName
groupName
- Group name for groupInfo query.
- -l/--lid
lid
- LID of node for portCounters query.
- -N/--portNumber
- Port number for portCounters query.
- -f/--delta
- Delta flag for portCounters query. Values include: 0 or 1.
- -U/--userCntrs
- User-controlled counters flag for portCounters query.
- -e/--select
- 32-bit select flag for clearing port counters select bits. 0 is
least significant (rightmost):
- 0
- XmitData
- 1
- RcvData
- 2
- XmitPkts
- 3
- RcvPkts
- 4
- MulticastXmitPkts
- 5
- MulticastRcvPkts
- 6
- XmitWait
- 7
- CongDiscards
- 8
- RcvFECN
- 9
- RcvBECN
- 10
- XmitTimeCong
- 11
- XmitWastedBW
- 12
- XmitWaitData
- 13
- RcvBubble
- 14
- MarkFECN
- 15
- RcvConstraintErrors
- 16
- RcvSwitchRelayErrors
- 17
- XmitDiscards
- 18
- XmitConstraintErrors
- 19
- RcvRemotePhysicalErrors
- 20
- LocalLinkIntegrityErrors
- 21
- RcvErrors
- 22
- ExcessiveBufferOverruns
- 23
- FMConfigErrors
- 24
- LinkErrorRecovery
- 25
- LinkDowned
- 26
- UncorrectableErrors
- -c/--focus
focus
- Focus select value for getting focus ports. Values include:
- 0x00020001
- Sorted by utilization - highest first.
- 0x00020082
- Sorted by packet rate - highest first.
- 0x00020101
- Sorted by utilization - lowest first.
- 0x00030001
- Sorted by integrity errors - highest first.
- 0x00030002
- Sorted by congestion errors - highest first.
- 0x00030003
- Sorted by SMA congestion errors - highest first.
- 0x00030004
- Sorted by bubble errors - highest first.
- 0x00030005
- Sorted by security errors - highest first.
- 0x00030006
- Sorted by routing errors - highest first.
- -w/--start
- Start of window for focus ports - should always be 0.
- -r/--range
range
- Size of window for focus ports list.
- -b/--imgNum
- 64-bit image number. May be used with
groupInfo,
groupConfig,
portCounters (delta) outputs.
- -O/--imgOff
- Image offset. May be used with
groupInfo,
groupConfig,
portCounters (delta) outputs.
- -F/--moveImgNum
- 64-bit image number. Used with
moveFreeze output to move a freeze image.
- -M/--moveImgOff
ImgOff
- Image offset. May be used with
moveFreeze output to move a freeze image.
- -V/--vfName
- VF name for vfInfo query.
SA Output Types
Output types include:
- saclassPortInfo
- Class port info.
- 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.
- fabricinfo
- Summary of fabric devices.
- 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.
PA Output Types
- paclassPortInfo
- Class port info.
- groupList
- List of PA groups.
- groupInfo
- Summary statistics of a PA group. Requires
-g option for
groupName.
- groupConfig
- Configuration of a PA group. Requires
-g option for
groupName.
- portCounters
- Port counters of fabric port. Requires
-l
lid and
-N
port options. Optionally, use the
-f
delta option.
- clrPortCounters
- Clears port counters of fabric port. Requires
-l
lid,
-N
port, and
-e
select options.
- clrAllPortCounters
- Clears all port counters in fabric.
- pmConfig
- Retrieves PM configuration information.
- freezeImage
- Creates freeze frame for image ID. Requires
-b
imgNum.
- releaseImage
- Releases freeze frame for image ID. Requires
-b
imgNum.
- renewImage
- Renews lease for freeze frame for image ID. Requires
-b imgNum.
- moveFreeze
- Moves freeze frame from image ID to new image ID. Requires
-b imgNum and
-F
moveImgNum.
- focusPorts
- Gets sorted list of ports using utilization or error values (from
group buckets).
- imageInfo
- Gets information about a PA image (timestamps and other details).
Requires
-b
imgNum.
- vfList
- List of virtual fabrics.
- vfInfo
- Summary statistics of a virtual fabric. Requires
-V
vfName option.
- vfConfig
- Configuration of a virtual fabric. Requires
-V
vfName option.
- vfPortCounters
- Port counters of fabric port. Requires
-V
vfName,
-l
lid, and
-N
port options. Optionally, use the
-f
delta option.
- vfFocusPorts
- Gets sorted list of virtual fabric ports usingutilization or
error values (from VF buckets). Requires
-V
vfName option.
- clrVfPortCounters
- Clears VF port counters of fabric port. Requires
-l
lid,
-N
port,
-e
select, and
-V
vfName options.
Examples
opafequery -o classPortInfo
opafequery -h stewie -o classPortInfo
opafequery -a 172.21.2.155 -o classPortInfo
opafequery -o groupList
opafequery -o groupInfo -g All
opafequery -o groupConfig -g All
opafequery -h stewie -o groupInfo -g All
opafequery -a 172.21.2.155 -o groupInfo -g All
opafequery -o portCounters -l 1 -P 1 -d 1
opafequery -o portCounters -l 1 -P 1 -d 1 -n 0x20000000d02 -O 1
opafequery -o pmConfig
opafequery -o freezeImage -n 0x20000000d02
opafequery -o releaseImage -n 0xd01
opafequery -o renewImage -n 0xd01
opafequery -o moveFreeze -n 0xd01 -m 0x20000000d02 -M -2
opafequery -o focusPorts -g All -f 0x00030001 -S 0 -r 20
opafequery -o imageInfo -n 0x20000000d02