KB 422264 - Updating Port Description on Mellanox Switches like QM9700

KB 422264 - 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.

    • Recent Articles

    • KB-630208 | How to use Find and Locate to search for files in Linux

      Purpose To provide Linux administrators and Field Engineers with guidance on using the find and locate utilities to efficiently search for files and directories within a Linux filesystem based on criteria such as name, type, size, timestamps, ...

    • KB-630164 | How to use rsync to Synchronize Files

      Purpose To provide a clear and practical procedure for using the rsync utility to synchronize files and directories between local systems and remote hosts, including push and pull operations, while preserving file attributes and optimizing data ...

    • KB-630107 | How to create a Linux swap file

      Purpose To provide Field Engineers and Linux administrators with a standardized procedure for creating, configuring, and validating a Linux swap file. This procedure helps ensure sufficient virtual memory is available when physical RAM is exhausted ...

    • MSI All-in-One (AIO) PC – Physical Damage Policy for Warranty Claims

      MSI All-in-One (AIO) PC – Physical Damage Policy for Warranty Claims MSI's standard warranty does not cover physical or accidental damage to an All-in-One (AIO) PC. If the damage is determined to be caused by external factors rather than a ...

    • KB 134833 - Troubleshooting NVSM Alert NV-CPU-XX – Unrecoverable CPU Internal Error

      Purpose This document provides a general troubleshooting procedure for the NVIDIA System Management (NVSM) alert NV-CPU-XX, which indicates that a CPU has reported an internal error. The article outlines how to verify whether the alert represents an ...

    • Popular Articles

    • CP Plus Camera and NVR Configuration

      NVR Configuration The CP Plus Pro Series of NVRs have been meticulously designed for providing you with upgraded performance and higher recording quality in your IP video surveillance solution. The robust processor that has been inculcated in this ...

    • KB 775235 - Kerberos Authentication – Overview

      What is Kerberos? Kerberos is a secure authentication method used in our Active Directory (AD) environment (mbuzztech.com). It allows users to: Access multiple systems without re-entering passwords (Single Sign-On – SSO) Log in once Where We Use It ...

    • How to Remove and Reinstall NVIDIA Drivers on Ubuntu

      This article provides step by step guide to completely remove existing NVIDIA drivers and reinstall specific version of the NVIDIA driver on the Ubuntu system Prerequisites Administrative (sudo) access to the Ubuntu system. Internet access to ...

    • KB 692001 - Personal Computers and Servers - Classification and Point of Contact

      We can classify the computers that MBUZZ handles based on their form-factor as below: Tower Workstations, Desktops, Gaming PCs and SFF (Small form factor) PCs fall under this category. These are computers people would use on a desk and rarely move. ...

    • KB 298031 - M.2 SSD Tier List

      The sequential read and write speeds, which are usually the most advertised number, are not a proper benchmark of real-world performance or the quality of an SSD. This article categorizes and tiers SSDs based on factors like the type of NAND flash, ...