opafmcmd(8)

🌸 NAME 🌸

opafmcmd — from IFSFFCLIRG (Man Page), hi bestie 💖

This one runs a command against a specific instance of the Fabric Manager (FM). It’s lowkey iconic for stuff like querying the configuration attributes of one particular FM instance, or firing off subnet management commands. No cap. ✨

---

✨ Syntax ✨

opafmcmd [-i  fm_instance] cmd [ args]

---

💅 Options 💅

• --help — drops the full help text, periodt.
• -i fm_instance — picks the number of the FM instance to act on. Range is 0 to 7. Default is 0. 🎀
• cmd [args] — the command and arguments (if applicable) to run. Values include:
  • smForceSweep — makes the Subnet Manager (SM) sweep right now. 💨
  • smRestorePriority — restores the normal priority of the SM, if it’s currently elevated.
  • smShowCounters — gets statistics and performance counters from the SM.
  • smResetCounters — resets SM statistics and performance counters.
  • smStateDump — dumps internal SM state into the specified directory.
  • smLogLevel — sets the SM logging level. Values include:
    • 0=NONE+
    • 1=WARN+
    • 2=NOTICE+
    • 3=INFO+
    • 4=VERBOSE+
    • 5=DEBUG2+
    • 6=DEBUG4+
    • 7=TRACE+
  • smLogMode — sets the SM log mode flags. Values include:
    • 0/1 1=downgrade non-actionable
    • 0/2 2=logfile only
  • smLogMask — sets the SM log mask for a specific subsystem to the value given. For a list of subsystems and mask bit meanings, see the files /etc/opa-fm/opafm.xml or /usr/share/opa-fm/opafm.xml.
  • smPerfDebug — toggles performance debug output for SM.
  • saPerfDebug — toggles performance debug output for Subnet Administration (SA).
  • saRmppDebug — toggles Reliable Message Passing Protocol (RMPP) debug output for SA.
  • pmShowCounters — gets statistics and performance counters for the Performance Manager (PM).
  • pmResetCounters — resets statistics and performance counters for the PM.
  • pmDebug — toggles debug output for PM.
  • pmRmppDebug — toggles RMPP debug output for PM.
  • feLogLevel — sets the Fabric Executive (FE) logging level. Values include:
    • 0=NONE+
    • 1=WARN+
    • 2=NOTICE+
    • 3=INFO+
    • 4=VERBOSE+
    • 5=DEBUG2+
    • 6=DEBUG4+
    • 7=TRACE+
  • feLogMode — sets the FE log mode flags.
    • 0/1 1=downgrade non-actionable
    • 0/2 2=logfile only
  • feLogMask — sets the FE log mask for a specific subsystem to the value given. For a list of subsystems and mask bit meanings, see the files /etc/opa-fm/opafm.xml or /usr/share/opa-fm/opafm.xml.
  • feDebug — toggles debug output for FE.
  • feRmppDebug — toggles RMPP debug output for FE.
  • smLooptestStart — starts loop test in normal mode. Specify the number of 256 byte packets. Default is 0.
  • smLooptestFastModeStart — starts loop test in fast mode. Specify the number of 256 byte packets. Default is 5.
  • smLooptestStop — stops loop test. Returns switch LFTs back to normal.
  • smLooptestInjectPackets — enter numPkts to send to all switch loops. Default is 1.
  • smLooptestInjectAtNode — enter the switch node index to inject loop packets. Default is 0.
  • smLooptestInjectEachSweep — sets whether to inject or stop injecting packets each sweep.
    • Enter 1 to inject packets each sweep.
    • Enter 0 to stop injecting each sweep.
  • smLooptestPathLength — sets the loop path length. Range is 2 - 4. Default is 3.
  • smLooptestMinISLRedundancy — sets the minimum number of loops in which to include each ISL. Default is 4.
  • smLooptestShowLoopPaths — displays the loop paths given node index or all loop paths. Default is all.
  • smLooptestShowSwitchLft — displays a switch LFT given node index or all switches LFTs. Default is all.
  • smLooptestShowTopology — displays the topology for the SM Loop Test.
  • smLooptestShowConfig — displays the current active loop configuration.
  • smForceRebalance — toggles Force Rebalance setting for SM.
  • smAdaptiveRouting — displays or modifies Adaptive Routing setting for SM.
    • If no arguments are entered, displays current setting.
    • Enter 0 to Disable.
    • Enter 1 to Enable.
    • Additional arguments after the first argument can be used to update frequency and threshold while enabling Adaptive Routing:
      • Enter -f value to update frequency. Valid values are 0 - 7.
      • Enter -t value to update threshold. Valid values are 0 - 7.
      • If frequency or threshold are not provided, they will be reset to default.
  • smForceAttributeRewrite — sets rewriting of all attributes upon resweeping.
    • Enter 0 to Disable.
    • Enter 1 to Enable.
  • smSkipAttrWrite — specifies the bitmask of attributes to be skipped (not written) during sweeps. Enter -help for list of options.
  • smPauseSweeps — pauses SM sweeps. ⏸️
  • smResumeSweeps — resumes SM sweeps. ▶️

---

🎀 Example 🎀

opafmcmd smForceSweep

opafmcmd -i 2 smLogLevel 3

---

💖 mwah! that’s the whole opafmcmd(8) page from the IFSFFCLIRG (Man Page) era, with Copyright(C) 2015-2019 Intel Corporation — go slay your FM, bestie! 🎀✨