Autonomous Health Framework or only AHF, is a diagnostic and system performance framework designed to keep database systems healthy and running while minimizing human reaction time.
If you tried to run ahfctl upgrade and for some reason you had problems with upgrade file, for example, network limitations to download it, let’s see how to upgrade AHF manually.
First we need to download from Autonomous Health Framework (AHF) – Including Trace File Analyzer and Orachk/Exachk (Doc ID 2550798.1) Oracle note, transfer zip file to directory, unzip the file and run with root user, ahfctl upgrade command:
[root@zdl02dbadm02 ahf]$ cd /u01/app/oracle/oracle.ahf/data/zdl02dbadm02/.upgrade/
[root@zdl02dbadm02 .upgrade]$ ls -ltr
total 305068
-rw-r--r-- 1 root root 312387551 Apr 4 11:02 AHF-LINUX_v25.3.0.zip
[root@zdl02dbadm02 .upgrade]$ unzip AHF-LINUX_v25.3.0.zip
Archive: AHF-LINUX_v25.3.0.zip
inflating: ahf_setup
extracting: ahf_setup.dat
inflating: README.txt
inflating: oracle-tfa.pub
Now, we are going to run ahfctl upgrade command:
[root@zdl02dbadm02 ahf]$ ahfctl upgrade
Initiating Autonomous Health Framework (AHF) auto upgrade
AHF software signature has been validated successfully
Starting to upgrade Autonomous Health Framework (AHF) from 2502200_202503200310 to 2503000_202503270355
AHF Installer for Platform Linux Architecture x86_64
AHF Installation Log : /tmp/ahf_install_253000_36760_2025_04_04-11_03_26.log
Starting Autonomous Health Framework (AHF) Installation
AHF Version: 25.3.0 Build Date: 202503270355
AHF is already installed at /opt/oracle.ahf
Installed AHF Version: 25.2.2 Build Date: 202503200310
Upgrading /opt/oracle.ahf
Shutting down AHF Services
Upgrading AHF Services
Starting AHF Services
No new directories were added to TFA
Directory /u01/app/oracle/crsdata/zdl02dbadm02/trace/chad was already added to TFA Directories.
Setting up compliance autoruns from AHF
.--------------------------------------------------------------------.
| Host | TFA Version | TFA Build ID | Upgrade Status |
+-------------+-------------+-----------------------+----------------+
| zdl02dbadm02 | 25.3.0.0.0 | 250300020250327035530 | UPGRADED |
| zdl02dbadm01 | 25.3.0.0.0 | 250300020250327035530 | UPGRADED |
'-------------+-------------+-----------------------+----------------'
Setting up AHF CLI and SDK
AHF is successfully upgraded to latest version
Saving AHF Installer /u01/app/oracle/oracle.ahf/data/zdl02dbadm02/.upgrade/ahf_setup
Moving /tmp/ahf_install_253000_36760_2025_04_04-11_03_26.log to /u01/app/oracle/oracle.ahf/data/zdl02dbadm02/diag/ahf/
Autonomous Health Framework (AHF) successfully upgraded from 2502200_202503200310 to 2503000_202503270355
We can see Upgrade Status as UPGRADED, saying to us that everything was done successfully.
More details about Autonomous Health Framework, check Oracle documentation: https://docs.oracle.com/en/engineered-systems/health-diagnostics/autonomous-health-framework/
My Piece of Data 