SM Commands

ib sm

no ib sm

Enables the SM on this node.

The no form of the command disables the SM on this node.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm

Related Commands

show ib sm

Notes

ib sm accum-log-file

no ib sm accum-log-file

Adds SM log entries at the end of the current log.

The no form of the command overwrites SM log file on every restart.

Syntax Description

N/A

Default

Enabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm accum-log-file

Related Commands

show ib sm accum-log-file

Notes

ib sm allow-both-pkeys

no ib sm allow-both-pkeys

Enables having both full and limited membership on the same partition.

The no form of the command disables having both full and limited membership on the same partition.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.4.1100

Example

switch (config) # ib sm allow-both-pkeys

Related Commands

defmember

member

Notes

ib sm babbling-policy

no ib sm babbling-policy

Enables the SM to disable babbling ports (i.e., generating frequent traps).

The no form of the command disables the SM babbling policy.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # no ib sm babbling-policy

Related Commands

show ib sm babbling-policy

Notes

If the babbling policy is enabled, and decides to close a babbling interface (one which sends 129,130,131 traps, for example), the SM disables the port.

ib sm connect-roots

no ib sm connect-roots

Forces the routing engine to make connectivity between root switches.

The no form of the command disables logical LID path between root switches.

Syntax Description

N/A

Default

Enabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm connect-roots

Related Commands

show ib sm connect-roots

Notes

• This command is relevant only for ‘updn’ and ‘ftree’ algorithm (refer to ‘ib sm routing-engines’ command)

• This option enforces routing engines (up/down and fat-tree) to make connectivity between root switches and in this way to be fully IBA complaint. This may violate the “deadlock-free” status of the algorithm. Hence, it is recommended to use the command carefully.

ib sm calculate-missing-routes

no ib sm calculate-missing-routes

Enables SM to find and recalculate missing routes without creating credit-loops

The no form of the command d isables SM to find and recalculate missing routes without creating credit-loops

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.8.2000

Example

switch (config) # ib sm calculate-missing-routes 
switch (config) # show ib sm calculate-missing-routes

ib sm calculate-missing-routes: enabled

switch (config) # no ib sm calculate-missing-routes
switch (config) # show ib sm calculate-missing-routes

ib sm calculate-missing-routes: disabled

Related Commands

Show ib sm calculate-missing-routes

Notes

ib sm drop-event-subscriptions

no ib sm drop-event-subscriptions

Configures IB SM to drop interface subscribe or unsubscribe events.

The no form of the command resets this parameter to its default value.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.4.2008

Example

switch (config) # ib sm drop-event-subscriptions

Related Commands

Notes

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm enable-quirks

Related Commands

show ib sm enable-quirks

Notes

ib sm exit-on-fatal

no ib sm exit-on-fatal

Enables the SM to exit upon fatal initialization errors.

The no form of the command disables the SM from exiting upon fatal initialization errors.

Syntax Description

N/A

Default

Enabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm exit-on-fatal

Related Commands

show ib sm exit-on-fatal

Notes

ib sm force-link-speed <speed-options>

no ib sm force-link-speed

Defines the SM behavior for PortInfo:LinkSpeedEnabled, PortInfo:LinkSpeedExtEnabled and MLNX ExtendedPortInfo on the switch ports.

The no form of the command resets this parameter to its default.

Syntax Description

speed-options

The following options are available:

• sdr—10.0 Gb/s rate on 4 lane width

• ddr—20.0 Gb/s rate on 4 lane width

• qdr—40.0 Gb/s rate on 4 lane width

• fdr10—40.0 Gb/s rate on 4 lane width

• fdr—56.0 Gb/s rate on 4 lane width

• edr—100.0 Gb/s rate on 4 lane width

Default

Set to PortInfo:LinkSpeedExtSupported

Configuration Mode

config

History

3.1.0000

3.4.1604

Updated Syntax Description, Example, and Notes

Example

switch (config) # ib sm force-link-speed sdr ddr qdr fdr10

Related Commands

show ib sm force-link-speed

show ib sm force-link-speed-ext

show ib sm fdr10

Notes

• The following options, as defined in InfiniBand Specification 1.2.1 section 14.2.5.6, table 145 “PortInfo”

• This command updates force-link-speed, force-link-speed ext and fdr10 which are open sm parameters

• This command is backwards compatible so old configuration file containing this command with the old form (with legal bit mask) are still supported

• If the speed-options list does not include SDR speed, it is configured automatically

• Configuring more than one speed is possible by typing in consecutive speed names separated by spaces

ib sm force-log-flush

no ib sm force-log-flush

Forces every log message generated to be flushed.

The no form of the command does not force a flush after every log write.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm force-log-flush

Related Commands

show ib sm force-log-flush

Notes

ib sm guid2lid-cache

no ib sm guid2lid-cache

Allows SM to use cached GUID-to-lid mapping data. When enabled, the SM honors the cached GUID-to-lid mapping information if:

• It exists

• It is valid

• sm_reassign_lids is disabled

The no form of the command disallows use of cached GUID-to-lid mapping data.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm guid2lid-cache

Related Commands

show ib sm guid2lid-cache

Notes

ib sm honor-partitions

no ib sm honor-partitions

Sets the no_partition_enforcement flag to 0. This setting controls global support for partitioning in the subnet.

The no form of the command disables subnet partition support.

Syntax Description

N/A

Default

Enabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # no ib sm honor-partitions

Related Commands

show ib sm honor-partitions

Notes

• If partitioning is disabled (no_partition_enforcement=1), then no named partitions can be enabled

• If partitioning is enabled globally, the no_partition_enforcement changes from 1 to 0, and all defined partitions with state enabled are instantiated

• If partitioning is globally disabled, all partitions are removed from the subnet, but the state (enabled or disabled) associated with defined partitions is not modified

ib sm hoq-lifetime <time>

Sets the maximum time a frame can wait at the head of a switch-to-switch port queue before it is dropped.

Syntax Description

time

The time is 4.096 uS * 2time. The range of time is 0 to 20. A time of 20 means infinite, and the default value is 18 which translates to about 1 second.

Default

0x12 (~ 1 second)

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm hoq-lifetime 15

Related Commands

show ib sm hoq-lifetime

Notes

ib sm ignore-other-sm

no ib sm ignore-other-sm

Ignores all the rules governing SM elections and attempts to manage the fabric.

The no form of the command does not allow the SM to manage fabric if it loses the election.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm ignore-other-sm

Related Commands

show ib sm ignore-other-sm

Notes

ib sm ipv6-nsm

no ib sm ipv6-nsm

Consolidates IPv6 SNM group joins to 1 MC group per-MGID PKEY.

The no form of the command disables the consolidation of IPv6 SNM.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm ipv6-nsm

Related Commands

show ib sm ipv6-nsm

Notes

ib sm lash {do-mesh-analysis | start-vl <vl-value>}

no ib sm lash do-mesh-analysis

Modifies “lash” routing method parameters.

The no form of the command disables SM “lash” routing for mesh analysis.

Syntax Description

do-mesh-analysis

Enables SM “lash” routing for mesh analysis

start-vl <vl-value>

Configures the starting VL for SM “lash” routing for mesh analysis (assuming that lash routing is enabled)

Default

do-mesh-analysis: Disabled

start-vl: 0

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm lash do-mesh-analysis

Related Commands

show ib sm lash do-mesh-analysis

Notes

ib sm leafhoq-lifetime <time>

Sets the maximum time a frame can wait at the head of a switch-to-CA_or_Router port queue before it is dropped.

Syntax Description

time

The time is 4.096 uS * 2time. The range of time is 0 to 20. A time of 20 means infinite, and the default value is 16 which translates to about 268 millisecond.

Default

0x10 (about 268 mS)

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm leafhoq-lifetime 8

Related Commands

show ib sm leafhoq-lifetime

Notes

ib sm leafvl-stalls <count>

Sets the number of sequential frame drops that cause a switch-to-CA_or_Router port to enter the VLStalled state.

Syntax Description

count

Range: 1-255

Default

7

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm leafvl-stalls 3

Related Commands

show ib sm leafvl-stalls

Notes

ib sm lmc <mask>

Sets the LID Mask Control (LMC) value to be used on this subnet.

Syntax Description

mask

Range: 0-7

Default

The default value is 0, which means that every port has exactly one unique LID.

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm lmc 7

Related Commands

show ib sm lmc

Notes

ib sm lmc-esp0

no ib sm lmc-esp0

Sets the LMC for the subnet to be used for Enhanced Switch Port 0.

The no form of the command resets this parameter to its default.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm lmc-esp0

Related Commands

show ib sm lmc-esp0

Notes

ib sm log-flags [all] [debug] [error] [frames] [funcs] [info] [none] [routing] [verbose]

no ib sm log-flags

Controls what messages the SM logs.

The no form of the command indicates to the SM not to run on this node.

Syntax Description

all

Turns on all the flags that follow (error info verbose debug funcs frames routing).

debug

Logs diagnostic messages, high volume.

error

Logs error messages.

frames

Logs all SMP and GMP frames.

funcs

Logs function entry/exit, very high volume.

info

Logs basic messages, low volume.

none

Turns off all logging flags.

routing

Logs FDB routing information.

verbose

Logs interesting stuff, moderate volume.

Default

0x3 (error, info)

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm log-flags error verbose funcs frames

Related Commands

show ib sm log-flags

Notes

• Every execution of this command replaces the current logging flags

• The options “all” and “none” must be specified as the only parameter

ib sm log-max-size <size>

Sets the maximum size of the log file to be <size> megabytes.

Syntax Description

size

Range: 1-60

Default

20 MBytes

Configuration Mode

config

History

3.1.0000

3.5.1000

Updated Syntax Description, and Default

Example

switch (config) # ib sm log-max-size 50

Related Commands

show ib sm log-max-size

Notes

• The log file “opensm_<switch_name>.log” is rotated when it exceeds the configured maximum file size up to 5 compressed files

• When the log gets to the maximum size, or system storage fills up, the current log is deleted and messages start accumulating

• To successfully upgrade from a version prior to 3.5.1000, this parameter must be set to a value in the range specified in the syntax descriptio

ib sm max-op-vls <count>

Sets the maximum number of VLs supported on this subnet.

Syntax Description

count

Possible values: 1, 2, 4, 8, or 15

Default

4

Configuration Mode

config

History

3.1.0000

3.10.1000

Updated default value from 15 to 4

Example

switch (config) # ib sm max-op-vls 4

Related Commands

show ib sm max-op-vls

Notes

ib sm max-reply-time <time>

Sets the maximum time the SM waits for a reply before the transaction times out.

Syntax Description

time

Must be an integer (in milliseconds)

Default

200 milliseconds

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm max-reply-time 500

Related Commands

show sm max-reply-time

Notes

ib sm max-reverse-hops <max-reverse-hops>

Sets the maximum number of hops from the top switch to an I/O node.

Syntax Description

N/A

Default

0 hops

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm max-reverse-hops 500

Related Commands

show ib sm max-reverse-hops

Notes

ib sm aguid-default-hop-limit <count>

no ib sm aguid-default-hop-limit

Configures the default value for hop limit returned in path records where either the source or destination are alias an GUID.

The no form of the command resets the count to its default value.

Syntax Description

count

Number of concurrent management packets (must be an integer)

Default

1

Configuration Mode

config

History

3.6.6102

Example

switch (config) # ib sm aguid-default-hop-limit 3

Related Commands

show ib sm aguid-default-hop-limit

Notes

ib sm max-wire-smps2 <count>

no

Sets the maximal timeout based outstanding SM management packets.

The no form of the command resets the max-wire-smps2 to its initial value.

Syntax Description

count

Number of concurrent management packets. The value must be an integer.

Default

4

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm max-wire-smps 8

Related Commands

show ib sm max-wire-smps2

Notes

ib sm m-key <mkey>

no ib sm m-key

Configures the MKey used by the SM.

The no form of the command resets the MKey configuration to its default value.

Syntax Description

mkey

64-bit MKey

Default

00:00:00:00:00:00:00:00

Configuration Mode

config

History

3.1.0000

3.6.2002

Added no form of the command

3.7.0000

Added note

Example

switch (config) # ib sm m-key 11:33:55:77:99:aa:cc:ee

Related Commands

ib sm mkey-lease

ib sm mkey-lookup

ib sm mkey-protect-level

show ib sm m-key

show ib sm mkey-lease

Notes

• All nodes in the subnet may have to be reset or power-cycled after altering the SM MKey configuration

• Fabric inspector, and many standalone InfiniBand utilities, may not function on subnets with a non-default MKey.

ib sm mkey-lease <time>

no ib sm mkey-lease

Configures the lease period used when MKey is non-zero.

The no form of the command resets this value to its default.

Syntax Description

time

MKey lease period in seconds

Range: 0-65535; 0=unlimited

Default

0

Configuration Mode

config

History

3.6.2002

Example

switch (config) # ib sm mkey-lease 660

Related Commands

show ib sm mkey-lease

Notes

ib sm mkey-lookup

no ib sm mkey-lookup

Enables using a file cache (guid2mkey) to resolve unknown node MKey.

The no form of the command disables using a file cache to resolve unknown node MKey and the configured MKey is used for all ports.

Syntax Description

N/A

Default

Enabled

Configuration Mode

config

History

3.6.2002

Example

switch (config) # ib sm mkey-lookup

Related Commands

show ib sm mkey-lookup

Notes

MKey lookup is a boolean value that controls how the SM finds the MKey of ports

ib sm mkey-protect-level <level>

no ib sm mkey-protect-level

Controls what data is returned to a get_PortInfo MAD request when the MKey in the request does not match the MKey on the port.

The no form of the command resets the parameter to its default value.

Syntax Description

level

• 0—when PortInfo is “read”, the actual MKey is returned in port info data

• 1—when PortInfo is “read”, and the MKey in the MAD does not match the MKey on the port, the MKey value in the returned PortInfo data is set to 0

• 2—when PortInfo is “read”, and the MKey in the MAD does not match the MKey on the port, no data is returned

Default

0

Configuration Mode

config

History

3.6.2002

Example

switch (config) # ib sm mkey-protect-level 0

Related Commands

show ib sm mkey-protect-level

Notes

ib sm msgfifo-timeout <time>

Sets the time value to be used by the subnet administrator to control when a BUSY status is returned to a client.

Syntax Description

time

In milliseconds

Default

10 seconds

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm msgfifo-timeout 50000

Related Commands

show ib sm msgfifo-timeout

Notes

If there is more than one message in the SA queue, and it has been there longer than time milliseconds, all additional incoming requests are immediately replied to with BUSY status.

ib sm multicast

no ib sm multicast

Enables the SM to support multicasts on the fabric.

The no form of the command disables the SM from supporting multicasts on the fabric.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm multicast

Related Commands

show ib sm multicast

Notes

ib sm no-client-rereg

no ib sm no-client-rereg

Enables client re-registration requests.

The no form of the command disables client re-registration requests.

Syntax Description

N/A

Default

disable

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm no-client-rereg

Related Commands

show ib sm no-client-rereg

Notes

ib sm overrun-trigger <count>

Enables SMA to generate standard InfiniBand trap number 130 when the number of local buffer overrun errors equals the count value, and the port’s SMA supports traps.

Syntax Description

count

Range: 0-255

Default

8

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm overrun-trigger 3

Related Commands

show ib sm overrun-trigger

Notes

Refer to the InfiniBand Architecture Specification V1 r1.2.1, section 14.2.5.1 table 131: Traps.

ib sm packet-life-time <time>

Sets the maximum time a frame can live in a switch.

Syntax Description

time

The time is 4.096 uS * 2*<time>. Range: 0-20. A time of 20 means infinite. The value 0x14 disables this mechanism.

Default

0x12 (about 1 second)

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm packet-life-time 20

Related Commands

show ib sm packet-life-time

Notes

ib sm phy-err-trigger <count>

Enables SMA to generate trap 129 when the number of local link integrity errors equals the <count> value, and the port’s SMA supports traps.

Syntax Description

count

Range: 0-255

Default

8

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm phy-err-trigger 5

Related Commands

show ib sm phy-err-trigger

Notes

ib sm polling-retries <value>

This variable defines the number of consecutive times an active SM must fail to respond before it is declared dead.

Syntax Description

value

Must be an integer

Default

4

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm polling-retries 8

Related Commands

show ib sm polling-retries

Notes

The time between when the active SM fails and the time this SM declares it dead is: (sm_sminfo_polling_timeout * value) milliseconds.

ib sm port-prof-switch

no ib sm port-prof-switch

Enables the counting of adapters, routers, and switches routed through links.

The no form of the command disables the counting of adapters, routers, and switches routed through links.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm port-prof-switch

Related Commands

show ib sm port-prof-switch

Notes

ib sm reassign-lids

no ib sm reassign-lids

Controls the ability of the SM to reassign LIDs to nodes it finds already configured with a valid LID.

The no form of the command disables the SM from reassigning LIDs to nodes it finds already configured with a valid LID.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm reassign-lids

Related Commands

show ib sm reassign-lids

Notes

• If enabled (ib sm reassign-lids), the SM can, but is not required to, reassign the LID on a node with a pre-configured LID

• If disabled (no ib sm reassign-lids), the SM does not reassign LIDs

• There are times when the SM is required to reassign LIDs or the fabric cannot be brought to a stable state, or a fabric option (like LMC) can not be fully applied

ib sm reset-config

Resets all SM configuration options to defaults.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm reset-config

Related Commands

Notes

ib sm root-guid <guid>

no ib sm root-guid <guid>

Adds a root GUID for the SM.

The no form of the command removes the GUID from the root GUID list.

Syntax Description

guid

The root GUID number in hexadecimal notation

Default

N/A

Configuration Mode

config

History

3.1.0000

Example

switch (config)# ib sm root-guid aa:bb:00:11:22:33:44:55

Related Commands

show ib sm routing-engines

Notes

The list of root GIDs are relevant when IB SM is running on the switch, and the routing algorithm is up-down or fat-tree.

ib sm routing-engines [dor] [file] [ftree] [lash] [minhop] [none] [updn] [ar-updn]

no ib sm routing-engines

Sets the routing engine of the SM.

The no form of the command sets the routing engine to be “none”. The default SM routing engine is used.

Syntax Description

dor

Includes “dor” engine in selection of routing engines

file

Includes “file” engine in selection of routing engines

ftree

Includes “ftree” engine in selection of routing engines

lash

Includes “lash” engine in selection of routing engines

minhop

Includes “minhop” engine in selection of routing engines

none

No routing engines specified; use SM default(s)

updn

Includes “up/down” engine in selection of routing engines

ar-updn

Includes “adaptive routing up/down” engine in selection of routing engines

Default

None

Configuration Mode

config

History

3.1.0000

3.10.4000

Added ar-updn option

Example

switch (config) # ib sm routing-engines none

Related Commands

show ib sm routing-engines

Notes

Multiple routing engines can be specified separated by spaces so that specific ordering of routing algorithms will be tried if earlier routing engines fail.

ib sm rtr-aguid-enable <value>

no ib sm rtr-aguid-enable

Configures SM alias GUID control option.

The no form of the command resets SM alias GUID control to its default value.

Syntax Description

value

Possible values:

• 0—does not configure alias GIDs required by routers

• 1—configures alias GIDs required by routers

• 2—clears and does not configure alias GIDs required by routers

Default

0

Configuration Mode

config

History

3.6.2002

Example

switch (config) # ib sm rtr-aguid-enable 1

Related Commands

Notes

ib sm rtr-pr-flow-label <value>

no ib sm rtr-pr-flow-label <value>

Configures inter-subnet PathRecord FlowLabel.

The no form of the command resets inter-subnet PathRecord FlowLabel to its default value.

Syntax Description

value

Range: 0-1048575

Default

0

Configuration Mode

config

History

3.6.2002

Example

switch (config) # ib sm rtr-pr-flow-label 1

Related Commands

Notes

ib sm rtr-pr-mtu <value>

no ib sm rtr-pr-mtu <value>

Configures inter-subnet PathRecord MTU.

The no form of the command resets inter-subnet PathRecord MTU to its default value.

Syntax Description

value

Possible values: 256, 512, 1K, 2K, 4K

Default

2K

Configuration Mode

config

History

3.6.2002

Example

switch (config) # ib sm rtr-pr-mtu 2k

Related Commands

Notes

ib sm rtr-pr-rate <value>

no ib sm rtr-pr-rate <value>

Configures inter-subnet PathRecord rate.

The no form of the command resets inter-subnet PathRecord rate to its default value.

Syntax Description

value

Possible values: 2.5, 5, 10, 14, 20, 25, 40, 56, 100

Default

100

Configuration Mode

config

History

3.6.2002

Example

switch (config) # ib sm rtr-pr-rate 5

Related Commands

Notes

ib sm rtr-pr-sl <value>

no ib sm rtr-pr-sl <value>

Configures inter-subnet PathRecord SL.

The no form of the command resets inter-subnet PathRecord SL to its default value.

Syntax Description

value

Range: [0-15]

Default

0

Configuration Mode

config

History

3.6.2002

Example

switch (config) # rtr-pr-sl 0

Related Commands

Notes

ib sm rtr-pr-tclass <value>

no ib sm rtr-pr-tclass <value>

Configures inter-subnet PathRecord T-class.

The no form of the command resets inter-subnet PathRecord T-class to its default value.

Syntax Description

value

Range: 0-255

Default

0

Configuration Mode

config

History

3.6.2002

Example

switch (config) # ib sm rtr-pr-tclass 1

Related Commands

Notes

ib sm sa-key <SA_Key>

Sets the SA_Key 64-bit value used by SA to qualify that a query is “trusted”.

Syntax Description

SA Key

64 bit

Default

00:00:00:00:00:00:00:01

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm sa-key 5

Related Commands

show ib sm sa-key

Notes

OpenSM version 3.2.1 and lower used the default value of “1” in host byte order. You may need to change this value to inter-operate with older subnet managers.

ib sm single-thread

no ib sm single-thread

Enables the Subnet Manager to use a single thread to service all requests.

The no form of the command enables SA to use multiple service threads.

Syntax Description

N/A

Default

Disabled (use multiple service threads)

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm single-thread

Related Commands

show ib sm single-thread

Notes

ib sm sm-inactive

no ib sm sm-inactive

Configures the SM to start in the “inactive” SM state. This option can be used to run a standalone system without the SM/SA function.

The no form of the command configures the SM to start in “init” SM state.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm sm-inactive

Related Commands

show ib sm sm-inactive

Notes

ib sm sm-key <SM_Key>

Sets the SM 64-bit SM_Key.

Syntax Description

SM Key

64 bit

Default

00:00:00:00:00:00:00:01

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm sm-key 00:00:00:00:00:00:00:05

Related Commands

show ib sm sm-key

Notes

OpenSM version 3.2.1 and lower used the default value of “1” in host byte order. You may need to change this value to inter-operate with older subnet managers.

ib sm sm-priority <priority>

Prioritizes the desired SM compared to other SMs on the fabric.

Syntax Description

priority

Range: 0-15

0 is least important

15 the most important

Default

0

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm sm-priority 1

Related Commands

show ib sm sm-priority

Notes

If two or more active SMs have the same highest priority, the one with the lowest port GUID manages the fabric.

ib sm sm-sl <sm-sl>

Sets the SM service level for SM/SA communication.

Syntax Description

sm-sl

0-15

Default

0

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm sm-sl 10

Related Commands

show ib sm sm-sl

Notes

Selects the SL that is used for MADs.

ib sm sminfo-poll-time <time>

This variable controls the timeout between two polls of an active subnet manager.

Syntax Description

time

In milliseconds

Default

10 seconds

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm sminfo-poll-time 15

Related Commands

show ib sm sminfo-poll-time

Notes

ib sm subnet-prefix <prefix>

no ib sm subnet-prefix <prefix>

Sets the SM “Subnet Prefix” used to create scope qualifiers for all elements managed by the SM.

The no form of the command resets the subnet prefix to its default value.

Syntax Description

prefix

64 bit

Default

FE:80:00:00:00:00:00:00

Configuration Mode

config

History

3.6.1002

3.6.2002

Added no form of the command

Example

switch (config) # ib sm subnet-prefix ff:ff:ff:ff:ff:ff:ff:00

Related Commands

show ib sm subnet-prefix

Notes

The default value is also the InfiniBand default for a locally administered subnet.

ib sm subnet-prefix-override

no ib sm subnet-prefix-override

Disables IB Router subnet prefix checking.

The no form of the command enables IB Router subnet prefix checking.

Syntax Description

N/A

Default

Enabled

Configuration Mode

config

History

3.6.2002

Example

switch (config) # ib sm subnet-prefix-override

Related Commands

show ib sm subnet-prefix-override

Notes

ib sm max-smps-timeout <Timeout>

Sets timeout for SMPs between max_wire_smps & max_wire_smps2

Syntax Description

timeout

Timeout in seconds

Default

N/A

Configuration Mode

config

History

3.8.3000

Example

switch (config) # ib sm max-smps-timeout 22

Related Commands

Notes

ib sm subnet-timeout <time>

Sets the global per-port subnet timeout value (PortInfo:SubnetTimeOut). This value also controls the maximum trap frequency in which no traps are allowed to be sent faster than the subnet_timeout value.

Syntax Description

time

The actual timeout is 4.096 uS * 2*<time>. The range of time is 0-31 for this parameter which supports 32 discrete time values between 4 uS and about 2.4 hours.

Default

0x12 (About 1 second)

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm subnet-timeout 5

Related Commands

show ib sm subnet-timeout

Notes

If the SMA generates a sequence of traps, the interval between successive traps should not be smaller than <time>.

ib sm sweep-interval <time>

no ib sm sweep-interval

Specifies the time between subnet sweeps.

The no form of the command disables periodic sweeps.

Syntax Description

time

Range: Between 0 and 36000 seconds; 0—disable

Default

10 seconds

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm sweep-interval 20

Related Commands

show ib sm sweep-interval

Notes

ib sm sweep-on-trap

no ib sm sweep-on-trap

Enables every TRAP received by the SM to initiate a heavy sweep in addition to the processing required by the TRAP.

The no form of the command enables SM to use a combination of light and heavy sweeps based on the type of TRAP and other internal states.

Syntax Description

N/A

Default

enable

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm sweep-on-trap

Related Commands

show ib sm sweep-on-trap

Notes

More than 10 successive identical TRAPs disable the automatic sweep behavior until at least one different TRAP has been received.

ib sm transaction-retries <transaction-retries-count>

Sets the maximum retries for failed transactions.

Syntax Description

transaction-retries-count

Must be an integer

Default

3

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm transaction-retries 10

Related Commands

show ib sm transaction-retries

Notes

ib sm use-heavy-sweeps

no ib sm use-heavy-sweeps

Turns every fabric sweep to a heavy sweep.

The no form of the command enables the SM to use a combination of light and heavy sweeps.

Syntax Description

N/A

Default

disable

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm use-heavy-sweeps

Related Commands

show ib sm use-heavy-sweeps

Notes

ib sm use-ucast-cache

no ib sm use-ucast-cache

Enables the SM to use cached routine data (LMC=0 only).

The no form of the command disables the SM to use cached routine data.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm use-ucast-cache

Related Commands

show ib sm use-ucast-cache

Notes

ib sm vl-stalls <count>

Sets the number of sequential frame drops that cause a switch-to-switch port to enter the VLStalled state.

Syntax Description

count

1-255

Default

7

Configuration Mode

config

History

3.1.0000

Example

switch (config) # ib sm vl-stalls 10

Related Commands

show ib sm vl-stalls

Notes

ib sm virt {enable | disable | ignore}

no ib sm virt

Configures IB SM port virtualization support.

The no form of the command resets this parameter to its default value.

Syntax Description

enable

IB SM supports virtualization, and configures virtual ports

disable

IB SM disables virtual ports

ignore

IB SM ignores virtual ports and does not change their configuration

Default

Ignore

Configuration Mode

config

History

3.4.2008

Example

switch (config) # ib sm virt configure

Related Commands

Notes

ib sm virt-default-hop-limit <value>

no ib sm virt-default-hop-limit

Configures the default value for hop limit to be returned in path records.

The no form of the command resets this parameter to its default value.

Syntax Description

value

Range: 0-255

Default

2

Configuration Mode

config

History

3.6.2002

Example

switch (config) # ib sm virt-default-hop-limit 3

Related Commands

Notes

ib sm virt-max-ports-in-process <value>

no ib sm virt-max-ports-in-process

Configures the maximum number of ports to be processed simultaneously.

The no form of the command resets this parameter to its default value.

Syntax Description

value

Range: 0-65535

“0” processes all pending ports

Default

4

Configuration Mode

config

History

3.6.2002

Example

switch (config) # ib sm virt-max-ports-in-process 5

Related Commands

Notes

show ib sm

Displays the SM admin state.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm
enable

Related Commands

ib sm

Notes

show ib sm accum-log-file

Displays the accum-log-file configuration.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm accum-log-file
enable

Related Commands

ib sm accum-log-file

Notes

show ib sm babbling-policy

Displays the ability of the SM to disable babbling ports (i.e., generating frequent traps).

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm babbling-policy
disable

Related Commands

ib sm babbling-policy

Notes

Show ib sm calculate-missing-routes

Display option allowing SM to find and recalculate missing routes without creating credit-loops

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.8.2000

Example

switch (config) # ib sm calculate-missing-routes 
switch (config) # show ib sm calculate-missing-routes

ib sm calculate-missing-routes: enabled

switch (config) # no ib sm calculate-missing-routes
switch (config) # show ib sm calculate-missing-routes

ib sm calculate-missing-routes: disabled

Related Commands

ib sm calculate-missing-routes

Notes

show ib sm connect-roots

Displays the IBA compliant multi-stage switch directive.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm connect-roots
true

Related Commands

ib sm connect-roots

Notes

show ib sm enable-quirks

Displays if the SM uses high risk features and handles HW workarounds.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm enable-quirks
disable

Related Commands

ib sm enable-quirks

Notes

show ib sm exit-on-fatal

Displays if the SM exits upon a fatal error.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm exit-on-fatal
enable

Related Commands

ib sm exit-on-fatal

Notes

show ib sm fdr10

Displays the status of the SM use of FDR10.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm fdr10
SM use of fdr10 is off

Related Commands

Notes

show ib sm force-link-speed

Displays SM behavior for PortInfo:LinkSpeedEnabled parameter on switch ports.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

3.4.1604

Updated Syntax Description, Example and Notes

Example

switch (config) # show ib sm force-link-speed
Default: set to PortInfo:LinkSpeedSupported

Related Commands

ib sm force-link-speed

Notes

Possible outputs:

• Default: set to PortInfo:LinkSpeedExtSupported

• Disabled: extended link speed not in use

• Negotiate: <a list containing fdr, edr speeds>

show ib sm force-link-speed-ext

Displays SM behavior for PortInfo:LinkSpeedExtEnabled parameter on the switch ports.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

3.4.1604

Updated Description and Example

Example

switch (config) # show ib sm force-link-speed-ext
Negotiate: fdr edr

Related Commands

ib sm force-link-speed

Notes

Possible outputs:

• Default: set to PortInfo:LinkSpeedExtSupported

• Disabled: extended link speed not in use

• Negotiate: <a list containing fdr, edr speeds>

show ib sm force-log-flush

Displays if every log message generated forces the log to be flushed.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

3.4.1604

Updated Description and Example

Example

switch (config) # show ib sm force-log-flush
enable

Related Commands

ib sm force-log-flush

Notes

show ib sm guid2lid-cache

Displays whether or not the SM honors the cached GUID-to-LID mapping information.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm guid2lid-cache
disable

Related Commands

ib sm guid2-lid-cache

Notes

show ib sm honor-partitions

Displays the partition enforcement settings in the subnet.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm honor-partitions
disable

Related Commands

ib sm honor-partitions

Notes

show ib sm hoq-lifetime

Displays the maximum time a frame can wait at the head of a switch-to-switch port queue before it is dropped.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm hoq-lifetime
0x12 (About 1 second)

Related Commands

ib sm hoq-lifetime

Notes

show ib sm ignore-other-sm

Displays if the rules governing SM elections and attempt to manage the fabric on the node are ignored by the SM.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm ignore-other-sm
enable

Related Commands

ib sm ignore-other-sm

Notes

show ib sm ipv6-nsm

Displays the consolidation of IPv6 Solicited Node Multicast (SNM) group join requests.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm ipv6-nsm
enable

Related Commands

ib sm ipv6-nsm

Notes

show ib sm lash {do-mesh-analysis | start-vl}

Display “lash” routing method parameters.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm lash do-mesh-analysis
enable

Related Commands

ib sm lash

Notes

show ib sm leafhoq-lifetime

Displays the maximum time a frame can wait at the head of a switch-to-CA_or_Router port queue before it is dropped.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm leafhoq-lifetime
0x10 (About 268 mS)

Related Commands

ib sm leafhoq-lifetime

Notes

show ib sm leafvl-stalls

Displays the number of sequential frame drops that case a switch-to-CA_or_Router port to enter the VLStalled state.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm leafvl-stalls
7

Related Commands

ib sm leafvl-stalls

Notes

show ib sm lmc

Displays the number of sequential frame drops that case a switch-to-CA_or_Router port to enter the VLStalled state.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm lmc
0x0

Related Commands

ib sm lmc

Notes

show ib sm lmc-esp0

Displays the number of sequential frame drops that case a switch-to-CA_or_Router port to enter the VLStalled state.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm lmc-esp0
enable

Related Commands

ib sm lmc-esp0

Notes

show ib sm log [continuous] [[not] [matching <reg-expression>]]

Displays IB SM event logs.

Syntax Description

continuous

Displays IB SM new event log messages as they arrive

not

Displays IB SM new event logs that do not match a given regular expression

matching

Displays IB SM event log messages that match a given regular expression

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm log
Jul 18 12:00:40 165863 [48026660] 0x03 -> OpenSM 3.3.13.MLNX_20121224_9b362db
Jul 18 12:00:40 168685 [48026660] 0x80 -> OpenSM 3.3.13.MLNX_20121224_9b362db
Jul 18 12:00:40 170789 [48026660] 0x02 -> osm_vendor_init: 1000 pending umads specified
Jul 18 12:00:40 175696 [48026660] 0x80 -> Entering DISCOVERING state
Jul 18 12:00:40 249448 [48026660] 0x02 -> osm_vendor_bind: Binding to port 0x2c903008b0440
Jul 18 12:00:40 293959 [48026660] 0x02 -> osm_vendor_bind: Binding to port 0x2c903008b0440
Jul 18 12:00:40 296921 [48026660] 0x02 -> osm_vendor_bind: Binding to port 0x2c903008b0440
Jul 18 12:00:40 304702 [48026660] 0x02 -> osm_opensm_bind: Setting IS_SM on port 0x0002c903008b0440
Jul 18 12:00:40 399744 [4A85D4B0] 0x80 -> Entering MASTER state

Related Commands

show ib sm log-flags

Notes

show ib sm log-flags

Displays what type of messages the SM is logging.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm log-flags
0x3 (error, info)

Related Commands

ib sm log-flags

Notes

show ib sm log-max-size

Displays the maximum size of the log file.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

3.1.0000

Example

switch (config) # show ib sm log-max-size
50 MBytes

Related Commands

ib sm log-max-size

Notes

show ib sm max-op-vls

Displays the maximum size of the log file.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm max-op-vls
15

Related Commands

ib sm max-op-vls

Notes

show ib sm max-ports

Displays the number of CA ports SM can manage.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm max-ports
2048

Related Commands

ib sm max-ports

Notes

show ib sm max-reply-time

Displays the number of CA ports SM can manage.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm max-reply-time
200 milliseconds

Related Commands

ib sm max-reply-time

Notes

show ib sm max-reverse-hops

Displays max hops IO node to top switch.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm max-reverse-hops
0

Related Commands

ib sm max-reverse-hops

Notes

show ib sm aguid-default-hop-limit

Displays max hops IO node to top switch.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm aguid-default-hop-limit
1

Related Commands

ib sm aguid-default-hop-limit

Notes

show ib sm max-wire-smps

Displays the maximal number of MADs the SM will have outstanding at one time to count.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm max-wire-smps
4

Related Commands

ib sm max-wire-smps

Notes

show ib sm max-wire-smps2

Displays maximal SM timeout based packets allowed to be outstanding.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm max-wire-smps2
4

Related Commands

ib sm max-wire-smps2

Notes

show ib sm mkey-lease

Displays MKey period in seconds.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm mkey-lease
0 (no timeout)

Related Commands

ib sm mkey-lease

Notes

show ib sm m-key

Displays the MKey used by the SM.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

3.6.2002

Updated Example

Example

switch (config) # show ib sm m-key
11:33:55:77:99:aa:cc:ee

Related Commands

ib sm m-key

Notes

show ib sm mkey-lease

Displays MKey lease period in seconds.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.6.2002

Example

switch (config) # show ib sm mkey-lease
0 (No timeout)

Related Commands

ib sm mkey-lookup

Notes

show ib sm mkey-lookup

Displays whether the SM looks in file cache for unknown note MKeys.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.6.2002

Example

switch (config) # show ib sm mkey-lookup
enable

Related Commands

ib sm m-key

Notes

show ib sm mkey-protect-level

Displays MKey protection level.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.6.2002

Example

switch (config) # show ib sm mkey-protect-level
0

Related Commands

ib sm mkey-protect-level

Notes

show ib sm msgfifo-timeout

Displays the elapsed time in milliseconds before a frame at the head of Subnet Agent queue causes an immediate BUSY state.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm msgfifo-timeout
10.000 seconds

Related Commands

ib sm msgfifo-timeout

Notes

show ib sm multicast

Displays whether the SM supports multicast on the fabric.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm multicast
enable

Related Commands

ib sm multicast

Notes

show ib sm no-client-rereg

Displays client re-registration admin state.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm no-client-rereg
enable

Related Commands

ib sm no-client-rereg

Notes

show ib sm overrun-trigger

Displays count of local buffer overrun errors for Infiniband trap 130.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm overrun-trigger
3

Related Commands

ib sm overrun-trigger

Notes

show ib sm packet-life-time

Displays the maximum time a frame can live in a switch.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm packet-life-time
0x14 (Infinite)

Related Commands

ib sm packet-life-time

Notes

show ib sm phy-err-trigger

Displays the number of local link integrity errors and the port’s SMA supports traps.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm phy-err-trigger
5

Related Commands

ib sm phy-err-trigger

Notes

show ib sm polling-retries

Displays the number of consecutive times an active SM must fail to respond before it is declared dead.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm polling-retries
8

Related Commands

ib sm polling-retries

Notes

show ib sm port-prof-switch

Displays whether or not the counting of adapters, routers, and switches through the links is being done.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm port-prof-switch
true

Related Commands

ib sm port-prof-switch

Notes

show ib sm reassign-lids

Displays the ability of the SM to reassign LIDs to nodes it finds already configured with a valid LID.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config) # show ib sm reassign-lids
enable

Related Commands

ib sm reassign-lids

Notes

show ib sm root-guid

Displays the configured root GUIDs for the SM.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000

Example

switch (config)# show ib sm root-guid
AA:00:11:22:33:44:55
AA:00:11:22:33:44:56
AA:00:11:22:33:44:57
...

Related Commands

ib sm routing-engine

Notes

The list of root GUIDs are relevant when IB SM is running on the switch, and the routing algorithm is up-down or fat-tree.

show ib sm routing-engines

Displays an ordered list of routing engines.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.1.0000