opaextractlids
Produces a CSV file listing all or some of the LIDs in the fabric.
opaextractlids is a front end to the opareport tool. The output from this
tool can be imported into a spreadsheet or parsed by other scripts.
opaextractlids [opareport options]
- --help
- Produces full help text.
- opareport
options
- The following options are passed to opareport. This subset is considered
typical and useful for this command. By design, the tool ignores
-o/--output report option.
-h/--hfi hfi Specifies the HFI, numbered 1..n. Using 0
specifies that the -p port port is a system-wide port number. Default
is 0.
-p/--port port Specifies the port, numbered 1..n. Using 0
specifies the first active port. Default is 0.
-X/--infile snapshot_input Generates a report using the
data in the snapshot_input file. snapshot_input must have been generated
during a previous -o snapshot run. When used, the -s, -i, -C, and -a
options are ignored. '-' may be used as the snapshot_input to specify
stdin.
-F/--focus point Specifies the focus area for report. Used
for all reports except route to limit scope of report. Refer to Point
Syntax for details.
- -h 0
- First active port in system (Default).
- -h 0 -p 0
- First active port in system.
- -h x
- First active port on HFI x.
- -h x -p 0
- First active port on HFI x.
- -h 0 -p y
- Port y within system (no matter which ports are active).
- -h x -p
y
- HFI x, port y.
- gid:value
- value is numeric port GID of form: subnet:guid.
- lid:value
- value is numeric LID.
- lid:value:node
- value is numeric LID, selects entire node with given LID.
- lid:value:port:value2
- value is numeric LID of node, value2 is port number.
- portguid:value
- value is numeric port GUID.
- nodeguid:value
- value is numeric node GUID.
- nodeguid:value1:port:value2
- value1 is numeric node GUID, value2 is port number.
- iocguid:value
- value is numeric IOC GUID.
- iocguid:value1:port:value2
- value1 is numeric IOC GUID, value2 is port number.
- systemguid:value
- value is numeric system image GUID.
- systemguid:value1:port:value2
- value1 is the numeric system image GUID, value2 is port
number.
- ioc:value
- value is IOC Profile ID String (IOC Name).
- ioc:value1:port:value2
- value1 is IOC Profile ID String (IOC Name), value2 is port
number.
- iocpat:value
- value is glob pattern for IOC Profile ID String (IOC Name).
- iocpat:value1:port:value2
- value1 is glob pattern for IOC Profile ID String (IOC Name),
value2 is port number.
- ioctype:value
- value is IOC type (SRP or OTHER).
- ioctype:value1:port:value2
- value1 is IOC type (SRP or OTHER); value2 is port number.
- node:value
- value is node description (node name).
- node:value1:port:value2
- value1 is node description (node name), value2 is port
number.
- nodepat:value
- value is glob pattern for node description (node name).
- nodepat:value1:port:value2
- value1 is the glob pattern for the node description (node name),
value2 is port number.
- nodedetpat:value
- value is glob pattern for node details.
- nodedetpat:value1:port:value2
- value1 is the glob pattern for the node details, value2 is
port number.
- nodetype:value
- value is node type (SW, FI, or RT).
- nodetype:value1:port:value2
- value1 is node type (SW, FI, or RT), value2 is port number.
- rate:value
- value is string for rate (25g, 50g, 75g, 100g), omits switch mgmt
port 0.
- portstate:value
- value is a string for state (down, init, armed, active, notactive,
initarmed).
- portphysstate:value
- value is a string for PHYs state (polling, disabled, training,
linkup, recovery, offline, test)
- mtucap:value
- value is MTU size (2048, 4096, 8192, 10240), omits switch mgmt port
0.
- labelpat:value
- value is glob pattern for cable label.
- lengthpat:value
- value is glob pattern for cable length.
- cabledetpat:value
- value is glob pattern for cable details.
- cabinflenpat:value
- value is glob pattern for cable info length.
- cabinfvendnamepat:value
- value is glob pattern for cable info vendor name.
- cabinfvendpnpat:value
- value is glob pattern for cable info vendor part number.
- cabinfvendrevpat:value
- value is glob pattern for cable info vendor revision.
- cabinfvendsnpat:value
- value is glob pattern for cable info vendor serial number.
- cabinftype:value
- value is either optical, passive_copper, active_copper, or unknown.
- linkdetpat:value
- value is glob pattern for link details.
- portdetpat:value
- value is glob pattern for port details.
- sm
- Specifies the master subnet manager (SM).
- smdetpat:value
- value is glob pattern for SM details.
- route:point1:point2
- Specifies all ports along the routes between the two given points.
- led:value
- value is either on or off for LED port beacon.
- linkqual:value
- Specifies the ports with a link quality equal to value.
- linkqualLE:value
- Specifies the ports with a link quality less than or equal to
value.
- linkqualGE:value
- Specifies the ports with a link quality greater than or equal to
value.
# List all the lids in the fabric:
opaextractlids
# List all the lids of end-nodes:
opaextractlids -F "nodetype:FI"
# List all the lids on the 2nd HFI's fabric of a multi-plane
fabric:
opaextractlids -h 2