opaportconfig(1)

✨ opaportconfig ✨

okay so bestie, welcome to opaportconfig from the IFSFFCLIRG manual 💖 this one's a Host or Switch tool and it controls the configuration and state of a specified Intel(R) Omni-Path Host Fabric Interface (HFI) port — either on the local host or on a remote switch 🌸

NOTE: bestie this tool is designed for expert users only 💅 non-expert users should use other tools such as opaenableports, opadisableports and opaportinfo for basic functionality. no gatekeeping, just saying iykyk 🫶

🎀 Syntax 🎀

opaportconfig [-l  lid [-m  dest_port]] [-h  hfi] [-p  port] [-r  secs]
[-z]

[-S  state] [-P  physstate] [-s  speed] [-w  width] [-c  LTPCRC] [-v]
[-x]
[-L  lid] [< sub command>]

💅 Options 💅

• --help — produces full help text. literally the whole thing, go off 👑
• -l lid — specifies the destination LID. default is local port 🦋
• -m dest_port — specifies the destination port. default is port with given LID. used to access switch ports 🔥
• -h hfi — specifies the HFI to send through/to. default is first HFI ✨
• -p port — specifies the port to send through/to. default is first port 🌸
• sub command — specifies one of the following choices 👇
  • enable — enables port 🫶
  • disable — disables port 🙈
  • bounce — bounces port 😭

NOTE: bouncing remote ports may cause timeouts. not a vibe, be careful 💀

• ledon — turns port LED on ⭐
• ledoff — turns port LED off 🌈

⚙️ Configuration Options ⚙️

• -r secs — repeats to keep the port down for the specified amount of seconds ⏳
• -S state — specifies the new state. default is 0 💜
  • 0 — No-op.
  • 1 — Down.
  • 2 — Initiate.
  • 3 — Armed.
  • 4 — Active.
• -P physstate — specifies the new physical state. default is 0 🦋

NOTE: all transitions are valid. periodt ✨

• 0 — No-op.
• 2 — Polling.
• 3 — Disabled.
• 11 — Phy-Test. Current physstate must be disabled.

• -s speed — specifies the new link speeds enabled. default is 0. to enable multiple speeds, use the sum of the desired speeds 🔥
  • 0 — No-op.
  • 2 — 0x0002 - 25 Gb/s.
• -w width — specifies the new link widths enabled. default is 0. to enable multiple widths, use sum of desired widths 🌸
  • 0 — No-op.
  • 1 — 0x01 - 1x.
  • 2 — 0x02 - 2x.
  • 4 — 0x04 - 3x.
  • 8 — 0x08 - 4x.
• -c LTPCRC — specifies the new LTP CRCs enabled. default is 0. to enable multiple LTP CRCs, use sum of desired LTP CRCs 💖
  • 0 — No-op.
  • 1 — 0x1 - 14-bit LTP CRC mode.
  • 2 — 0x2 - 16-bit LTP CRC mode.
  • 4 — 0x4 - 48-bit LTP CRC mode.
  • 8 — 0x8 - 12/16 bits per lane LTP CRC mode.

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

🔍 Debug Options 🔍

• -v — verbose output. additional invocations turn on debugging, openib debugging, and libibumad debugging 🐛
• -z — does not get port information first; clears most port attributes 💀
• -L lid — sets PortInfo.LID = lid. 🎀

🌟 Examples 🌟

opaportconfig -w 1

opaportconfig -p 1 -h 2 -w 3

📖 Description 📖

Port configuration is transient in nature bestie 😭 if the given host is rebooted or its Intel(R) Omni-Path Fabric Stack is restarted, the port reverts to its default configuration and state. typically, the default state is to have the port enabled with all speeds and widths supported by the given HFI port 🦋

To access switch ports using this command, the -l and -m options must be given 💅 the -l option specifies the lid of switch port 0 (the logical management port for the switch) and -m specifies the actual switch port to access 🔥

NOTE: the /etc/init.d/opaportconfig script is provided as an example of changing port speed every time the server boots. this script can be edited, then scheduled, using chkconfig to control link settings on any set of HFI ports 🎀

CAUTION: when using this command to disable or reconfigure switch ports, if the final port in the path between the Fabric Management Node and the switch is disabled or fails to come online, then opaenableports is not able to reenable it 😭 in this case, the switch CLI and/or a switch reboot may be needed to correct the situation. be so careful fr fr 💀

and that's the whole page bestie 🫶 this gem is copyright Copyright(C) 2015-2019 Intel Corporation, and it lives in the IFSFFCLIRG (Man Page) manual 💖 slay, go configure some ports responsibly ✨👑💅