Tfactl has many advantages, and also support oracle uses this tool to troubleshoot and identify performance issues and to collect all database system wide errors.

This tool is preinstalled for RAC

To check if tfactl is installed and check the tfa home

grep TFA_HOME= /etc/init.d/init.tfa

If it would give a output such as

[root@xxxxxx ~]# grep TFA_HOME= /etc/init.d/init.tfa
TFA_HOME=/opt/oracle.ahf/tfa

Download and unzip the tfa installation file according to the document: Doc ID 2550798.1

[root@xxxx haf]# unzip AHF-LINUX_v24.11.0.zip
Archive:  AHF-LINUX_v24.11.0.zip
  inflating: ahf_setup
 extracting: ahf_setup.dat
  inflating: README.txt
  inflating: oracle-tfa.pub
[root@lxxxx  haf]# ls -ltr
total 623676
-rwx------. 1 root root 325905790 Dec  5 10:13 ahf_setup
-rw-------. 1 root root       384 Dec  5 10:13 ahf_setup.dat
-r-xr-x---. 1 root root      1537 Dec  5 10:14 README.txt
-r--------. 1 root root       625 Dec  5 10:14 oracle-tfa.pub
-rw-r--r--. 1 root root 312724035 Jan  9 10:37 AHF-LINUX_v24.11.0.zip

With root user, run the setup

[root@xxxxx haf]# ./ahf_setup -data_dir /u01/app/tfa/output -ahf_loc /u01/app/tfa

AHF Installer for Platform Linux Architecture x86_64

AHF Installation Log : /tmp/ahf_install_2411000_1770132_2025_01_09-11_10_15.log

Starting Autonomous Health Framework (AHF) Installation

AHF Version: 24.11.0 Build Date: 202412050058

PERL : /u01/app/19.0.0.0/grid/perl/bin/perl

[ERROR] : AHF-00026: Perl is not owned by root.  AHF Requires Perl to be root owned for AHF Installations as the root user.

We should copy the path of perl in the above error to the /opt/perl and change the permission of this directory in the /opt/perl path, as suggested by Doc ID 2884071.1

[root@xxx perl]# cp -pR   /u01/app/19.0.0.0/grid/perl /opt/perl
[root@xxx perl]# chown -R root:oinstall /opt/perl

Run the command again with the perl home option: perlhome /opt/perl

[root@lxdbaseora01q haf]# ./ahf_setup -data_dir /u01/tfa/output -ahf_loc /u01/tfa/  -perlhome /opt/perl

AHF Installer for Platform Linux Architecture x86_64

AHF Installation Log : /tmp/ahf_install_2411000_1782840_2025_01_09-11_38_14.log

Starting Autonomous Health Framework (AHF) Installation

AHF Version: 24.11.0 Build Date: 202412050058

AHF Location : /u01/tfa/oracle.ahf

[ERROR] : AHF-00014: AHF Location /u01/tfa/oracle.ahf is not owned by root in directory hierarchy

It is necessary to use a location owned by root in hierarchy, be aware that AHF Data Directory requires at least 5GB (Recommended 10GB) of free space.

Otherwise, if you have no free space on other paths, use it for your own risk, set the environment variable: AHF_OVERRIDE_INSTALL_CHECKS (source: How to Install AHF when you encounter AHF-00014 ? – oratrails-aish)


[root@xxx haf]# export AHF_OVERRIDE_INSTALL_CHECKS=1
[root@xxx haf]# ./ahf_setup -data_dir /u01/tfa/output -ahf_loc /u01/tfa/  -perlhome /opt/perl

AHF Installer for Platform Linux Architecture x86_64

AHF Installation Log : /tmp/ahf_install_2411000_1790730_2025_01_09-11_55_53.log

Starting Autonomous Health Framework (AHF) Installation

AHF Version: 24.11.0 Build Date: 202412050058

AHF Location : /u01/tfa/oracle.ahf

Suppressing 'AHF-00014: AHF Location /u01/tfa/oracle.ahf is not owned by root in directory hierarchy' as -force is enabled

AHF Data Directory : /u01/tfa/output/oracle.ahf/data

Suppressing AHF-00014: AHF Data Location /u01/tfa/output/oracle.ahf/data is not owned by root in directory hierarchy as -force is enabled

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

Extracting AHF to /u01/tfa/oracle.ahf

Setting up AHF CLI and SDK
/u01/tfa/oracle.ahf/shm/_installshm.sh: /u01/tfa/oracle.ahf/shm/install/crfinst.pl: /usr/bin/perl: bad interpreter: No such file or directory

Configuring TFA Services

Discovering Nodes and Oracle Resources

Not generating certificates as GI discovered

Starting TFA Services
Created symlink /etc/systemd/system/multi-user.target.wants/oracle-tfa.service -> /etc/systemd/system/oracle-tfa.service.
Created symlink /etc/systemd/system/graphical.target.wants/oracle-tfa.service -> /etc/systemd/system/oracle-tfa.service.

.--------------------------------------------------------------------------------------.
| Host          | Status of TFA | PID     | Port | Version     | Build ID              |
+---------------+---------------+---------+------+-------------+-----------------------+
| lxdbaseora01q | RUNNING       | 1793271 | 5000 | 24.11.0.0.0 | 241100020241205005852 |
'---------------+---------------+---------+------+-------------+-----------------------'

Running TFA Inventory...

Adding default users to TFA Access list...

.----------------------------------------------------------------------.
|                     Summary of AHF Configuration                     |
+-----------------+----------------------------------------------------+
| Parameter       | Value                                              |
+-----------------+----------------------------------------------------+
| AHF Location    | /u01/tfa/oracle.ahf                                |
| TFA Location    | /u01/tfa/oracle.ahf/tfa                            |
| Orachk Location | /u01/tfa/oracle.ahf/orachk                         |
| Data Directory  | /u01/tfa/output/oracle.ahf/data                    |
| Repository      | /u01/tfa/output/oracle.ahf/data/repository         |
| Diag Directory  | /u01/tfa/output/oracle.ahf/data/xxx/diag |
'-----------------+----------------------------------------------------'

Starting ORAchk Scheduler from AHF

AHF binaries are available in /u01/tfa/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_2411000_1790730_2025_01_09-11_55_53.log to /u01/tfa/output/oracle.ahf/data/xxx/diag/ahf/

 

Support documents: ORACLE-BASE – Oracle Trace File Analyzer (TFA)

Download tfa tool: Autonomous Health Framework (AHF) – Including Trace File Analyzer and Orachk/Exachk (Doc ID 2550798.1)

Podcast also available on PocketCasts, SoundCloud, Spotify, Google Podcasts, Apple Podcasts, and RSS.

Leave a comment

The Blog

About the Blog