1. Oracle Autonomous Health Framework User's Guide
  2. Downgrading Oracle Autonomous Health Framework

Downgrading Oracle Autonomous Health Framework

Oracle Autonomous Health Framework (AHF) supports downgrading to the version from which AHF was most recently upgraded, provided that the previous version is less than six months old.

AHF can be installed with Oracle Grid Infrastructure (GI) or independently of GI. In earlier releases, downgrading presented the following limitations:

  • After a GI downgrade, AHF could become unusable because of dependencies on GI Python and JDK components.
  • For AHF installations outside GI, the installer prevented installation of an older AHF version when a newer version was already installed.
  • Downgrading required uninstalling the current AHF version and reinstalling the older version, resulting in the loss of AHF configuration and event data.

AHF now supports downgrading while preserving applicable configuration and event data.

During a downgrade, AHF:

  1. Exports configuration and event data from the currently installed version.
  2. Removes the currently installed AHF binaries.
  3. Installs the eligible previous AHF version.
  4. Imports the exported configuration and event data.

You can downgrade AHF using either of the following methods:

  • AHF installer
  • AHF CLI using the ahf software downgrade command

Note:

  • AHF properties that were newly set or configured after the AHF upgrade are not retained after a downgrade. Reconfigure those properties after the downgrade.
  • Existing AHF properties that were modified or updated after the AHF upgrade are retained after a downgrade.

Downgrading AHF Using the Installer

To downgrade AHF using an AHF installer:

  1. Determine the eligible downgrade target version:

    ahf software get-downgrade-target [--version] [--location]

  2. Validate the installer for the downgrade target version:

    ahf software validate-downgrade-installer --installer <installer_file>

  3. Run the installer for the eligible downgrade target version with the -downgrade option:

    ahf_setup -downgrade

AHF exports the applicable configuration and event data, installs the previous version, and restores the exported data.

Downgrading AHF Using the AHF CLI

You can save an AHF installer during installation so that it is available if a downgrade is required later.

For information about saving the installer, see Oracle Autonomous Health Framework Installation Command-Line Options.

A typical workflow is:

  1. Install an AHF version using the -saveinstaller option.

    For example, install AHF 24.6.1 and save its installer.

  2. Upgrade to AHF 24.7 or later.

  3. Request a downgrade:

    ahf software downgrade

If the eligible previous installer was saved with AHF, the downgrade to the previous version runs in the background.

Example:

# ahf software downgrade

Downgrade for AHF has been requested.