DOKK / manpages / debian 12 / opa-fm / opafmcmd.8.en
opafmcmd(8) IFSFFCLIRG (Man Page) opafmcmd(8)

opafmcmd - Execute a command to a specific instance of the OPA Fabric Manager

Executes a command to a specific instance of the Fabric Manager (FM). This command can be used, for example, to query the configuration attributes of a particular instance of an FM as well as issue subnet management commands.

opafmcmd [-i fm_instance] cmd [ args]

Produces full help text.

Specifies the number of the FM instance to act on.

Range is 0 to 7. Default is 0.

Specifies the commands and arguments (if applicable) to be run. Values include:

smForceSweep Makes the Subnet Manager (SM) sweep now.

smRestorePriority Restores the normal priority of the SM, if it is currently elevated.

smShowCounters Gets statistics and performance counters from the SM.

smResetCounters Resets SM statistics and performance counters.

smStateDump Dumps internal SM state into 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.

opafmcmd smForceSweep

opafmcmd -i 2 smLogLevel 3

Intel Corporation Copyright(C) 2015-2019