Provided by: opa-fm_10.10.3.0.11-1build3_amd64 bug

NAME

       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.

Syntax

       opafmcmd [-i  fm_instance] cmd [ args]

Options

       --help

                 Produces full help text.

       -i fm_instance

                 Specifies the number of the FM instance to act on.

                 Range is 0 to 7. Default is 0.

       cmd [args]

                 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.

Example

       opafmcmd smForceSweep

       opafmcmd -i 2 smLogLevel 3

Copyright(C) 2015-2019                          Intel Corporation                                    opafmcmd(8)