AHF
AHF (Oracle Autonomous Health Framework)
AHF is automatically installed under ORACLE_HOME/suptools and is automatically updated by PSU and RU patches.
For OCI Oracle DB Systems (VM), AHF is automatically installed under /u01/app/oracle.ahf and, by default, is automatically updated weekly.
AHF now includes the Trace File Analyzer (TFA) and ORAchk.
AHF requires that /etc/oratab accurately reflects the ORACLE_HOMEs for running instances.
Check
cd /u01/app/oracle.ahf/bin
./ahfctl version
./ahfctl version -a
./ahfctl statusahf
./tfactl toolstatus
Start
./ahfctl startahf
Stop
./ahfctl stopahf
Diagnostic Collection
tfactl diagcollect -from "Oct/05/2022 20:00:00" -to "Oct/06/2022 03:00:00"
Manual Install
NOTE: Due to the frequency of change to this toolset please refer to MOS Note 1268927.2 and 2550798.1 for manual installation.Manual installation should be performed as 'root'.
You should download the installation zip file to /u01/img/AHF and uncompress it before running the installation script...
./ahf_setup
NOTE: AHF requires 11GB of free space in the /opt filesystem.
Although alternative targets can be specified there is a requirement for the target directory structure to be owned by 'root' when AHF is installed as 'root'. This means that subdirectories of /u01 are not valid targets. It is possible to install AHF as a non-root user, which would avoid this problem, but this limits functionality and is thus not recommended.
Example Manual Installation
Version 22.2.1 for AIX
Using default install location: /opt/oracle.ahf
Specifying /opt/oracle.ahf.data as Data Directory... this probably isn't the right thing to do
unzip AHF-AIX-PPC64_v22.2.1.zip
Archive: AHF-AIX-PPC64_v22.2.1.zip inflating: README.txt inflating: ahf_setup extracting: ahf_setup.dat inflating: oracle-tfa.pub./ahf_setup
AHF Installer for Platform AIX Architecture PPC64
AHF Installation Log : /tmp/ahf_install_222100_12845158_2022_08_17-14_23_50.log
Starting Autonomous Health Framework (AHF) Installation
AHF Version: 22.2.1 Build Date: 202208021104
Default AHF Location : /opt/oracle.ahf
Do you want to install AHF at [/opt/oracle.ahf] ? [Y]|N : Y
AHF Location : /opt/oracle.ahf
AHF Data Directory stores diagnostic collections and metadata.AHF Data Directory requires at least 5GB (Recommended 10GB) of free space.
Please Enter AHF Data Directory : /opt/oracle.ahf.data
AHF Data Directory : /opt/oracle.ahf.data/oracle.ahf/data
Do you want to add AHF Notification Email IDs ? [Y]|N : Y
Enter Email IDs separated by space : myemail@myaddress.com
Extracting AHF to /opt/oracle.ahf
Configuring TFA Services
Discovering Nodes and Oracle Resources
Successfully generated certificates.
Starting TFA Services
.----------------------------------------------------------------------------------------.| Host | Status of TFA | PID | Port | Version | Build ID |+-----------------+---------------+----------+-------+------------+----------------------+| myserver | RUNNING | 11272364 | 26877 | 22.2.1.0.0 | 22210020220802110420 |'-----------------+---------------+----------+-------+------------+----------------------'
Running TFA Inventory...
Please add world execute permissions for all directories above /opt/oracle.ahf.data to enable TFA Non-Root Access
Adding default users to TFA Access list...
.-----------------------------------------------------------------------------.| Summary of AHF Configuration |+-----------------+-----------------------------------------------------------+| Parameter | Value |+-----------------+-----------------------------------------------------------+| AHF Location | /opt/oracle.ahf || TFA Location | /opt/oracle.ahf/tfa || Orachk Location | /opt/oracle.ahf/orachk || Data Directory | /opt/oracle.ahf.data/oracle.ahf/data || Repository | /opt/oracle.ahf.data/oracle.ahf/data/repository || Diag Directory | /opt/oracle.ahf.data/oracle.ahf/data/myserver/diag |'-----------------+-----------------------------------------------------------'
Starting Orachk Scheduler from AHF
AHF binaries are available in /opt/oracle.ahf/bin
AHF is successfully installed
Do you want AHF to store your My Oracle Support Credentials for Automatic Upload ? Y|[N] : N
Moving /tmp/ahf_install_222100_12845158_2022_08_17-14_23_50.log to /opt/oracle.ahf.data/oracle.ahf/data/myserver/diag/ahf/
OCI Oracle DB Systems (VM)
AHF is automatically installed and automatically updated each week.
dbcli list-jobs | grep Infra
dbcli describe-job -i $(dbcli list-jobs | grep Infra | tail -1 | cut -f1 -d' ')
Manually update...
dbcli update-infra