Downgrade Software

Before you downgrade

Before you downgrade the F5OS software on your system:

• Back up your system and tenant configurations.
• Export your backups to a safe, off-unit location.
• Upload system image files to the system before the scheduled maintenance window to minimize the time needed to downgrade.

Downgrades of F5OS software from the CLI

You can use the CLI to perform a downgrade of F5OS software to an earlier version.

Perform a downgrade of F5OS software from the CLI

Before you downgrade your system software, verify that you have downloaded and imported the F5OS-A image files from F5 Downloads.

If necessary, you can return to a previous version of F5OS-A software on an F5 rSeries system from the CLI.

1. Connect to the system using a management console or console server.

   Note: The default baud rate and serial port configuration is 19200/8-N-1.

2. Log in to the command line interface (CLI) of the system using an account with admin access.

   When you log in to the system, you are in user (operational) mode.

3. Verify that the Base OS image you want to install is listed, and the status is ready.

   show system image

   A summary similar to this excerpt displays:

   Copy

   appliance-1# show system image
                                             IN
   VERSION OS  STATUS  DATE        SIZE      USE
   -------------------------------------------------
   1.3.0-4567  ready   2022-10-05  921.22MB  true
   1.2.0-3456  ready   2022-09-27  921.19MB  false
   
   
   VERSION                                 IN
   SERVICE     STATUS  DATE        SIZE    USE
   -----------------------------------------------
   1.3.0-4567  ready   2022-10-05  2.12GB  true
   1.2.0-3456  ready   2022-09-27  2.05GB  false
   
   
   VERSION                                 IN
   ISO         STATUS  DATE        SIZE    USE
   -----------------------------------------------
   1.3.0-4567  ready   2022-10-05  3.63GB  false
   1.2.0-3456  ready   2022-09-27  3.56GB  false

4. Change to config mode.

   config

   The CLI prompt changes to include (config).

5. Set the ISO version to the new version.

   system image set-version iso-version <*version*>

   Note: By default, you will be prompted to confirm the downgrade.

   This example shows downgrading the ISO version:

   Copy

   appliance-1(config)# system image set-version iso-version 1.2.0-3456 

6. When the compatibility check succeeds, type yes to proceed with the installation process.

   A summary similar to this excerpt displays:

   Copy

   appliance-1(config)# system image set-version iso-version 1.2.0-3456
   Changing software version will trigger system reboot and interrupt tenant 
   operation. Proceed? [yes/no]: yes
   response System ISO version has been set

The system installs the selected version and reboots. This results in a temporary service outage.

Downgrades of F5OS software from the webUI

You can use the webUI to perform a downgrade of F5OS software to an earlier version.

Perform a downgrade of F5OS software from the webUI

Before you downgrade your system software, verify that you have downloaded and imported the F5OS-A image files from F5 Downloads.

If necessary, you can return to a previous version of F5OS-A software on an F5 rSeries system from the webUI.

1. Log in to the webUI using an account with admin access.

2. On the left, click SYSTEM SETTINGS > Software Management.

3. In the Update Base OS Software section, for Update Software, select Bundled to install a full F5OS-A version release.

4. For ISO Image, select the software image version.

5. Click Save.

The system installs the selected version and reboots. This results in a temporary service outage.