Support Query and Upgrade Procedures

This page describes the following support procedures:.

 

Network Adapter Firmware Query and Upgrade Procedure

Please perform the following steps in order to query and upgrade the HCA firmware version:

  1. Download and install MFT (Mellanox Firmware Tool) based on your OS:
    http://www.mellanox.com/content/pages.php?pg=management_tools&menu_section=34
    Please, Refer to the User Manual for the installation instructions.

    Note: If you have MLNX_OFED for Linux installed, then MFT is already installed.

  2. Start the mst driver by invoking: mst start
  3. Display all mst devices available by invoking: mst status
  4. Retrieve the card PSID/board_id, and the currently installed firmware version by invoking:

    flint -d <card_mst_device> q

  5. Download the latest Firmware version:

    a. Go to the Mellanox Firmware download page: http://www.mellanox.com/supportdownloader/
    b. Fill in your card's PSID in the field “PSID or OPN "
    c. Download the firmware zip file and save it on your server
    d. Unzip the file: unzip fw-<...>.bin.zip

  6. Burn the new firmware version on the card by invoking:
    flint -d < card_mst_device > -i <firmware_bin_file> b
  7. Reboot the server.

 

Driver Query and Upgrade Procedure

MLNX_OFED for Linux

Please, follow the provided procedure in order to query the installed driver and install a new driver version on your Linux server:

  1. In order to query the OFED/MLNX_OFED driver version installed, please invoke the following command:

    ofed_info | head -1

    Note: if you are using the in-box driver, you will not receive any output.

  2. If needed, download and install latest MLNX_OFED based on your OS and CPU architecture:

    http://www.mellanox.com/page/products_dyn?product_family=26&mtag=linux_sw_drivers

    Please, refer to the User Manual, chapter 2, for the installation instructions:
    Mellanox OFED Linux User Manual

MLNX_EN for Linux

Please, follow the provided procedure in order to query the installed driver and install a new driver version on your Linux server:

  1. In order to query the MLNX_EN driver version installed, please invoke the following command:

    ethtool –i <eth_interface>
    Note: if you are using the in-box driver, you will not receive any output.

  2. If needed, download and install latest MLNX_EN:

    http://www.mellanox.com/page/products_dyn?product_family=27

    Please, refer to the README, section 4, for the installation instructions:
    http://www.mellanox.com/related-docs/prod_software/MLNX_EN_Linux_README.txt

WinOF for Windows
Please, follow the provided procedure in order to query the installed driver and install a new driver version on your Windows server:

  1. In order to query the WinOF driver version installed, follow these steps:

    Under “Device Manager-> System devices”, right click on Mellanox VPI card and select “Properties”. The driver version installed in listed under the “Driver” tab.

  2. If needed, download and install latest WinOF based on your Windows release:

    http://www.mellanox.com/page/products_dyn?product_family=32&mtag=windows_sw_drivers
    Please refer to the relevant User Manual for the installation instructions.  


Remotely-managed Switch Firmware Query and Upgrade Procedure

Please follow the provided procedure in order to install a new firmware version on your remotely managed (unmanaged) switch:

  1. Download and install MFT (Mellanox Firmware Tool) on one host in the fabric, based on your OS:
    http://www.mellanox.com/content/pages.php?pg=management_tools&menu_section=34
    Please, Refer to the User Manual for the installation instructions.

    Note: if you have MLNX_OFED for Linux installed, the MFT is already installed.

  2. From that host, invoke: ibswitches.

    Match the relevant switch GUID from the Mellanox switch label to the switch’s LID.

  3. From that host, invoke: mst start -> mst ib add -> mst status
  4. Identify the relevant remotely-managed switch mst representation based on the switch LID (from previous step 2).

    Note: the switch’s LID from step 2 is in decimal base, while the switch’s LID in this step is in hexadecimal base. Please make sure to convert the LID accordingly.

  5. Retrieve the switch PSID/board_id, and the currently installed firmware version by invoking:

    flint -d <switch_mst_device> q

  6. Download the latest Firmware version:

    a. Go to the Mellanox Firmware download page: http://www.mellanox.com/supportdownloader/
    b. Fill in your switch's PSID in the field “PSID or OPN "
    c. Download the Firmware zip file and save it on your server
    d. Unzip the file: unzip fw-<...>.bin.zip

  7. Burn the new firmware version on the switch by invoking:
    flint -d < switch_mst_device > -i <firmware_bin_file> b
  8. Reboot the switch by invoking:

    flint -d < remote_switch_mst_device> swreset

  9.  

    Managed Switch Software Query and Upgrade Procedure

    Note: Following the instructions in this section requires having login credentials to our Support website. These credentials are granted based on the contractual status of the customer.

    Note: The firmware version installed on the managed switched is installed automatically as part of the software upgrade process. It is not recommended to upgrade the firmware version of a managed switch separately from the software version.

    Please, follow the provided procedure in order to query and install a new software version on your managed switch:

    For Grid Director 4XXX Switch, EFM FabricIT IS5XXX Switch, MLNX_OS SX6XXX Switch:

    1. Login to the relevant switch as admin.

      • Grid Director software: choose version show
      • Grid Director firmware: choose module-firmware show

      • EFM FabricIT IS5XXX software: choose version
      • EFM FabricIT IS5XXX firmware: choose show asic-version

      • MLNX_OS SX6XXX software: choose show version
      • MLNX_OS SX6XXX firmware: choose show asic-version

      • MLNX_OS SX10XX software: choose show version
      • MLNX_OS SX10XX firmware: choose show asic-version

    2. Access all product releases and manuals here: https://mymellanox.force.com/support/SupportProductFamily?pfid=a2y50000000Gps7AAC&pfcid=a2z50000000CbI7AAK

     

    Creating the Switch System Dump File

     

    Exporting Switch System Dump (Log) Files From Mellanox IS5XXX/SX6XXX/SX1XXX Switches

    The log files can be generated either from CLI or WebUI.

    From CLI

    1. Login to the switch via CLI.
    2. Enter "enable".
    3. Enter "configure terminal".
    4. Enter "debug generate dump"
    5. You can upload the dump to the server using the following command:
      # file debug-dump upload <file_name>  <URL or scp://username:password@hostname/path/file_name>

    From WebUI
    1. Login to the switch via WebUI.
    2. Click on the Status Tab.
    3. Select Maintenance Tab.
    4. You can generate a dump and select a location where to save it.

    Exporting Log Files from Mellanox IS4XXX Switches

    1. Login to the switch via CLI.
    2. Configure the remote Linux server.

      a. Enter config remote mode by running: config -> remote
      b. Configure the remote server ip address by running: server <ip address of the remote server>
      Example: server 192.168.1.1
      c. Define a protocol by running: protocol set <protocol>
      Example: protocol set SCP
      d. Define the username by running: username <username>
      Example: username root
      e. Define the password by running: password -> password:  <passowrd>
      Example: password <cr>
      password: ******
      f. Verify configuration by running: remote show

    3. Generate log file and upload to remote server: exportLOGs <remote path>
      Example: exportLOGs /