Man page - opaextractlids(8)

Packages contains this manual

Package:  opa-fastfabric
apt-get install opa-fastfabric

Manuals in package:
• opafabricanalysis(8)
• opatop(8)
• opaextractperf2(8)
• opaxmlfilter(8)
• opashowallports(8)
• opaextractsellinks(8)
• opafindgood(8)
• opaextracterror(8)
• opacabletest(8)
• opaesmanalysis(8)
• opaextractbadlinks(8)
• opagentopology(8)
• opareports(8)
• opapingall(8)
• opacaptureall(8)
• opaextractstat(8)
• opaallanalysis(8)
• opaenableports(8)
• opaxmlgenerate(8)
• opaexpandfile(8)
• opagenchassis(8)
• opafirmware(8)
• opasorthosts(8)
• opachassisanalysis(8)
• opareport(8)
• opaswenableall(8)
• opa2rm(8)
• opadisablehosts(8)
• opafmconfigcheck(8)
• opaextractstat2(8)
• opasetupssh(8)
• opalinkanalysis(8)
• opadownloadall(8)
• opauploadall(8)
• opahostsmanalysis(8)
• opaxmlextract(8)
• opaxlattopology(8)
• opaswdisableall(8)
• opaledports(8)
• opacmdall(8)
• opacheckload(8)
• opagenesmchassis(8)
• opamergeperf2(8)
• opascpall(8)
• opaverifyhosts(8)
• opaextractlids(8)
• opafastfabric(8)
• opagenswitches(8)
• opadisableports(8)
• opaextractmissinglinks(8)
• opaxmlindent(8)
• opahostadmin(8)
• opashowmc(8)
• opaextractperf(8)
• opapaquery(8)
• opaextractlink(8)
• opachassisadmin(8)
• opaswitchadmin(8)
• opafmconfigdiff(8)

Manual

opaextractlids

NAME
Syntax
Options
-h and -p options permit a variety of selections:
Point Syntax
Examples

---

NAME

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.

Syntax

opaextractlids [opareport options ]

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 and -p options permit a variety of selections:

-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 .

Point Syntax

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 or FI).

nodetype: value1 :port: value2

value1 is node type (SW or FI), 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 .

nodepatfile: FILENAME

Specifies the name of file with the list of nodepats or node descriptions.

nodepairpatfile: FILENAME

Specifies the name of file with the list of node pairs, separated by a colon.

ldr

Specifies the ports with a non-zero link down reason or neighbor link down reason.

ldr: value

Specifies the ports with a link down reason or neighbor link down reason equal to value .

Examples

# 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

---