1
2opaextracterror(8)     Master map: IFSFFCLIRG (Man Page)    opaextracterror(8)
3
4
5

NAME

7       opaextracterror
8
9
10
11       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

Syntax

17       opaextracterror [opareport options]
18

Options

20       --help    Produces full help text.
21
22
23       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
28
29
30
31                 -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
36
37
38
39
40                 -p/--port port
41                           Specifies the port, numbered 1..n. Using  0  speci‐
42                           fies the first active port. (Default is 0.)
43
44
45
46
47
48                 -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
56
57
58
59
60                 -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
67
68
69
70
71                 -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
76
77
78
79
80                 -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
89
90
91
92
93                 -e / --end date_time
94                           Obtains past performance  stats  over  an  interval
95                           ending at date_time. Implies -s option.
96
97
98                           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
104
105
106
107                 -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
112
113
114
115
116                 -a/--clearall
117                           Clears all performance statistics for all ports.
118
119
120
121
122
123                 -M/--pmadirect
124                           Accesses performance statistics using direct PMA.
125
126
127
128
129
130                 -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
135
136
137
138
139                 -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
144
145
146

-h and -p options permit a variety of selections:

148       -h 0      First active port in system (default).
149
150
151       -h 0 -p 0 First active port in system.
152
153
154       -h x      First active port on HFI x.
155
156
157       -h x -p 0 First active port on HFI x.
158
159
160       -h 0 -p y Port y within system (no matter which ports are active).
161
162
163       -h x -p y HFI x, port y.
164
165
166

Point Syntax

168       gid:value value is numeric port GID of form: subnet:guid.
169
170
171       lid:value value is numeric LID.
172
173
174       lid:value:node
175                 value is numeric LID, selects entire node with given LID.
176
177
178       lid:value:port:value2
179                 value is numeric LID of node, value2 is port number.
180
181
182       portguid:value
183                 value is numeric port GUID.
184
185
186       nodeguid:value
187                 value is numeric node GUID.
188
189
190       nodeguid:value1:port:value2
191                 value1 is numeric node GUID, value2 is port number.
192
193
194       iocguid:value
195                 value is numeric IOC GUID.
196
197
198       iocguid:value1:port:value2
199                 value1 is numeric IOC GUID, value2 is port number.
200
201
202       systemguid:value
203                 value is numeric system image GUID.
204
205
206       systemguid:value1:port:value2
207                 value1  is the numeric system image GUID, value2 is port num‐
208                 ber.
209
210
211       ioc:value value is IOC Profile ID String (IOC Name).
212
213
214       ioc:value1:port:value2
215                 value1 is IOC Profile ID String (IOC Name),  value2  is  port
216                 number.
217
218
219       iocpat:value
220                 value is glob pattern for IOC Profile ID String (IOC Name).
221
222
223       iocpat:value1:port:value2
224                 value1  is glob pattern for IOC Profile ID String (IOC Name),
225                 value2 is port number.
226
227
228       ioctype:value
229                 value is IOC type (SRP or OTHER).
230
231
232       ioctype:value1:port:value2
233                 value1 is IOC type (SRP or OTHER); value2 is port number.
234
235
236       node:value
237                 value is node description (node name).
238
239
240       node:value1:port:value2
241                 value1 is node description (node name), value2 is  port  num‐
242                 ber.
243
244
245       nodepat:value
246                 value is glob pattern for node description (node name).
247
248
249       nodepat:value1:port:value2
250                 value1  is  the  glob  pattern for the node description (node
251                 name), value2 is port number.
252
253
254       nodedetpat:value
255                 value is glob pattern for node details.
256
257
258       nodedetpat:value1:port:value2
259                 value1 is the glob pattern for the node  details,  value2  is
260                 port number.
261
262
263       nodetype:value
264                 value is node type (SW, FI, or RT).
265
266
267       nodetype:value1:port:value2
268                 value1 is node type (SW, FI, or RT), value2 is port number.
269
270
271       rate:value
272                 value  is string for rate (25g, 50g, 75g, 100g), omits switch
273                 mgmt port 0.
274
275
276       portstate:value
277                 value is a string  for  state  (down,  init,  armed,  active,
278                 notactive, initarmed).
279
280
281       portphysstate:value
282                 value  is  a string for PHYs state (polling, disabled, train‐
283                 ing, linkup, recovery, offline, test)
284
285
286       mtucap:value
287                 value is MTU size (2048, 4096,  8192,  10240),  omits  switch
288                 mgmt port 0.
289
290
291       labelpat:value
292                 value is glob pattern for cable label.
293
294
295       lengthpat:value
296                 value is glob pattern for cable length.
297
298
299       cabledetpat:value
300                 value is glob pattern for cable details.
301
302
303       cabinflenpat:value
304                 value is glob pattern for cable info length.
305
306
307       cabinfvendnamepat:value
308                 value is glob pattern for cable info vendor name.
309
310
311       cabinfvendpnpat:value
312                 value is glob pattern for cable info vendor part number.
313
314
315       cabinfvendrevpat:value
316                 value is glob pattern for cable info vendor revision.
317
318
319       cabinfvendsnpat:value
320                 value is glob pattern for cable info vendor serial number.
321
322
323       cabinftype:value
324                 value  is  either  optical, passive_copper, active_copper, or
325                 unknown.
326
327
328       linkdetpat:value
329                 value is glob pattern for link details.
330
331
332       portdetpat:value
333                 value is glob pattern for port details.
334
335
336       sm        Specifies the master subnet manager (SM).
337
338
339       smdetpat:value
340                 value is glob pattern for SM details.
341
342
343       route:point1:point2
344                 Specifies all ports along the routes between  the  two  given
345                 points.
346
347
348       led:value value is either on or off for LED port beacon.
349
350
351       linkqual:value
352                 Specifies the ports with a link quality equal to value.
353
354
355       linkqualLE:value
356                 Specifies the ports with a link quality less than or equal to
357                 value.
358
359
360       linkqualGE:value
361                 Specifies the ports with a link quality greater than or equal
362                 to value.
363
364

Examples

366       # List all the link errors in the fabric:
367       opaextracterror
368
369       # List all the link errors related to a switch named "coresw1":
370       opaextracterror -F "node:coresw1"
371
372       # List all the link errors for end-nodes:
373       opaextracterror -F "nodetype:FI"
374
375       #  List  all  the  link errors on the 2nd HFI's fabric of a multi-plane
376       fabric:
377       opaextracterror -h 2
378
379
380
381Copyright(C) 2015-2018         Intel Corporation            opaextracterror(8)
Impressum