HowTo Upgrade MLNX-OS Software on Mellanox switches

Version 14

    This is a beginners guide which demonstrates two methods for upgrading Mellanox switches (managed switches - with a CPU), using either the CLI or the web GUI.

    Note: For the upgrade procedure of InfiniBand switches without a CPU, please refer to the MFT user manual.

     

    References

    • MLNX-OS User Manual

     

    MLNX-OS software package includes the switch firmware and the CPU software for the specific switch board CPU (x86 or PPC).

    Installing the CPU software will also install the included firmware. Once you upgrade the software, the firmware will be upgraded as well.

     

    MLNX-OS Image and its related documentation (Release Notes, User Manual) are located at myMellanox.

     

    Upgrading the switch via the CLI

    The following Academy videos explain how to upgrade the Switch using the CLI:

     

     

     

    To upgrade the MLNX-OS:

    1.Connect to the switch remotely via SSH:

    #ssh admin@my-switch-name (e.g. ssh admin@172.28.3.216)

     

    2. Enter config mode:

    switch> enable

    switch# configure terminal

    switch (config)#

     

    3. Run the following commands to upgrade (e.g. upgrade to 3.4.2002 release)

    switch (config)#image delete XXX // --> delete old images, if exist
    switch (config)#image fetch scp://root:password@server/path-to-image/image-X86_64-3.4.2002.img
    switch (config)#image install image-X86_64-3.4.2002.img
    switch (config)#image boot next 
    switch (config)#configuration write
    switch (config)#reload

     

    4. Wait a few minutes and then reconnect to the system.

     

    5. To verify the installation was completed successfully, run:

    # show version

    Product name:      MLNX-OS

    Product release:   3.4.2002

    Build ID:          #1-dev

    Build date:        2015-07-30 20:13:19

    Target arch:       x86_64

    Target hw:         x86_64

    Built by:          jenkins@fit74

    Version summary:   X86_64 3.4.2002 2015-07-30 20:13:19 x86_64

     

     

    Product model:     x86

    Host ID:           E41D2D5FA480

    System serial num: Defined in system VPD

    System UUID:       03000200-0400-0500-0006-000700080009

     

     

    Uptime:            1d 3h 53m 11.288s

    CPU load averages: 1.03 / 1.03 / 1.05

    Number of CPUs:    2

    System memory:     1233 MB used / 2666 MB free / 3899 MB total

    Swap:              0 MB used / 0 MB free / 0 MB total

     

    6. Check the switch firmware version

    # show asic-version

    ===================================================

    Module             Device              Version    

    ===================================================

    MGMT               SX                  9.3.5080

     

    Upgrading the switch via the web GUI

     

    The following Academy videos explain how to upgrade the switch using the WebUI:

     

     

    Alternatively, you can upgrade the switch using the web GUI.

    To do so, login using the management IP on your browser and follow the below steps:

    1. Click on Systems -> MLNX-OS Upgrade.

    2. Click on the desired upgrade method (for example,  "Install from local file").

    3. Select your image and click "Install Image".