opaextractlink

NAME

opaextractlink

Produces a CSV file listing all or some of the links in the fabric. opaextractlink 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

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

-T/--topology topology_input

Uses topology_input file to augment and verify fabric information. When used, various reports can be augmented with information not available electronically (such as cable labels). '-' may be used to specify stdin.

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

Examples

# List all the links in the fabric:

opaextractlink

# List all the links to a switch named "coresw1":

opaextractlink -F "node:coresw1"

# List all the links to end-nodes:

opaextractlink -F "nodetype:FI"

# List all the links on the 2nd HFI's fabric of a multi-plane fabric:

opaextractlink -h 2