Downgrading OS Software | NVIDIA MLNX-GW User Manual for NVIDIA Skyway Appliance

Prior to downgrading software, please make sure the following prerequisites are met.

Log in to the appliance via the CLI using the console port.
Backup configuration by following these steps.
Disable paging of CLI output. Scroll conditional content switch (config)# no cli default paging enable baidu geneth genib hpapollo hpgenib hpmseries hpsynergy nvswitch Scroll conditional content gateway (config)# no cli default paging enable skyway Scroll conditional content metrox (config)# no cli default paging enable metrox Display commands to recreate current running configuration. Scroll conditional content switch (config)# show running-config baidu geneth genib hpapollo hpgenib hpmseries hpsynergy nvswitch Scroll conditional content gateway (config)# show running-config skyway Scroll conditional content metrox (config)# show running-config metrox Copy the output to a text file.

Downloading Image

Change to Config mode.

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

Delete all previous images from the Images available to be installed prior to fetching the new image.

Fetch the desired software image.

metrox (config) # image fetch scp://username:password@192.168.10.125/var/www/html/<image_name>
100.0%[#################################################################]

Downgrading Image

The procedure described below assumes that booting and running is done from Partition 1 and the downgrade procedure is performed on Partition 2.

Enter config mode.

metrox > enable 
metrox # configure terminal

Display all image files on the system.

metrox (config) # show images
Images available to be installed:
new_image.img
 <downgrade version> 2020-05-19 16:52:50
Installed images:
Partition 1:
 <current version> 2020-05-19 03:46:25
Partition 2:
 <current version> 2020-05-19 03:46:25
Last boot partition: 1
Next boot partition: 1
No boot manager password is set.

Install the fetched image.

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

Display all image files on the system.

metrox (config) # show images
Images available to be installed:
new_image.img
 <downgrade version> 2010-09-19 16:52:50
Installed images:
Partition 1:
 <current version> 2010-09-19 03:46:25
Partition 2:
 <downgrade version> 2010-09-19 16:52:50
Last boot partition: 1
Next boot partition: 2
No boot manager password is set.

Configure the boot location to be the other (next) partition.
```
metrox (config) # image boot next
```
There are two installed images on the system. Therefore, if one of the images gets corrupted (due to power interruption, for example), in the next reboot the image will go up from the second partition.
If you are downgrading to an older software version which has never been run yet on the appliance, use the following command sequence as well.
metrox (config) # no boot next fallback-reboot enable metrox (config) # configuration write
Reload.
```
metrox (config) # reload
```

Switching to Partition with Older Software Version

The system saves a backup configuration file when upgrading from an older software version to a newer one. If the system returns to the older software partition, it uses this backup configuration file.

All configuration changes done with the new software are lost when returning to the older software version.

There are 2 instances where the backup configuration file does not exist:

The user has run “reset factory” command, which clears all configuration files in the system
The user has run “configuration switch-to” to a configuration file with different name then the backup file

Note that the configuration file becomes empty if the system is downgraded to a software version which has never been installed yet.

To allow switching partition to the older software version for the 2 aforementioned cases only, follow the steps below.

Run the following command.

metrox (config)# no boot next fallback-reboot enable

Set the boot partition.
```
metrox (config)# image boot next
```
Save the configuration.
```
metrox (config)# configuration write
```
Reload the system.
```
metrox (config)# reload
```

Last updated: February 29, 2024