(All) Performs various queries of the performance management (PM)/performance administration (PA) agent and provides details about fabric performance. Refer to the Intel® Omni-Path Fabric Suite Fabric Manager User Guide for a description of the operation and client services of the PM/PA.
By default, opapaquery queries the most recent data. However, if an image number (imgNum) and/or image offset (imgOff) is provided, the query returns previous sweep data. Queries that access previous sweep data return with the absolute image number representing that data, and therefore have an image offset of zero.
opapaquery's operation is dependent on an Intel® Omni-Path Fabric Suite Fabric Manager version 6.0 or greater running as master SM/PM in the fabric.
By default, opapaquery 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 HFI and port may be specified to select the fabric whose PA is to be queried.
opapaquery [-v] [-h hfi] [-p port] [-o type] [-g groupName] [-l nodeLid] [-P portNumber] [-d delta] [-j date_time] [-q date_time] [-U] [-s select] [-f focus] [-S start] [-r range] [-n imgNum] [-O imgOff] [-y imgTime] [-m moveImgNum] [-M moveImgOff] [-V vfName]
Specifies the verbose output.
Specifies the HFI, numbered 1..n. Using 0 specifies that the -p port port is a system-wide port number. (Default is 0.)
Specifies the port, numbered 1..n. Using 0 specifies the first active port. (Default is 0.)
Specifies the output type, default is groupList. See Output Types.
Specifies the group name for groupInfo query.
Specifies the LID of node for portCounters query.
Specifies the port number for portCounters query.
Specifies the delta flag for portCounters query - 0 or 1.
date_time may be a time entered as HH:MM[:SS] or date as mm/dd/YYYY, dd.mm.YYYY, YYYY-mm-dd or date followed by time; for example, "2016-07-04 14:40". Relative times are taken as "x [second|minute|hour|day](s) ago.
date_time may be a time entered as HH:MM[:SS] or date as mm/dd/YYYY, dd.mm.YYYY, YYYY-mm-dd or date followed by time; for example, "2016-07-04 14:40". Relative times are taken as "x [second|minute|hour|day](s) ago.
Queries by user-controlled counters flag for portCounters.
Specifies the 32-bit select flag for clearing port counters.
0x80000000 - 31 - Transmit Data (XmitData)
0x40000000 - 30 - Receive Data (RcvData)
0x20000000 - 29 - Transmit Packets (XmitPkts)
0x10000000 - 28 - Receive Packets (RcvPkts)
0x08000000 - 27 - Multicast Transmit Packets (MulticastXmitPkts)
0x04000000 - 26 - Multicast Receive Packets (MulticastRcvPkts)
0x02000000 - 25 - Transmit Wait (XmitWait)
0x01000000 - 24 - Congestion Discards (CongDiscards)
0x00800000 - 23 - Receive FECN (RcvFECN)
0x00400000 - 22 - Receive BECN (RcvBECN)
0x00200000 - 21 - Transmit Time Congestion (XmitTimeCong)
0x00100000 - 20 - Transmit Time Wasted BW (XmitWastedBW)
0x00080000 - 19 - Transmit Time Wait Data (XmitWaitData)
0x00040000 - 18 - Receive Bubble (RcvBubble)
0x00020000 - 17 - Mark FECN (MarkFECN)
0x00010000 - 16 - Receive Constraint Errors (RcvConstraintErrors)
0x00008000 - 15 - Receive Switch Relay (RcvSwitchRelayErrors)
0x00004000 - 14 - Transmit Discards (XmitDiscards)
0x00002000 - 13 - Transmit Constraint Errors (XmitConstraintErrors)
0x00001000 - 12 - Receive Remote Physical Errors (RcvRemotePhysicalErrors)
0x00000800 - 11 - Local Link Integrity (LocalLinkIntegrityErrors)
0x00000400 - 10 - Receive Errors (RcvErrors)
0x00000200 - 9 - Excessive Buffer Overrun (ExcessiveBufferOverruns)
0x00000100 - 8 - FM Configuration Errors (FMConfigErrors)
0x00000080 - 7 - Link Error Recovery (LinkErrorRecovery)
0x00000040 - 6 - Link Error Downed (LinkDowned)
0x00000020 - 5 - Uncorrectable Errors (UncorrectableErrors)
0x80000000 - 31 - VL Transmit Data (VLXmitData)
0x40000000 - 30 - VL Receive Data (VLRcvData)
0x20000000 - 29 - VL Transmit Packets (VLXmitPkts)
0x10000000 - 28 - VL Receive Packets (VLRcvPkts)
0x08000000 - 27 - VL Transmit Discards (VLXmitDiscards)
0x04000000 - 26 - VL Congestion Discards (VLCongDiscards)
0x02000000 - 25 - VL Transmit Wait (VLXmitWait)
0x01000000 - 24 - VL Receive FECN (VLRcvFECN)
0x00800000 - 23 - VL Receive BECN (VLRcvBECN)
0x00400000 - 22 - VL Transmit Time Congestion (VLXmitTimeCong)
0x00200000 - 21 - VL Transmit Wasted BW (VLXmitWastedBW)
0x00100000 - 20 - VL Transmit Wait Data (VLXmitWaitData)
0x00080000 - 19 - VL Receive Bubble (VLRcvBubble)
0x00040000 - 18 - VL Mark FECN (VLMarkFECN)
Bits 17-0 reserved
Sorted by utilization - highest first.
Sorted by packet rate - highest first.
Sorted by utilization - lowest first.
Sorted by integrity category - highest first.
Sorted by congestion category - highest first.
Sorted by SMA congestion category - highest first.
Sorted by security category - highest first.
Sorted by routing category - highest first.
Specifies the start of window for focus ports, should always be 0.
Specifies the size of window for focus ports list.
Specifies the 64-bit image number. Can be used with groupInfo, groupConfig, portCounters (delta).
Specifies the image offset. Can be used with groupInfo, groupConfig, portCounters (delta).
Specifies the image time. May be used with imageinfo, groupInfo, groupInfo, groupConfig, freezeImage, focusPorts, vfInfo, vfConfig, and vfFocusPorts. Will return closest image within image interval if possible. See --begin/--end above for format.
Specifies the 64-bit image number. Used with moveFreeze to move a freeze image.
Specifies the image offset. Can be used with moveFreeze to move a freeze image.
Specifies the VF name for vfInfo query.
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.
Specifies the class port info.
Specifies the list of PA groups.
Specifies the summary statistics of a PA group. Requires -g option for groupName.
Specifies the configuration of a PA group. Requires -g option for groupName.
Specifies the port counters of fabric port. Requires -l lid and -P port options, -d delta is optional.
Clears port counters of fabric port. Requires -l lid and -P port, and -s select options.
Clears all port counters in fabric.
Retrieves PM configuration information.
Creates freeze frame for image ID. Requires -n imgNum.
Releases freeze frame for image ID. Requires -n imgNum.
Renews lease for freeze frame for image ID. Requires -n imgNum.
Moves freeze frame from image ID to new image ID. Requires -n imgNum and -m moveImgNum.
Gets sorted list of ports using utilization or error values (from group buckets). Requires -g groupname, -f focus, -S start, -r range.
Gets configuration of a PA image (timestamps, etc.). Requires -n imgNum.
Specifies the list of virtual fabrics.
Specifies the summary statistics of a virtual fabric. Requires -V option for vfName.
Specifies the configuration of a virtual fabric. Requires -V option for vfName.
Specifies the port counters of fabric port. Requires -V vfName, -l lid and -P port options, -d delta is optional.
Gets sorted list of virtual fabric ports using utilization or error values (from VF buckets). Requires -V vfname, -f focus, -S start, -r range.
Clears VF port counters of fabric port. Requires -l lid, -P port, -s select, and -V vfname options.
opapaquery -o classPortInfo opapaquery -o groupList opapaquery -o groupInfo -g All opapaquery -o groupConfig -g All opapaquery -o portCounters -l 1 -P 1 -d 1 opapaquery -o portCounters -l 1 -P 1 -d 1 -n 0x20000000d02 -O 1 opapaquery -o portCounters -l 1 -P 1 -d 1 -j 13:30 -q 14:20 opapaquery -o clrPortCounters -l 1 -P 1 -s 0xC0000000 #clears XmitData & RcvData opapaquery -o clrAllPortCounters -s 0xC0000000 #clears XmitData & RcvData on all ports opapaquery -o PMConfig opapaquery -o freezeImage -n 0x20000000d02 opapaquery -o releaseImage -n 0xd01 opapaquery -o renewImage -n 0xd01 opapaquery -o moveFreeze -n 0xd01 -m 0x20000000d02 -M -2 opapaquery -o focusPorts -g All -f 0x00030001 -S 0 -r 20 opapaquery -o imageInfo -n 0x20000000d02 opapaquery -o imageInfo -y "1 hour ago" opapaquery -o vfList opapaquery -o vfInfo -V Default opapaquery -o vfConfig -V Default opapaquery -o vfPortCounters -l 1 -P 1 -d 1 -V Default opapaquery -o clrVfPortCounters -l 1 -P 1 -s 0xC0000000 -V Default #clears VLXmitData & VLRcvData opapaquery -o vfFocusPorts -V Default -f 0x00030001 -S 0 -r 20