Updating Port Description on Mellanox Switches like QM9700

Updating Port Description on Mellanox Switches like QM9700

Objective

To update the description for multiple InfiniBand (IB) ports on a Mellanox QM9700 series switch using the web interface.

Prerequisites

  • Administrative access to the Mellanox QM9700 switch's web interface.

  • A pre-prepared list of commands with the correct interface numbers and desired descriptions.

  • A web browser to access the switch management interface.

Procedure

  1. Prepare the Configuration Commands:

    • Using a text editor (like Notepad as shown in the fourth screenshot), create a list of the commands required to update the port descriptions.

    • For each port, you will need a set of three commands:

      • interface ib <slot>/<port>: To enter the configuration mode for the specific InfiniBand port.

      • description "to <destination_device-port>": To set the new description for the interface. Enclose the description in double quotes.

      • exit: To exit the configuration mode for that specific interface.

    • Example from screenshot:

      Generated code

      interface ib 1/31/1 description "to T10PHGXSPSW08-P19/1" exit interface ib 1/31/2 description "to T10PHGXSPSW08-P19/2" exit

       

      Use code with caution.

    • Prepare this for all the ports you intend to update.

  2. Log in to the Switch Web Interface:

    • Open a web browser and navigate to the IP address of your Mellanox switch (e.g., https://10.152.15.55 as indicated in the first screenshot).

    • Log in with your administrative credentials.

  3. Navigate to the CLI Execution Page:


    • In the left-hand navigation pane, click on Configurations.

    • Under the "Configurations" menu, select "Execute CLI commands"

  4. Execute the CLI Commands:

    • Copy the commands you prepared in Step 1 from your text editor.

    • Click the "Execute CLI commands" button.

  5. Save the Running Configuration:


    • The changes made are now active but are not persistent and will be lost on a reboot. To save them permanently, you must save the running configuration to the startup configuration.

    • In the left-hand navigation pane, navigate to Configurations -> Configurations.

    • You will see the current configuration file, marked as (not saved: view running config), as shown in the third screenshot.

    • Under the "Active Configuration" section, click the Save button.

    • This action saves the current running configuration to the active configuration file, ensuring your changes are persistent across reboots.

  6. Verification (Optional but Recommended):

    • To verify, you can either view the running configuration from the web interface or re-run a show interface ib <slot>/<port> command for one of the updated ports in the CLI execution window to check if the description has been updated.

    • Related Articles

    • Fixing "Cable Data Invalid EEPROM" Error on NVIDIA QM9700 InfiniBand Switch

      Issue On NVIDIA QM9700 InfiniBand switches, some ports may appear down and show an error such as: This issue is often caused by outdated CPLD firmware and can be resolved by updating the CPLD version on the switch. Root Cause The EEPROM error is ...
    • Managing OpenSM within NVIDIA UFM and getting OpenSM Logs from UFM

      Overview In NVIDIA UFM (Unified Fabric Manager), OpenSM — the InfiniBand Subnet Manager — is managed internally by UFM rather than as a standalone systemd service. This allows UFM to control the IB fabric, collect telemetry, and maintain HA ...
    • How to Change Default IB Interface in NVIDIA UFM (e.g., from ib0 to ib1)

      By default, NVIDIA UFM binds to the ib0 InfiniBand interface during startup. If ib0 is down or unavailable, UFM will fail to start. In such cases, you may need to change the default interface to ib1 (or any other available IB interface). This article ...
    • How to Get Mellanox NIC Details on an Ubuntu Server

      Step 1: List All Mellanox Adapters To find all Mellanox network adapters on your system, run: lspci | grep Mellanox Example output: 04:00.0 Ethernet controller: Mellanox Technologies MT26448 [ConnectX EN 10GigE, PCIe 2.0 5GT/s] (rev b0) Step 2: ...
    • Installing NVIDIA Drivers on Ubuntu

      Ubuntu doesn't come with NVIDIA drivers installed by default as they are proprietary and closed-source. This means that you'll have issues like poor performance, displays not working, artifacts etc... while using the FOSS nouveau drivers. Graphical ...