opaextractlink(8)

💖 NAME 💖

okay so bestie, meet opaextractlink 💅 this is the opaextractlink(8) page from the IFSFFCLIRG man page and it's genuinely so useful.

It produces a CSV file listing all or some of the links in the fabric. And the way it does that? 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. spreadsheet girlies and script girlies both ate with this one 🍓

🌸 Syntax 🌸

opaextractlink [opareport  options]

✨ Options ✨

• --help — produces full help text. the classic "what do u even do" button 🫶
• opareport options — the following options are passed to opareport. This subset is considered typical and useful for this command. By design, the tool ignores the -o/--output report option — like, it said "not today" 🙈
  • -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

and that's the whole vibe, bestie 🦋 no cap, you're now officially an opaextractlink girlie. this one comes to you from the IFSFFCLIRG (Man Page) era, with Copyright(C) 2015-2019 Intel Corporation holding it down — periodt. 💜