Mellanox WinOF VPI Documentation v5.50.52000
Linux Kernel Upstream Release Notes v6.5

OpenSM - Subnet Manager

OpenSM v3.3.11 is an InfiniBand Subnet Manager. In order to operate one host machine or more in the InfiniBand cluster, at least one Subnet Manger is required in the fabric.

Warning

Please use the embedded OpenSM in the WinOF package for testing purpose in a small cluster. Otherwise, we recommend using OpenSM from FabricIT EFM™ or UFM® or MLNX-OS®.

OpenSM can run as a Windows service and can be started manually from the following directory: <installation_directory>\tools. OpenSM as a service will use the first active port, unless it receives a specific GUID.

OpenSM can be registered as a service from either the Command Line Interface (CLI) or the PowerShell.

The following are commands used from the CLI:

To register it as a service execute the OpenSM service:

Copy
Copied!
            

> sc create OpenSM binPath= "c:\Program Files\Mellanox\MLNX_VPI\IB\Tools\opensm.exe -service" start= auto

To start OpenSM as a service:

Copy
Copied!
            

> sc start OpenSM

To run OpenSM manually:

Copy
Copied!
            

> opensm.exe

For additional run options, enter: “opensm.exe -h”

The following are commands used from the PowerShell:

To register it as a service execute the OpenSM service:

Copy
Copied!
            

> New-Service –Name "OpenSM" –BinaryPathName "`"C:\Program Files\Mellanox\MLNX_VPI\IB\Tools\opensm.exe`" --service -L 128" -DisplayName "OpenSM" –Description "OpenSM for IB subnet" -StartupType Automatic

To start OpenSM as a service run:

Copy
Copied!
            

> Start-Service OpenSM1

Notes

  • For long term running, please avoid using the '-v' (verbosity) option to avoid exceeding disk quota.

  • Running OpenSM on multiple servers may lead to incorrect OpenSM behavior.

Please do not run more than two instances of OpenSM in the subnet.

To modify the IPoIB configuration after installation, perform the following steps:

  1. Open Device Manager and expand Network Adapters in the device display pane.

  2. Right-click the Mellanox IPoIB Adapter entry and left-click Properties.

  3. Click the Advanced tab and modify the desired properties.

Warning

The IPoIB network interface is automatically restarted once you finish modifying IPoIB parameters. Consequently, it might affect any running traffic.

To display a summary of network adapter software, firmware- and hardware-related information such as driver version, firmware version, bus interface, adapter identity, and network port link information, perform the following steps:

  1. Display the Device Manager.

    image2019-3-12_12-33-37.png

  2. Select the Information tab from the Properties sheet.

    image2019-3-12_12-33-29.png

Warning

To save this information for debug purposes, click Save to File and provide the output file name.

© Copyright 2023, NVIDIA. Last updated on May 23, 2023.