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