opadisablehosts(8)

📦 version 10.14.4.0.20, in centos-stream 9, debian bookworm, debian trixie, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 opadisablehosts 💖

okay bestie, so this is opadisablehosts from the IFSFFCLIRG man page — and yes, it does exactly what the name says, no cap. It goes looking for a set of hosts in the fabric and disables their corresponding switch port. Like, sorry girl, your port is done. 💅

Heads up: this one is Linux only, so don't come for me on other platforms.

✨ Syntax ✨

opadisablehosts [-h  hfi] [-p  port]  reason  host ...

🎀 Options 🎀

  • --help — bestie just wants the full help text. Gives you all of it. 🫶
  • -h hfi — picks the HFI, numbered 1..n. If you use 0, that means the -p port is a system-wide port number instead. Default is 0. Periodt.
  • -p port — picks the port, numbered 1..n. If you use 0, it grabs the first active port. Default is 0. Slay.
  • reason — this is the text describing why the hosts are getting disabled. It gets saved in the reason field of the output file. ✍️

Info about the links that got disabled goes into a CSV file. By default that file is named /etc/opa/disabled:hfi:port.csv, where the hfi:port bit of the filename gets swapped out for the HFI number and the port number being operated on — like 1:1 or 2:1. You can feed this CSV file into opaenableports later. The way that this is giving round trip is iconic. 🔥

The list is of the form:

NodeGUID;PortNum;NodeType;NodeDesc;NodeGUID;
PortNum;NodeType;NodeDesc;Reason

For each listed link, the switch port closer to this is the one that has been disabled.

  • host ... — one or more hosts that are affected by the reason. Could be one, could be a whole friend group, who's to say. 👑

🌸 -h and -p combos, explained 🌸

these two options together permit a whole variety of selections, so let's vibe check each one:

  • -h 0 — first active port in system (this is the 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. simple as that, bestie.

🌈 Examples 🌈

opadisablehosts 'bad DRAM' compute001 compute045
opadisablehosts -h 1 -p 2 'crashed' compute001 compute045
🫶 fr fr, double check those -h and -p values before you commit, because once that port is disabled, it's disabled.

mwah, that's the whole page bestie 💖 this one comes from IFSFFCLIRG (Man Page) with the copyright reading Copyright(C) 2015-2019 Intel Corporation — and the version/date vibe is giving 2015-2019. go forth and disable responsibly, queen 👑✨

📦 where this page comes from