1opaextracterror(8) Master map: IFSFFCLIRG (Man Page) opaextracterror(8)
3
7 opaextracterror
8 Produces a CSV file listing all or some of the errors in the current
12 fabric. opaextracterror is a front end to the opareport tool. The out‐
13 put from this tool can be imported into a spreadsheet or parsed by
14 other scripts.
15
17 opaextracterror [opareport options]
18
20 --help Produces full help text.
21 opareport options
24 The following options are passed to opareport. This subset is
25 considered typical and useful for this command. By design,
26 the tool ignores -o/--output report option.
27 -h/--hfi hfi
32 Specifies the HFI, numbered 1..n. Using 0 specifies
33 that the -p port port is a system-wide port number.
34 (Default is 0.)
35 -p/--port port
41 Specifies the port, numbered 1..n. Using 0 speci‐
42 fies the first active port. (Default is 0.)
43 -X/--infile snapshot_input
49 Generates a report using the data in the snap‐
50 shot_input file. snapshot_input must have been gen‐
51 erated during a previous -o snapshot run. When
52 used, the -s, -i, -C, and -a options are ignored.
53 '-' may be used as the snapshot_input to specify
54 stdin.
55 -T/--topology topology_input
61 Uses topology_input file to augment and verify fab‐
62 ric information. When used, various reports can be
63 augmented with information not available electroni‐
64 cally (such as cable labels). '-' may be used to
65 specify stdin.
66 -i/--interval seconds
72 Obtains performance statistics over interval sec‐
73 onds. Clears all statistics, waits interval sec‐
74 onds, then generates report. Implies -s option.
75 -b / --begin date_time
81 Obtains past performance stats over an interval
82 beginning at date_time. Implies -s option.
83 date_time may be a time entered as HH:MM[:SS] or
84 date as mm/dd/YYYY, dd.mm.YYYY, YYYY-mm-dd or date
85 followed by time; for example, "2016-07-04 14:40".
86 Relative times are taken as "x [sec‐
87 ond|minute|hour|day](s) ago.
88 -e / --end date_time
94 Obtains past performance stats over an interval
95 ending at date_time. Implies -s option.
96 date_time may be a time entered as HH:MM[:SS] or
99 date as mm/dd/YYYY, dd.mm.YYYY, YYYY-mm-dd or date
100 followed by time; for example, "2016-07-04 14:40".
101 Relative times are taken as "x [sec‐
102 ond|minute|hour|day](s) ago.
103 -C/--clear
108 Clears performance statistics for all ports. Only
109 statistics with error thresholds are cleared. A
110 clear occurs after generating the report.
111 -a/--clearall
117 Clears all performance statistics for all ports.
118 -M/--pmadirect
124 Accesses performance statistics using direct PMA.
125 -A/--allports
131 Gets PortInfo for down switch ports. Uses direct
132 SMA to get this data. If used with -M, also gets
133 PMA stats for down switch ports.
134 -F/--focus point
140 Specifies the focus area for report. Used for all
141 reports except route to limit scope of report.
142 Refer to Point Syntax for details.
143
148 -h 0 First active port in system (default).
149 -h 0 -p 0 First active port in system.
152 -h x First active port on HFI x.
155 -h x -p 0 First active port on HFI x.
158 -h 0 -p y Port y within system (no matter which ports are active).
161 -h x -p y HFI x, port y.
164
168 gid:value value is numeric port GID of form: subnet:guid.
169 lid:value value is numeric LID.
172 lid:value:node
175 value is numeric LID, selects entire node with given LID.
176 lid:value:port:value2
179 value is numeric LID of node, value2 is port number.
180 portguid:value
183 value is numeric port GUID.
184 nodeguid:value
187 value is numeric node GUID.
188 nodeguid:value1:port:value2
191 value1 is numeric node GUID, value2 is port number.
192 iocguid:value
195 value is numeric IOC GUID.
196 iocguid:value1:port:value2
199 value1 is numeric IOC GUID, value2 is port number.
200 systemguid:value
203 value is numeric system image GUID.
204 systemguid:value1:port:value2
207 value1 is the numeric system image GUID, value2 is port num‐
208 ber.
209 ioc:value value is IOC Profile ID String (IOC Name).
212 ioc:value1:port:value2
215 value1 is IOC Profile ID String (IOC Name), value2 is port
216 number.
217 iocpat:value
220 value is glob pattern for IOC Profile ID String (IOC Name).
221 iocpat:value1:port:value2
224 value1 is glob pattern for IOC Profile ID String (IOC Name),
225 value2 is port number.
226 ioctype:value
229 value is IOC type (SRP or OTHER).
230 ioctype:value1:port:value2
233 value1 is IOC type (SRP or OTHER); value2 is port number.
234 node:value
237 value is node description (node name).
238 node:value1:port:value2
241 value1 is node description (node name), value2 is port num‐
242 ber.
243 nodepat:value
246 value is glob pattern for node description (node name).
247 nodepat:value1:port:value2
250 value1 is the glob pattern for the node description (node
251 name), value2 is port number.
252 nodedetpat:value
255 value is glob pattern for node details.
256 nodedetpat:value1:port:value2
259 value1 is the glob pattern for the node details, value2 is
260 port number.
261 nodetype:value
264 value is node type (SW, FI, or RT).
265 nodetype:value1:port:value2
268 value1 is node type (SW, FI, or RT), value2 is port number.
269 rate:value
272 value is string for rate (25g, 50g, 75g, 100g), omits switch
273 mgmt port 0.
274 portstate:value
277 value is a string for state (down, init, armed, active,
278 notactive, initarmed).
279 portphysstate:value
282 value is a string for PHYs state (polling, disabled, train‐
283 ing, linkup, recovery, offline, test)
284 mtucap:value
287 value is MTU size (2048, 4096, 8192, 10240), omits switch
288 mgmt port 0.
289 labelpat:value
292 value is glob pattern for cable label.
293 lengthpat:value
296 value is glob pattern for cable length.
297 cabledetpat:value
300 value is glob pattern for cable details.
301 cabinflenpat:value
304 value is glob pattern for cable info length.
305 cabinfvendnamepat:value
308 value is glob pattern for cable info vendor name.
309 cabinfvendpnpat:value
312 value is glob pattern for cable info vendor part number.
313 cabinfvendrevpat:value
316 value is glob pattern for cable info vendor revision.
317 cabinfvendsnpat:value
320 value is glob pattern for cable info vendor serial number.
321 cabinftype:value
324 value is either optical, passive_copper, active_copper, or
325 unknown.
326 linkdetpat:value
329 value is glob pattern for link details.
330 portdetpat:value
333 value is glob pattern for port details.
334 sm Specifies the master subnet manager (SM).
337 smdetpat:value
340 value is glob pattern for SM details.
341 route:point1:point2
344 Specifies all ports along the routes between the two given
345 points.
346 led:value value is either on or off for LED port beacon.
349 linkqual:value
352 Specifies the ports with a link quality equal to value.
353 linkqualLE:value
356 Specifies the ports with a link quality less than or equal to
357 value.
358 linkqualGE:value
361 Specifies the ports with a link quality greater than or equal
362 to value.
363
366 # List all the link errors in the fabric:
367 opaextracterror
368 # List all the link errors related to a switch named "coresw1":
370 opaextracterror -F "node:coresw1"
371 # List all the link errors for end-nodes:
373 opaextracterror -F "nodetype:FI"
374 # List all the link errors on the 2nd HFI's fabric of a multi-plane
376 fabric:
377 opaextracterror -h 2
378Copyright(C) 2015-2018 Intel Corporation opaextracterror(8)