Upgrading Operating System Software

To upgrade MLNX-OS, perform the following steps.

Enter Config mode.

Copy
Copied!

            
            switch > enable
switch # configure terminal
switch (config) #

Display the currently available image (.img file). null
Delete the image listed under “Images available to be installed” prior to fetching the new image. Use the command “image delete” for this purpose.
Copy

Copied!
```
            
            switch (config) # image delete <old_image>
        
```
Warning

When deleting an image, it is recommended to delete the file, but not the partition, so as to not overload system resources.

Fetch the new software image.

Copy
Copied!

            
            switch (config) # image fetch scp://<username>:<password>@<ip-address>/var/www/html/<new_image>
Password (if required): ****** 100.0%[##################################################################]

Display the available images again and verify that the new image now appears under “Images available to be installed”.

Warning

To recover from image corruption (e.g., due to power interruption), there are two installed images on the system. See the commands “image boot next” and “image boot location” for more information.

Copy
Copied!

            
            switch (config) # show images
Installed images:
 
  Partition 1:
  <old_image>
 
  Partition 2:
  <old_image>
 
Last boot partition: 1
Next boot partition: 1
 
Images available to be installed:
 webimage.tbz
  <new_image>
 
Serve image files via HTTP/HTTPS: no
 
No image install currently in progress.
 
Boot manager password is set.
 
Image signing: trusted signature always required
Admin require signed images: yes
 
Settings for next boot only:
   Fallback reboot on configuration failure: yes (default)

Install the new image.

Copy
Copied!

            
            switch (config) # image install <new_image>
Step 1 of 4: Verify Image
 100.0%  [#############################################################]
Step 2 of 4: Uncompress Image
 100.0%  [#############################################################]
Step 3 of 4: Create Filesystems
 100.0%  [#############################################################]
Step 4 of 4: Extract Image
 100.0%  [#############################################################]

Warning

CPU utilization may go up to 100% during image upgrade.

Have the new image activate during the next boot.

Copy
Copied!

            
            switch (config) # image boot next

Run “show images” to review your images.

Copy
Copied!

            
            switch (config) # show images
Installed images:
 
  Partition 1:
  <new_image>
 
  Partition 2:
  <old_image>
 
Last boot partition: 1
Next boot partition: 1
 
Images available to be installed:
 webimage.tbz
  <new_image>
 
Serve image files via HTTP/HTTPS: no
 
No image install currently in progress.
 
Boot manager password is set.
 
Image signing: trusted signature always required
Admin require signed images: yes
 
Settings for next boot only:
   Fallback reboot on configuration failure: yes (default)

Save current configuration.

Copy
Copied!

            
            switch (config) # configuration write

Reboot to run the new image.
Copy

Copied!
```
            
            switch (config) # reload
Configuration has been modified; save first? [yes] yes
Configuration changes saved.
Rebooting...
switch (config)#
        
```
Warning

After software reboot, the software upgrade will also automatically upgrade the firmware version.

Warning

On systems with dual management, the software must be upgraded on both the host and the device modules.

Warning

In order to upgrade the system on dual management system, refer to “Upgrading MLNX-OS Software on Modular Switches”.

Warning

When performing an upgrade from the WebUI, make sure that the image being upgraded to is not already located in the system (i.e., fetched from the CLI).