Installing Autonomous Health Framework (AHF) on a Single-Instance System

On a single-instance Oracle Database system, the first invocation of tfactl, ahfctl, or orachk initiates the Oracle Autonomous Health Framework (AHF) installation.

1. Verify that the AHF commands are available from the Oracle Database home.

   To verify tfactl:

   which tfactl

   Example output:

   /u01/app/<user>/product/db23.26/dbhome_1/bin/tfactl

   To verify orachk:

   which orachk

   Example output:

   /u01/app/<user>/product/db23.26/dbhome_1/bin/orachk

   To verify ahfctl:

   which ahfctl

   Example output:

   /u01/app/<user>/product/db23.26/dbhome_1/bin/ahfctl

2. Run one of the AHF commands for the first time to initiate the installation.

   For example:

   tfactl print status

3. Follow the installation prompts.

   The installer displays the default AHF installation location and prompts you to confirm it.

   Example:

   $ tfactl print status
   
   AHF Installer for Platform Linux Architecture x86_64
   
   AHF Installation Log :
   /tmp/ahf_install_262000_1939344_2026_07_16-00_22_27.log
   
   Starting Autonomous Health Framework (AHF) Installation
   
   AHF Version: 26.2.0
   Build Date: 202602241817
   
   Default AHF Location : /u01/app/<user>/oracle.ahf
   
   Do you want to install AHF at [/u01/app/<user>/oracle.ahf] ? [Y]|N : Y
   
   AHF Location : /u01/app/<user>/oracle.ahf
   AHF Data Directory : /u01/app/<user>/oracle.ahf/data
   
   Extracting AHF to /u01/app/<user>/oracle.ahf
   Setting up AHF CLI and SDK
   
   Configuring TFA in Standalone Mode...
   
   Build Version : 2602000
   Build Date : 202602241817
   
   Discovering Nodes and Oracle Resources
   
   .-----------------------------------------------------------------------------.
   |                    Summary of TFA Configuration                             |
   +----------------+------------------------------------------------------------+
   | Parameter      | Value                                                      |
   +----------------+------------------------------------------------------------+
   | TFA Location   | /u01/app/<user>/oracle.ahf/tfa                             |
   | Data Directory | /u01/app/<user>/oracle.ahf/data/<host>/tfa                 |
   | Repository     | /u01/app/<user>/oracle.ahf/data/repository                 |
   | Diag Directory | /u01/app/<user>/oracle.ahf/data/<host>/diag/tfa            |
   | Java Home      | /u01/app/<user>/product/db23.26/dbhome_1/jdk               |
   '----------------+------------------------------------------------------------'
   
   .--------------------------------------------------------------------------------------------------------.
   | Host           | Status of TFA | PID | Port    | Version    | Build ID             | Inventory Status |
   +----------------+---------------+-----+---------+------------+----------------------+------------------+
   | <host>         | RUNNING       | -   | OFFLINE | 26.2.0.0.0 | 260200020260224181710 | COMPLETED        |
   '----------------+---------------+-----+---------+------------+----------------------+------------------'
   
   AHF is deployed at /u01/app/<user>/oracle.ahf
   
   ORAchk is available at /u01/app/<user>/oracle.ahf/bin/orachk
   
   AHF binaries are available in /u01/app/<user>/oracle.ahf/bin
   
   AHF is successfully Installed
   
   Moving /tmp/ahf_install_262000_1939344_2026_07_16-00_22_27.log to
   /u01/app/<user>/oracle.ahf/data/<host>/diag/ahf/

After AHF is installed, subsequent invocations of tfactl, ahfctl, or orachk do not invoke the installer.

To verify the current AHF status, run:

tfactl print status

Example output:

.------------------------------------------------------------------------------------------------.
| Host   | Status of TFA | PID | Port    | Version    | Build ID             | Inventory Status |
+--------+---------------+-----+---------+------------+----------------------+------------------+
| <host> | RUNNING       | -   | OFFLINE | 26.2.0.0.0 | 260200020260224181710 | COMPLETED        |
'--------+---------------+-----+---------+------------+----------------------+------------------'

You can also verify the AHF status using ahfctl:

ahfctl statusahf

Example output:

.------------------------------------------------------------------------------------------------.
| Host   | Status of TFA | PID | Port    | Version    | Build ID             | Inventory Status |
+--------+---------------+-----+---------+------------+----------------------+------------------+
| <host> | RUNNING       | -   | OFFLINE | 26.2.0.0.0 | 260200020260224181710 | COMPLETED        |
'--------+---------------+-----+---------+------------+----------------------+------------------'

orachk daemon is not running