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.
- 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 firstname.lastname@example.org)
2. Enter config mode:
switch# configure terminal
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
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".