1opaextractstat2(8) Master map: IFSFFCLIRG (Man Page) opaextractstat2(8)
3
7 opaextractstat2
8 Performs an error analysis of a fabric and provides augmented informa‐
12 tion from a topology_file including all error counters. The output is
13 in a CSV format suitable for importing into a spreadsheet or parsed by
14 other scripts. opaextractstat2 is a front end to the opareport and
15 opaxmlextract tools.
16
18 opaextractstat2 topology_file [opareport options]
19
21 --help Produces full help text.
22 topology_file
25 Specifies topology_file to use.
26 opareport options
29 The following options are passed to opareport. This subset is
30 considered typical and useful for this command. By design,
31 the tool ignores -o/--output report option.
32 -h/--hfi hfi
37 Specifies the HFI, numbered 1..n. Using 0 specifies
38 that the -p port port is a system-wide port number.
39 (Default is 0.)
40 -p/--port port
46 Specifies the port, numbered 1..n. Using 0 speci‐
47 fies the first active port. (Default is 0.)
48 -X/--infile snapshot_input
54 Generates a report using the data in the snap‐
55 shot_input file. snapshot_input must have been gen‐
56 erated during a previous -o snapshot run. When
57 used, the -s, -i, -C, and -a options are ignored.
58 '-' may be used as the snapshot_input to specify
59 stdin.
60 -i/--interval seconds
66 Obtains performance statistics over interval sec‐
67 onds. Clears all statistics, waits interval sec‐
68 onds, then generates report. Implies -s option.
69 -b / --begin date_time
75 Obtains past performance stats over an interval
76 beginning at date_time. Implies -s option.
77 date_time may be a time entered as HH:MM[:SS] or
78 date as mm/dd/YYYY, dd.mm.YYYY, YYYY-mm-dd or date
79 followed by time; for example, "2016-07-04 14:40".
80 Relative times are taken as "x [sec‐
81 ond|minute|hour|day](s) ago.
82 -e / --end date_time
88 Obtains past performance stats over an interval
89 ending at date_time. Implies -s option.
90 date_time may be a time entered as HH:MM[:SS] or
93 date as mm/dd/YYYY, dd.mm.YYYY, YYYY-mm-dd or date
94 followed by time; for example, "2016-07-04 14:40".
95 Relative times are taken as "x [sec‐
96 ond|minute|hour|day](s) ago.
97 -C/--clear
102 Clears performance statistics for all ports. Only
103 statistics with error thresholds are cleared. A
104 clear occurs after generating the report.
105 -a/--clearall
111 Clears all performance statistics for all ports.
112 -M/--pmadirect
118 Accesses performance statistics using direct PMA.
119 -A/--allports
125 Gets PortInfo for down switch ports. Uses direct
126 SMA to get this data. If used with -M, also gets
127 PMA stats for down switch ports.
128 -c/--config file
134 Specifies the error thresholds configuration file.
135 Default is /etc/opa/opamon.conf file.
136 -L/--limit
142 Limits operation to exact specified focus with -F
143 for port error counters check (-o errors) and port
144 counters clear (-C or -i). Normally, the neighbor
145 of each selected port is also checked/cleared. Does
146 not affect other reports.
147 -F/--focus point
153 Specifies the focus area for report. Used for all
154 reports except route to limit scope of report.
155 Refer to Point Syntax for details.
156
161 -h 0 First active port in system (default).
162 -h 0 -p 0 First active port in system.
165 -h x First active port on HFI x.
168 -h x -p 0 First active port on HFI x.
171 -h 0 -p y Port y within system (no matter which ports are active).
174 -h x -p y HFI x, port y.
177
181 gid:value value is numeric port GID of form: subnet:guid.
182 lid:value value is numeric LID.
185 lid:value:node
188 value is numeric LID, selects entire node with given LID.
189 lid:value:port:value2
192 value is numeric LID of node, value2 is port number.
193 portguid:value
196 value is numeric port GUID.
197 nodeguid:value
200 value is numeric node GUID.
201 nodeguid:value1:port:value2
204 value1 is numeric node GUID, value2 is port number.
205 iocguid:value
208 value is numeric IOC GUID.
209 iocguid:value1:port:value2
212 value1 is numeric IOC GUID, value2 is port number.
213 systemguid:value
216 value is numeric system image GUID.
217 systemguid:value1:port:value2
220 value1 is the numeric system image GUID, value2 is port num‐
221 ber.
222 ioc:value value is IOC Profile ID String (IOC Name).
225 ioc:value1:port:value2
228 value1 is IOC Profile ID String (IOC Name), value2 is port
229 number.
230 iocpat:value
233 value is glob pattern for IOC Profile ID String (IOC Name).
234 iocpat:value1:port:value2
237 value1 is glob pattern for IOC Profile ID String (IOC Name),
238 value2 is port number.
239 ioctype:value
242 value is IOC type (SRP or OTHER).
243 ioctype:value1:port:value2
246 value1 is IOC type (SRP or OTHER); value2 is port number.
247 node:value
250 value is node description (node name).
251 node:value1:port:value2
254 value1 is node description (node name), value2 is port num‐
255 ber.
256 nodepat:value
259 value is glob pattern for node description (node name).
260 nodepat:value1:port:value2
263 value1 is the glob pattern for the node description (node
264 name), value2 is port number.
265 nodedetpat:value
268 value is glob pattern for node details.
269 nodedetpat:value1:port:value2
272 value1 is the glob pattern for the node details, value2 is
273 port number.
274 nodetype:value
277 value is node type (SW, FI, or RT).
278 nodetype:value1:port:value2
281 value1 is node type (SW, FI, or RT), value2 is port number.
282 rate:value
285 value is string for rate (25g, 50g, 75g, 100g), omits switch
286 mgmt port 0.
287 portstate:value
290 value is a string for state (down, init, armed, active,
291 notactive, initarmed).
292 portphysstate:value
295 value is a string for PHYs state (polling, disabled, train‐
296 ing, linkup, recovery, offline, test)
297 mtucap:value
300 value is MTU size (2048, 4096, 8192, 10240), omits switch
301 mgmt port 0.
302 labelpat:value
305 value is glob pattern for cable label.
306 lengthpat:value
309 value is glob pattern for cable length.
310 cabledetpat:value
313 value is glob pattern for cable details.
314 cabinflenpat:value
317 value is glob pattern for cable info length.
318 cabinfvendnamepat:value
321 value is glob pattern for cable info vendor name.
322 cabinfvendpnpat:value
325 value is glob pattern for cable info vendor part number.
326 cabinfvendrevpat:value
329 value is glob pattern for cable info vendor revision.
330 cabinfvendsnpat:value
333 value is glob pattern for cable info vendor serial number.
334 cabinftype:value
337 value is either optical, passive_copper, active_copper, or
338 unknown.
339 linkdetpat:value
342 value is glob pattern for link details.
343 portdetpat:value
346 value is glob pattern for port details.
347 sm Specifies the master subnet manager (SM).
350 smdetpat:value
353 value is glob pattern for SM details.
354 route:point1:point2
357 Specifies all ports along the routes between the two given
358 points.
359 led:value value is either on or off for LED port beacon.
362 linkqual:value
365 Specifies the ports with a link quality equal to value.
366 linkqualLE:value
369 Specifies the ports with a link quality less than or equal to
370 value.
371 linkqualGE:value
374 Specifies the ports with a link quality greater than or equal
375 to value.
376 The portion of the script that calls opareport and opaxmlextract fol‐
380 lows:opareport -x -d 10 -s -o errors -T $@ | opaxmlextract -d ;
381 -e Rate -e MTU -e Internal -e LinkDetails -e CableLength -e CableLabel
382 -e CableDetails -e Port.NodeGUID -e Port.PortGUID -e Port.PortNum
383 -e Port.PortType -e Port.NodeDesc -e Port.PortDetails
384 -e PortXmitData.Value -e PortXmitPkts.Value -e PortRcvData.Value
385 -e PortRcvPkts.Value -e SymbolErrors.Value -e LinkErrorRecovery.Value
386 -e LinkDowned.Value -e PortRcvErrors.Value
387 -e PortRcvRemotePhysicalErrors.Value -e PortRcvSwitchRelayErrors.Value
388 -e PortXmitConstraintErrors.Value -e PortRcvConstraintErrors.Value
389 -e LocalLinkIntegrityErrors.Value -e ExcessiveBufferOverrunErrors.Value
390
392 opaextractstat2 topology_file
393 opaextractstat2 topology_file -c my_opamon.conf
394Copyright(C) 2015-2018 Intel Corporation opaextractstat2(8)