NVIDIA UFM Enterprise Appliance Software User Manual

InfiniBand Commands

OpenSM

ib sm configuration import


ib sm configuration import [partition-conf-user-ext] <url>

Imports the Subnet Manager configuration.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.4.1 

Example


ufmapl (config) #
ib sm configuration import partition-config-user-ext 
sftp://admin:123456@192.168.1.12/tmp/partitions.conf.user_ext


Related Commands

show ib sm configuration import

Notes

N/A

show ib sm allow-both-pkeys


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

Enable

History

1.4.0

Example


ufmapl (config) # show ib sm allow-both-pkeys
disable


Related Commands

ib sm allow-both-pkeys

Notes

N/A

ib sm allow-both-pkeys


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

1.4.0

Example


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


Related Commands

show ib sm allow-both-pkey
ib partition management defmember

Notes

N/A

show ib sm keep-pkey-indexes


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

Enable

History

1.4.0

Example


ufmapl (config) # show ib sm keep-pkey-indexes
enable


Related Commands

ib sm keep-pkey-indexes

Notes

N/A

ib sm keep-pkey-indexes


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

1.4.0

Example


ufmapl (config) # no ib sm keep-pkey-indexes


Related Commands

show ib sm keep-pkey-indexes
ib sm allow-both-pkeys

Notes

N/A

show ib sm virtualization


show ib sm virtualization

Displays virtualization support.

Syntax Description

N/A

Default

N/A

Configuration Mode

enable

History

1.4.0

Example


ufmapl (config) # show ib sm virtualization
enable


Related Commands

ib sm virtualization enable
ib sm virtualization ignore

Notes

N/A

ib sm virtualization enable


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

Enabled

Configuration Mode

config

History

1.4.0

Example


ufmapl (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


ib sm virtualization ignore

No virtualization support.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.4.0

Example


ufmapl (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 root-guid


show ib sm root-guid

Displays all configured root GUIDs for the SM.

Syntax Description

N/A

Default

N/A

Configuration Mode

enable

History

1.4.0

Example


ufmapl (config) # show ib sm root-guid
0x0002c903006ad830
0x0002c903006ae120
0x0002c903006af520


Related Commands

ib sm root-guid

Notes

N/A

ib sm root-guid


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

1.4.0

Example


ufmapl (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 routing-engines


show ib sm routing-engines

Displays number of CPUs configured to use for parallel calculations.

Syntax Description

N/A

Default

N/A

Configuration Mode

enable

History

1.4.0

Example


ufmapl (config) # show ib sm routing-engines ar_updn


Related Commands

ib sm routing-engines

Notes

N/A

ib sm routing-engines


ib sm routing-engines <engine>

Configures number of CPUs to use for parallel calculations.

Syntax Description

engine

Multiple routing engines can be specified separated by space. Supported engines: ar-dor, ar-ftree, ar-torus, ar-updn, chain, dfp, dfp2, dor, file, ftree, minhop, pqft, torus-2QoS, updn)

Default

1

Configuration Mode

config

History

1.4.0

Example


ufmapl (config) # ib sm routing-engines ar-updn


Related Commands

show ib sm routing-engines

Notes

N/A

show ib sm ar-sl-mask


show ib sm ar-sl-mask

Displays the adaptive routing SL mask.

Syntax Description

N/A

Default

N/A

Configuration Mode

enable

History

1.4.0

Example


ufmapl (config) # show ib sm ar-sl-mask
0xffff


Related Commands

ib sm ar-sl-mask

Notes

N/A

ib sm ar-sl-mask


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

1.4.0

Example


ufmapl (config) # ib sm ar-sl-mask 0xfffe


Related Commands

show ib sm ar-sl-mask

Notes

N/A

show ib sm configuration import


show ib sm configuration import

Displays imported subnet manager configuration files.

Syntax Description

N/A

Default

N/A

Configuration Mode

enable

History

1.4.0

Example


ufmapl (config) # show ib sm configuration import
partitions.conf.user_ext                ----


Related Commands

ib sm configuration import

Notes

N/A

ib sm partition-config-merge


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

1.4.0

Example


ufmapl (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 sharp enable


ib sm sharp enable
no ib sm sharp enable

Enables NVIDIA® Scalable Hierarchical Aggregation and Reduction Protocol (SHARP)™ on all supporting switches.
The no form disables NVIDIA SHARP on all supporting switches.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.4.0

Example


ufmapl (config) # ib sm sharp enable


Related Commands

show ib sm sharp

Notes

It is not possible to modify the NVIDIA SHARP support parameter in case OpenSM is running.

ib sm sharp ignore


ib sm sharp ignore

No NVIDIA SHARP support.
This command does not change the current switch configuration. If NVIDIA SHARP is enabled on the switch, it will remain enabled. If it is disabled on the switch, it will remain disabled.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.4.0

Example


ufmapl (config) # ib sm sharp ignore


Related Commands

show ib sm sharp

Notes

It is not possible to modify the NVIDIA SHARP support parameter in case OpenSM is running.

show ib sm sharp


show ib sm sharp

Displays NVIDIA SHARP support.

Syntax Description

N/A

Default

N/A

Configuration Mode

Enable

History

1.4.0

Example


ufmapl (config) # show ib sm sharp
ignore


Related Commands

ib sm sharp enable
ib sm sharp ignore

Notes

N/A

HCA Commands

ib hca-vl15-window


ib hca-vl15-window <value>
no ib hca-vl15-window

Sets the HCA VL15 port receive buffer size.
The no form of the command resets this parameter to its default.

Syntax Description

value

1,2,4,8,16,32,64,128

Default

1

Configuration Mode

config

History

1.6.0

Example


UFM-APL (config) # ib hca-vl15-window 6


Related Commands

show ib hca-vl15-window

Notes

UFM system must be rebooted to apply the new configuration

show ib hca-vl15-window


show ib hca-vl15-window

Displays the configured HCA VL15 port receive buffer size.

Syntax Description

N/A

Default

N/A

Configuration Mode

Enable

History

1.6.0

Example


ufmapl (config) # show ib hca-vl15-window
/dev/mst/mt4123_pciconf0:
  Running configuration: default

/dev/mst/mt4123_pciconf1:
  Running configuration: default


Related Commands

ib hca-vl15-window

Notes

The example shows an instance where the system has not been rebooted after implementing new configuration

Partition

ib partition management defmember


ib partition management defmember <type>
no ib partition management defmember

Sets the default membership for the management IB partition (default PKEY). The no form of the command resets the parameter to its default value.

Syntax Description

type

  • full – full membership

  • limited – limited membership

Default

Full membership

Configuration Mode

config

History

1.4.0

Example


ufmapl (config) # ib partition management defmember limited


Related Commands

show ib partition

Notes

  • The defmember setting controls the ability of end nodes to communicate over the management partition

  • It is not possible to modify the defmember in case OpenSM or UFM are running

show ib partition


show ib partition

Displays partition information.

Syntax Description

N/A

Default

N/A

Configuration Mode

enable

History

1.4.0

Example


ufmapl (config) # show ib partition
 
  management:
    Default membership: full


Related Commands

ib partition management defmember

Notes

N/A

NVIDIA SHARP

ib sharp enable


ib sharp enable
no ib sharp enable

Enables NVIDIA® Scalable Hierarchical Aggregation and Reduction Protocol (SHARP)™.
The no form of the command disables NVIDIA SHARP.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.4.0

Example


ufmapl (config) # ib sharp enable


Related Commands

show ib sharp

Notes

N/A

ib sharp allocation enable


ib sharp allocation enable
no ib sharp allocation enable

Enables NVIDIA SHARP allocation reservation.
The no form of the command disables NVIDIA SHARP allocation reservation.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.6.0

Example


ufmapl (config) # ib sharp allocation enable


Related Commands

show ib sharp

Notes


ib sharp smx-protocol


ib sharp smx-protocol {sockets | ucx}
no ib sharp smx-protocol

Configures network protocol to be used by SMX.
The no form of the command restores the network protocol to default.

Syntax Description

N/A

Default

sockets

Configuration Mode

config

History

1.4.0

Example


ufmapl (config) # ib sharp smx-protocol ucx


Related Commands

show ib sharp

Notes

N/A

ib sharp topology-api enable


ib sharp topology-api enable
no ib sharp topology-api enable

Enables the SHARP topology API.
The no form of the command disables the SHARP topology API.

Syntax Description

N/A

Default

Disabled

Configuration Mode

config

History

1.4.0

Example


ufmapl (config) # ib sharp topology-api enable


Related Commands

show ib sharp

Notes

N/A

show ib sharp


show ib sharp

Displays the configuration of NVIDIA SHARP Aggregation Manager.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.6.0

Updated the output to reflect the new settings

1.4.0

First release

Example


ufmapl (config) # show ib sharp
   Enabled:                 No
   Allocation:              No
   SMX protocol:            sockets
   Topology API:            No
   Dump files generation:   Yes
   Dynamic tree allocation: No
   Dynamic tree algorithm:  0
   IB QPC SL:               0
   IB SAT QPC SL:           1


Related Commands

N/A

Notes

N/A

ib sharp dump-files-generation enable 


ib sharp dump-files-generation enable
no ib sharp dump-files-generation enable 

Enables dumping SHARP's internal state to files
The no form of the command disables dumping SHARP's internal state to files

Syntax Description

N/A

Default

Disable

Configuration Mode

config

History

1.6.0

Example


ufmapl (config) # ib sharp dump-files-generation enable


Related Commands

show ib sharp

Notes

N/A

ib sharp dynamic-tree-allocation enable


ib sharp dynamic-tree-allocation enable
no ib sharp dynamic-tree-allocation enable

Enables dynamically allocated trees for each SHARP job
The no form of the command disables dynamically allocated trees for each SHARP job

Syntax Description

N/A

Default

Enable

Configuration Mode

config

History

1.6.0

Example


ufmapl (config) # ib sharp dynamic-tree-allocation enable


Related Commands

show ib sharp

Notes

N/A

ib sharp dynamic-tree-algorithm


ib sharp dynamic-tree-algorithm <0-1>
no ib sharp dynamic-tree-algorithm 

Sets which algorithm should be used by the dynamic tree mechanism
The no form of the command restores the algorithm used by the dynamic tree mechanism to default

Syntax Description

N/A

Default

0

Configuration Mode

config

History

1.6.0

Example


ufmapl (config) # ib sharp dynamic-tree-algorithm 


Related Commands

show ib sharp

Notes

N/A

ib sharp ib-qpc-sl <0-15>


ib sharp ib-qpc-sl <0-15>
no ib sharp ib-qpc-sl 

Set the IB QP context SL for SHARP data path communication
The no form of the command restores the IB QP context SL for SHARP data path communication to default

Syntax Description

N/A

Default

0

Configuration Mode

config

History

1.6.0

Example


ufmapl (config) # ib sharp ib-qpc-sl 1


Related Commands

show ib sharp

Notes

N/A

ib sharp ib-sat-qpc-sl <0-15>


ib sharp ib-sat-qpc-sl <0-15>
no ib sharp ib-sat-qpc-sl 

Sets the IB QP context SL for SHARP streaming data path communication
The no form of the command restores the IB QP context SL for SHARP streaming data path communication to default

Syntax Description

N/A

Default

1

Configuration Mode

config

History

1.6.0

Example


ufmapl (config) # ib sharp ib-sat-qpc-sl 1


Related Commands

show ib sharp

Notes

N/A


Last updated: