2.5.4 Downgrading Oracle Autonomous Health Framework

AHF supports downgrading to the last version previously upgraded from, as long as it is less than 6 months old.

AHF is installed with Grid Infrastructure, which also supports downgrading, however after a GI downgrade AHF used to become unusable because of broken GI Python and JDK dependencies.

Additionally, customers who had performed an AHF install outside of GI were unable to downgrade, without losing configuration and event data.

This was because the AHF installer would prevent a new install if it found a more recent version on the system. Customers had to uninstall the current version and reinstall an older one, there was no way to retain configuration or event data, which resulted in its loss.

Now AHF supports downgrading to the last version previously upgraded from, if it is less than 6 months old.

During the downgrade process AHF will:

  1. Export configuration and event data from the installed version.
  2. Remove the installed binaries.
  3. Install the older binaries.
  4. Import the exported configuration and event data.
To perform a downgrade:

Note:

  • AHF properties set or configured after an AHF upgrade will NOT be retained after a downgrade. Please reconfigure those AHF properties again.
  • AHF properties that are modified or updated after an AHF upgrade will be retained after a downgrade.
  1. Find your eligible downgrade target version by running:
    ahf software get-downgrade-target [--version] [–location]
  2. Validate AHF Installer by running:
    ahf software validate-downgrade-installer --installer <installer file>
  3. Run the following command using the downgrade target AHF installer:
    ahf_setup -downgrade

If you do not have access to the AHF installer from the previous version, contact Oracle Support to obtain it.

You can also save the AHF Installer for later use if downgrade is needed. For more information, see Oracle Autonomous Health Framework Installation Command-Line Options.

Run the ahf software downgrade command to request an AHF downgrade. This will revert AHF to the previous version in the background if the installer has been saved with AHF.
# ahf software downgrade
Downgrade for AHF has been requested.