HowTo Upgrade MLNX-OS Software on Mellanox switch systems

Version 15

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

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



    • 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 video 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@


    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 video 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".