1. Oracle Autonomous Health Framework User's Guide
  2. Installing AHF on Oracle Exadata Dom0

Installing AHF on Oracle Exadata Dom0

Install Oracle Autonomous Health Framework (AHF) on Oracle Exadata dom0 in standalone or typical mode, depending on whether you want to run the AHF scheduler.

The installation modes are:

  • Standalone: Extracts and configures only the required AHF components without starting TFA and Oracle Exachk schedulers.
  • Typical: Performs a full AHF installation and configures scheduling for features such as compliance checking.

Installing AHF in Standalone Mode on Exadata Dom0

Standalone mode is the default installation mode on Exadata dom0.

To install AHF in standalone mode, run:

./ahf_setup

Example:

# ./ahf_setup

AHF Installer for Platform Linux Architecture x86_64

AHF Installation Log :
/tmp/ahf_install_242000_45942_2024_02_27-22_19_10.log

Starting Autonomous Health Framework (AHF) Installation

AHF Version: 24.2.0
Build Date: 202402262228

Default AHF Location : /opt/oracle.ahf

Do you want to install AHF at [/opt/oracle.ahf] ? [Y]|N :

AHF Location : /opt/oracle.ahf
AHF Data Directory : /EXAVMIMAGES/oracle.ahf/data

Extracting AHF to /opt/oracle.ahf
Setting up AHF CLI and SDK

AHF is deployed at /opt/oracle.ahf
EXAchk is available at /opt/oracle.ahf/bin/exachk
AHF binaries are available in /opt/oracle.ahf/bin

Do you want to start TFA and EXAchk schedulers Y|[N] :

AHF is successfully Installed

Moving /tmp/ahf_install_242000_45942_2024_02_27-22_19_10.log to
/EXAVMIMAGES/oracle.ahf/data/scam02db01/diag/ahf/

Converting a Standalone Installation to a Typical Installation

To convert an existing standalone AHF installation on Exadata dom0 to a typical installation, use the -upgradetotypical option.

To perform the conversion without interactive prompts, also specify -silent:

./ahf_setup -upgradetotypical -silent

Example:

# ./ahf_setup -upgradetotypical -silent

AHF Installer for Platform Linux Architecture x86_64

AHF Installation Log :
/tmp/ahf_install_242000_123646_2024_02_27-22_50_39.log

Starting Autonomous Health Framework (AHF) Installation

AHF Version: 24.2.0
Build Date: 202402262228

AHF Location : /opt/oracle.ahf
Installed AHF Version: 24.1.1
Build Date: 202402210742

AHF Data Directory : /EXAVMIMAGES/oracle.ahf/data

Extracting AHF to /opt/oracle.ahf
Setting up AHF CLI and SDK

AHF is deployed at /opt/oracle.ahf
EXAchk is available at /opt/oracle.ahf/bin/exachk
AHF binaries are available in /opt/oracle.ahf/bin

Configuring TFA Services
Discovering Nodes and Oracle Resources
Successfully generated certificates.

Starting TFA Services

Created symlink from /etc/systemd/system/multi-user.target.wants/oracle-tfa.service
to /etc/systemd/system/oracle-tfa.service.

Created symlink from /etc/systemd/system/graphical.target.wants/oracle-tfa.service
to /etc/systemd/system/oracle-tfa.service.

.---------------------------------------------------------------------------------.
| Host       | Status of TFA | PID    | Port | Version    | Build ID              |
+------------+---------------+--------+------+------------+-----------------------+
| scam02db01 | RUNNING       | 143538 | 5000 | 24.2.0.0.0 | 240200020240226222853 |
'------------+---------------+--------+------+------------+-----------------------'

Running TFA Inventory...
Adding default users to TFA Access list...

.----------------------------------------------------------------.
|                  Summary of AHF Configuration                  |
+-----------------+----------------------------------------------+
| Parameter       | Value                                        |
+-----------------+----------------------------------------------+
| AHF Location    | /opt/oracle.ahf                              |
| TFA Location    | /opt/oracle.ahf/tfa                          |
| Exachk Location | /opt/oracle.ahf/exachk                       |
| Data Directory  | /EXAVMIMAGES/oracle.ahf/data                 |
| Repository      | /EXAVMIMAGES/oracle.ahf/data/repository      |
| Diag Directory  | /EXAVMIMAGES/oracle.ahf/data/scam02db01/diag |
'-----------------+----------------------------------------------'

Starting EXAchk Scheduler from AHF

AHF is successfully Installed

Moving /tmp/ahf_install_242000_123646_2024_02_27-22_50_39.log to
/EXAVMIMAGES/oracle.ahf/data/scam02db01/diag/ahf/

The -silent option prevents the installer from prompting for user input.

When the standalone installation is converted to a typical installation, the standalone data directory under /opt is moved to /EXAVMIMAGES.

Installing the AHF Scheduler Locally on Exadata Dom0

Use the -scheduler option to configure the AHF scheduler on the local Exadata dom0.

Run:

./ahf_setup -scheduler

Example:

# ./ahf_setup -scheduler

AHF Installer for Platform Linux Architecture x86_64

AHF Installation Log :
/tmp/ahf_install_242000_240604_2024_02_27-22_32_31.log

Starting Autonomous Health Framework (AHF) Installation

AHF Version: 24.2.0
Build Date: 202402262228

AHF Location : /opt/oracle.ahf
AHF Data Directory : /EXAVMIMAGES/oracle.ahf/data

Do you want to add AHF Notification Email IDs ? [Y]|N : N

Extracting AHF to /opt/oracle.ahf
Setting up AHF CLI and SDK
Configuring TFA Services
Discovering Nodes and Oracle Resources
Successfully generated certificates.

Starting TFA Services

.---------------------------------------------------------------------------------.
| Host       | Status of TFA | PID    | Port | Version    | Build ID              |
+------------+---------------+--------+------+------------+-----------------------+
| scam02db01 | RUNNING       | 254226 | 5000 | 24.2.0.0.0 | 240200020240226222853 |
'------------+---------------+--------+------+------------+-----------------------'

Running TFA Inventory...
Adding default users to TFA Access list...

.----------------------------------------------------------------.
|                  Summary of AHF Configuration                  |
+-----------------+----------------------------------------------+
| Parameter       | Value                                        |
+-----------------+----------------------------------------------+
| AHF Location    | /opt/oracle.ahf                              |
| TFA Location    | /opt/oracle.ahf/tfa                          |
| Exachk Location | /opt/oracle.ahf/exachk                       |
| Data Directory  | /EXAVMIMAGES/oracle.ahf/data                 |
| Repository      | /EXAVMIMAGES/oracle.ahf/data/repository      |
| Diag Directory  | /EXAVMIMAGES/oracle.ahf/data/scam02db01/diag |
'-----------------+----------------------------------------------'

Starting EXAchk 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] :

Moving /tmp/ahf_install_242000_240604_2024_02_27-22_32_31.log to
/EXAVMIMAGES/oracle.ahf/data/scam02db01/diag/ahf/

The -scheduler option installs and configures the scheduler only on the local dom0.

After installing AHF with the scheduler on all dom0 nodes, synchronize Oracle Trace File Analyzer across the nodes.

You can synchronize TFA using either SSH authentication or sockets.

Synchronizing TFA Using SSH

After installing the AHF scheduler on all dom0 nodes, run tfactl syncnodes on any one of the nodes.

tfactl syncnodes

When prompted, specify the remote nodes to synchronize.

Example:

# tfactl syncnodes

Please Enter all the remote nodes you want to sync...

Enter Remote Node List (separated by space) : node2

Node List to sync TFA Certificates :

    1  node2

Syncing TFA Certificates on node2 :

TFA_HOME on node2 : /opt/oracle.ahf/tfa
DATA_DIR on node2 : /opt/oracle.ahf/data/node2/tfa

Shutting down TFA on node2...
Copying TFA Certificates to node2...
Copying SSL Properties to node2...
Sleeping for 5 seconds...
Starting TFA on node2...

Trying to add node2 to TFA...

.------------------------------------------------------------------------------------------------------.
| Host          | Status of TFA | PID    | Port | Version    | Build ID             | Inventory Status |
+---------------+---------------+--------+------+------------+----------------------+------------------+
| node1         | RUNNING       | 148216 | 5000 | 22.1.0.0.0 | 22100020220411155753 | COMPLETE         |
| node2         | RUNNING       | 95897  | 5000 | 22.1.0.0.0 | 22100020220405120331 | COMPLETE         |
'---------------+---------------+--------+------+------------+----------------------+------------------'

Synchronizing TFA Using Sockets

After installing the AHF scheduler on all dom0 nodes, run tfactl syncnodes -nodes on all dom0 nodes and specify a comma-separated list containing all dom0 nodes.

tfactl syncnodes -nodes <comma-separated-list-of-all-dom0s>

For example:

tfactl syncnodes -nodes node1,node2

Example output:

# tfactl syncnodes -nodes node1,node2

Exadata Dom0 Node List : node1,node2

Please wait for 3 to 5 minutes for sync to complete.

.----------------------------------------------------------------------------------------------------.
| Host       | Status of TFA | PID   | Port | Version     | Build ID             | Inventory Status |
+------------+---------------+-------+------+-------------+----------------------+------------------+
| node1      | RUNNING       | 581   | 5000 | 23.10.0.0.0 | 231000020231013114958 | COMPLETE         |
| node2      | RUNNING       | 52602 | 5000 | 23.10.0.0.0 | 231000020231013114958 | COMPLETE         |
'------------+---------------+-------+------+-------------+----------------------+------------------'

SYNC MESSAGE : TFA Synced on all Cluster Nodes

.--------------------------.
| Node       | Sync Status |
+------------+-------------+
| node1      | SYNCED      |
| node2      | SYNCED      |
'------------+-------------'

Installing the AHF Scheduler on All Exadata Dom0 Nodes

The recommended method is to install the AHF scheduler on all Exadata dom0 nodes and synchronize the nodes as part of the installation.

Use:

ahf_setup -scheduler -nodes <comma-separated-list-of-remote-dom0s>

For example:

ahf_setup -scheduler -nodes node2

Example output:

# ahf_setup -scheduler -nodes node2

AHF Installer for Platform Linux Architecture x86_64

AHF Installation Log :
/tmp/ahf_install_221000_239748_2022_04_05-05_08_14.log

Starting Autonomous Health Framework (AHF) Installation

AHF Version: 22.1.0
Build Date: 202204051203

Default AHF Location : /opt/oracle.ahf

Do you want to install AHF at [/opt/oracle.ahf] ? [Y]|N :

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

AHF Data Directory : /opt/oracle.ahf/data

Do you want to add AHF Notification Email IDs ? [Y]|N : n

AHF will also be installed/upgraded on these Cluster Nodes :

1. node2

The AHF Location and AHF Data Directory must exist on the above nodes

AHF Location : /opt/oracle.ahf
AHF Data Directory : /opt/oracle.ahf/data

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             |
+---------------+---------------+--------+------+------------+----------------------+
| node1         | RUNNING       | 261388 | 5000 | 22.1.0.0.0 | 22100020220405120331 |
'---------------+---------------+--------+------+------------+----------------------'

Running TFA Inventory...
Adding default users to TFA Access list...

.-----------------------------------------------------------.
|                Summary of AHF Configuration               |
+-----------------+-----------------------------------------+
| Parameter       | Value                                   |
+-----------------+-----------------------------------------+
| AHF Location    | /opt/oracle.ahf                         |
| TFA Location    | /opt/oracle.ahf/tfa                     |
| Exachk Location | /opt/oracle.ahf/exachk                  |
| Data Directory  | /opt/oracle.ahf/data                    |
| Repository      | /opt/oracle.ahf/data/repository         |
| Diag Directory  | /opt/oracle.ahf/data/node1/diag         |
'-----------------+-----------------------------------------'

Starting exachk scheduler from AHF ...

AHF install completed on node1

Installing AHF on Remote Nodes :

AHF will be installed on node2, Please wait.

Installing AHF on node2 :

[node2] Copying AHF Installer
[node1] Running AHF Installer
[node2] Syncing TFA Certificates
[node2] Restarting TFA

.------------------------------------------------------------------------------------------------------.
| Host          | Status of TFA | PID    | Port | Version    | Build ID             | Inventory Status |
+---------------+---------------+--------+------+------------+----------------------+------------------+
| node1         | RUNNING       | 261388 | 5000 | 22.1.0.0.0 | 22100020220405120331 | COMPLETE         |
| node2         | RUNNING       | 113878 | 5000 | 22.1.0.0.0 | 22100020220405120331 | COMPLETE         |
'---------------+---------------+--------+------+------------+----------------------+------------------'

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_221000_239748_2022_04_05-05_08_14.log to
/opt/oracle.ahf/data/node1/diag/ahf/

This method installs the scheduler on the local dom0, installs or upgrades AHF on the specified remote dom0 nodes, and synchronizes the TFA certificates across the nodes.

For information about controlling AHF resource consumption on dom0, see Running AHFCTL Commands to Limit CPU and Memory Usage.