NVIDIA UFM-SDN Appliance Command Reference Guide v4.14.1
NVIDIA UFM-SDN Appliance Command Reference Guide v4.14.1

OpenSM

ib qos [enable]

Manages advanced SM QoS options.

Syntax Description

enable

Enables advanced QoS management on this node

Default

N/A

Configuration Mode

config

History

1.6

Example

Copy
Copied!
            

ufmapl [ mgmt-ha-active ] (config) #

Related Commands

Notes

ib sm allow-both-pkeys

no ib sm allow-both-pkeys

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

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

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

2.6

Example

Copy
Copied!
            

ufmapl [mgmt-ha-active] (config) # ib sm allow-both-pkeys

Related Commands

show ib sm allow-both-pkey

ib partition management defmember

Notes

show ib sm allow-both-pkeys

Displays if both full and limited memberships on the same partition are enabled or not.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

2.6

Example

Copy
Copied!
            

ufmapl [mgmt-ha-active] (config) # show ib sm allow-both-pkeys disable

Related Commands

ib sm allow-both-pkeys

Notes

ib sm ar-sl-mask <mask>

no ib sm ar-sl-mask

Configures the adaptive routing SL mask.

The no form of the command rests the mask value to default.

Syntax Description

mask

Range: 0x0000-0xffff

Default

0xffff

Configuration Mode

config

History

4.2.0

Example

Copy
Copied!
            

UFM-APL [ mgmt-ha-active ] (config) # ib sm ar-sl-mask 0xfffe

Related Commands

show ib sm ar-sl-mask

Notes

show ib sm ar-sl-mask

Displays the adaptive routing SL mask.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

4.2.0

Example

Copy
Copied!
            

UFM-APL [ mgmt-ha-active ] (config) # show ib sm ar-sl-mask 0xffff

Related Commands

ib sm ar-sl-mask

Notes

[no] ib sm configuration import [cn-guid | congestion-control | fts | port-search-ordering | guid-routing-order | lid-matrix-dump | prefix-routes | held-back-sw | opensm-health-policy-user-ext | rch-policy | hop-weights | per-module-logging | root-guid | ids-guid | partition-config-user-ext | pgrp-policy | sa-db | io-guid | port-prof-ignore | topo-policy] <url>

Imports the Subnet Manager configuration.

The no form of the command deletes the imported configuration files.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.6

4.3.0

Added congestion-control parameter

Example

Copy
Copied!
            

ufmapl [ mgmt-ha-active ] (config) #

Related Commands

show ib sm configuration import

Notes

show ib sm configuration import

Displays imported subnet manager configuration files.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

4.3.0

Example

Copy
Copied!
            

ufmapl [ mgmt-ha-active ] (config) # show ib sm configuration import port_prof_ignore_file ----- hop_weights_file ----- port_search_ordering_file ----- mc_roots_file ----- lid_matrix_dump_file ----- lfts_file ----- root_guid_file ----- pgrp_policy_file ----- topo_policy_file ----- rch_policy_file ----- held_back_sw_file ----- cn_guid_file ----- io_guid_file ----- ids_guid_file ----- guid_routing_order_file ----- sa_db_file ----- per_module_logging_file ----- congestion_control_policy_file imported prefix_routes_file ----- router_policy_file ----- verbose_bypass_policy_file ----- sa_db_dump_file ----- subnet_lst_file ----- virt_dump_file ----- health-policy.conf.user_ext imported partitions.conf.user_ext imported

Related Commands

ib sm configuration import

Notes

ib sm congestion-control {enable | ignore}

no ib sm congestion-control enable

Configure congestion control.

The no form of the command disables congestion control configuration.

Syntax Description

enable

Enables congestion control

ignore

Ignores congestion control configuration

Default

Disabled

Configuration Mode

config

History

4.3.0

Example

Copy
Copied!
            

ufm [ mgmt-sa ] (config) # ib sm congestion-control enable

Related Commands

show ib sm congestion-control

Notes

show ib sm congestion-control

Displays congestion control configuration.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

4.3.0

Example

Copy
Copied!
            

ufm [ mgmt-sa ] (config) # show ib sm congestion-control ignore

Related Commands

ib sm congestion-control

Notes

ib sm dfp max-cas-on-spine <int>

no ib sm dfp max-cas-on-spine

Configures maximum number of CAs on the switch before it is considered a spine instead of leaf.

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

Syntax Description

int

Range: 1-126

Default

2

Configuration Mode

config

History

4.3.0

Example

Copy
Copied!
            

ufm [ mgmt-sa ] (config) # ib sm dfp max-cas-on-spine 20

Related Commands

show ib sm dfp max-cas-on-spine

Notes

show ib sm dfp max-cas-on-spine

Displays maximum number of CAs on the switch before it is considered a spine instead of leaf.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

4.3.0

Example

Copy
Copied!
            

ufm [ mgmt-sa ] (config) # show ib sm dfp max-cas-on-spine 20

Related Commands

ib sm dfp max-cas-on-spine

Notes

ib sm dfp down-up-turns-mode {allow-in-intermediate-groups | allow-turns-through-intermediate-spine | disable}

Configures whether to allow turns through intermediate spine.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

4.3.0

Example

Copy
Copied!
            

ufm [ mgmt-sa ] (config) # ib sm dfp down-up-turns-mode allow-in-intermediate-groups

Related Commands

show ib sm dfp down-up-turns-mode

Notes

show ib sm dfp down-up-turns-mode

Displays mode of taking down up-turns in intermediate groups with DF+ routing engine.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

4.3.0

Example

Copy
Copied!
            

ufm [ mgmt-sa ] (config) # show ib sm dfp down-up-turns-mode allow down up turns in intermediate groups

Related Commands

ib sm dfp down-up-turns-mode

Notes

ib sm files opensm-dump delete

Deletes OpenSM dump files.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

4.6.0

Example

Copy
Copied!
            

ufm [ mgmt-sa ] (config) # ib sm files opensm-dump delete

Related Commands

Notes

ib sm force-log-flush [enable]

Forces log flush after every write.

Syntax Description

enable

Enables force log flush after every write

Default

N/A

Configuration Mode

config

History

1.6

Example

Copy
Copied!
            

ufmapl [ mgmt-ha-active ] (config) # ib sm force-log-flush enable

Related Commands

Notes

ib sm force-link-speed

Sets SM behavior for port speed on switch ports.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.6

Example

Copy
Copied!
            

ufmapl [ mgmt-ha-active ] (config) #

Related Commands

Notes

ib sm keep-pkey-indexes

no ib sm keep-pkey-indexes

Preserves PKey indexes belonging to the historical PKeys configured on the port when generating PKey tables for a certain port.

The no form of the command calculates PKey indexes belonging to the historical PKeys configured on the port.

Syntax Description

N/A

Default

Enabled

Configuration Mode

config

History

2.6

Example

Copy
Copied!
            

ufmapl [mgmt-ha-active] (config) # no ib sm keep-pkey-indexes

Related Commands

show ib sm keep-pkey-indexes

ib sm allow-both-pkeys

Notes

show ib sm keep-pkey-indexes

Displays whether PKey indexes belonging to the historical PKeys configured on the port are preserved or not.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

2.6

Example

Copy
Copied!
            

ufmapl [mgmt-ha-active] (config) # show ib sm keep-pkey-indexes enable

Related Commands

ib sm keep-pkey-indexes

Notes

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

Configures all log-files.

Syntax Description

all

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

N/A

Configuration Mode

config

History

1.6

Example

Copy
Copied!
            

ufmapl [ mgmt-ha-active ] (config) #

Related Commands

Notes

show ib sm log [continuous | files | matching | not]

Displays ib sm log event.

Syntax Description

continuous

Displays new event log messages as they arrive

files

Displays archived log files

matching

Displays event logs that match a given regular expression

not

Displays event logs that do not meet certain criteria

Default

N/A

Configuration Mode

Any configuration mode

History

1.6

Example

Copy
Copied!
            

ufmapl [ mgmt-ha-active ] (config) #

Related Commands

Notes

ib sm partition-config-merge

Merges the partitions.conf.user_ext into the partitions.conf and starts the heavy sweep on the SM. To use after importing the specific file or importing all configuration files.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

2.6

Example

Copy
Copied!
            

ufmapl [mgmt-ha-active] (config) # ib sm partition-config-merge

Related Commands

ib sm configuration import partition-config-user-ext

Notes

The SM must be running for this command to work.

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 SM.

Syntax Description

guid

The root GUID number in hexadecimal notation

For example: 0x0002c903006ad830

Default

N/A

Configuration Mode

config

History

2.6

Example

Copy
Copied!
            

ufmapl [mgmt-ha-active] (config) # ib sm root-guid 0x0002c903006ad830

Related Commands

show ib sm root-guid

Notes

The list of root GUIDs are relevant when the routing algorithm is up-down or fat-tree.

show ib sm root-guid

Displays all configured root GUIDs for the SM.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

2.6

Example

Copy
Copied!
            

ufmapl [mgmt-ha-active] (config) # show ib sm root-guid 0x0002c903006ad830 0x0002c903006ae120 0x0002c903006af520

Related Commands

ib sm root-guid

Notes

ib sm routing-engines [dfsssp | dor | file | ftree | minhop | torus-2QoS | updn | chain | pqft]

Sets the routing engine of the SM. Multiple routing engines can be specified separated by a space so that specific ordering of routing algorithms is tried if earlier routing engines fail.

Syntax Description

dfsssp

Includes 'dfsssp' (EXPERIMENTAL) engine in selection of routing engines

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

minhop

Includes 'minhop' engine in selection of routing engines

none

No routing engines specified; use SM default(s)

sssp

Includes 'sssp' (EXPERIMENTAL) engine in selection of routing engines

torus-2QoS

Includes 'torus-2QoS' engine in selection of routing engines

updn

Includes 'updn' engine in selection of routing engines

chain

Includes 'chain' engine in selection of routing engines

pqft

Default

N/A

Configuration Mode

config

History

1.6

Example

Copy
Copied!
            

ufmapl [ mgmt-ha-active ] (config) #

Related Commands

Notes

ib sm routing-threads-num <int>

no ib sm routing-threads-num

Configures number of CPUs to use for parallel calculations.

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

Syntax Description

int

Range: 1-8

Default

1

Configuration Mode

config

History

4.3.0

Example

Copy
Copied!
            

ufm [ mgmt-sa ] (config) # ib sm routing-threads-num 5

Related Commands

show ib sm routing-threads-num

Notes

show ib sm routing-threads-num

Displays number of CPUs configured to use for parallel calculations.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

4.3.0

Example

Copy
Copied!
            

ufm [ mgmt-sa ] (config) # show ib sm routing-threads-num 5

Related Commands

ib sm routing-threads-num

Notes

ib sm scatter-ports

Assigns ports in a random order instead of round-robin.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.6

Example

Copy
Copied!
            

ufmapl [ mgmt-ha-active ] (config) #

Related Commands

Notes

ib sm smp-window <value>

no ib sm smp-window

Sets the maximum number of SMPs sent in parallel.

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

Syntax Description

value

0-256

Default

8

Configuration Mode

config

History

2.6

Example

Copy
Copied!
            

UFM-APL (config) # ib sm smp-window 10

Related Commands

show ib sm smp-windows

Notes

show ib sm smp-window

Displays the maximum number of SMPs sent in parallel.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

2.6

Example

Copy
Copied!
            

UFM-APL (config) # show ib sm smp-window 10

Related Commands

ib sm smp-window

Notes

ib sm ufm-events {all | security}

no ib sm ufm-events

Configures which traps the SM sends to the UFM.

The no form of the command configures that no traps are sent to the UFM (i.e. "none").

Syntax Description

all

Sends all traps to the UFM

security

Sends security traps to the UFM only

Default

0xffff

Configuration Mode

config

History

4.2.0

Example

Copy
Copied!
            

UFM-APL [ mgmt-ha-active ] (config) # ib sm ufm-events security

Related Commands

show ib sm ufm-events

Notes

show ib sm ufm-events

Displays the types of traps configured to be sent to the UFM by the SM.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

4.2.0

Example

Copy
Copied!
            

UFM-APL [ mgmt-ha-active ] (config) # show ib sm ufm-events   Determines which Subnet Manager traps will be sent to UFM: security

Related Commands

ib sm ufm-events

Notes

ib sm use-ucast-cache enable

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

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.6

Example

Copy
Copied!
            

ufmapl [ mgmt-ha-active ] (config) #

Related Commands

Notes

ib sm virtualization enable

no ib sm virtualization enable

Enables virtualization on all supported ports (default).

The no form of the command disables virtualization on all supporting ports.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

2.6

Example

Copy
Copied!
            

UFM-APL [ mgmt-ha-active ] (config) # ib sm virtualization enable

Related Commands

show ib sm virtualization

Notes

It is not possible to modify the virtualization support in case OpenSM or UFM are running.

ib sm virtualization ignore

No virtualization support.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

2.6

Example

Copy
Copied!
            

UFM-APL [ mgmt-ha-active ] (config) # ib sm virtualization ignore

Related Commands

show ib sm virtualization

Notes

It is not possible to modify the virtualization support in case OpenSM or UFM are running.

show ib sm virtualization

Displays virtualization support.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

2.6

Example

Copy
Copied!
            

UFM-APL [ mgmt-ha-active ] (config) # show ib sm virtualization ignore

Related Commands

ib sm virtualization enable

ib sm virtualization ignore

Notes

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

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

Sets the maximum number of ports to be processed simultaneously.

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

Syntax Description

value

Range: 1-65535

Default

64

Configuration Mode

config

History

2.6

Example

Copy
Copied!
            

UFM-APL [ mgmt-ha-active ] (config) # ib sm virt-max-ports-in-process 20

Related Commands

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

Notes

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

Displays the maximum number of ports to be processed simultaneously.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

2.6

Example

Copy
Copied!
            

UFM-APL (config) # show ib sm virt-max-ports-in-process 20

Related Commands

ib sm virt-max-ports-in-process

Notes

ufm multi-port-sm enable

ufm multi-port-sm ha-enable

no ufm multi-port-sm enable

Enables configuring OpenSM with multiple GUIDs.

The no form of the command disables configuring OpenSM with multiple GUIDs.

Syntax Description

enable – enables configuring OpenSM with multiple GUIDs

ha-enable – enables multi-port SM with high availability

Default

Disabled

Configuration Mode

config

History

4.3.0

Example

Copy
Copied!
            

ufm [ mgmt-sa ] (config) # ufm multi-port-sm enable

Related Commands

show ufm multi-port-sm

Notes

show ufm multi-port-sm

Displays whether configuring OpenSM with multiple GUIDs is enabled.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

4.3.0

Example

Copy
Copied!
            

ufm [ mgmt-sa ] (config) # show ufm multi-port-sm Enable

Related Commands

ufm multi-port-sm enable

Notes

ufm sm-static-lid <1-49151>

no ufm sm-static-lid

Sets a static SM LID to be used by the SM.

The no form of the command resets the static SM LID to default.

Syntax Description

N/A

Default

Assigned by the SM

Configuration Mode

config

History

4.5.0

Example

Copy
Copied!
            

ufm [ mgmt-sa ] (config) # ufm sm-static-lid 20

Related Commands

show ufm sm-static-lid

Notes

show ufm sm-static-lid

Displays the static SM LID.

Syntax Description

N/A

Default

Assigned by the SM

Configuration Mode

Any configuration mode

History

4.5.0

Example

Copy
Copied!
            

ufm [ mgmt-sa ] (config) # show ufm sm-static-lid Static SM LID: 20

Related Commands

ufm sm-static-lid

Notes

© Copyright 2023, NVIDIA. Last updated on Dec 12, 2023.