Diagnostics

Install / Uninstall  Autonomous Health Framework

18 Apr 2023 /

The Autonomous Health Framework (AHF) is the tool of choice for obtaining information such as health checks or diagnostic collections.

The AHF can be installed in simple steps.

In addition to the documentation and important FAQs, the software can also be found in this MOS Note:

Autonomous Health Framework (AHF) – Including TFA and ORAchk/EXAchk (Doc ID 2550798.1)

Once the software has been copied into an appropriate directory on the server and has been unpacked, it can be executed with ahf_setup.

Only a few information are required for the installation of the AHF:

  1. Where should the software be installed? [DEFAULT: /opt/oracle.ahf]
  2. In which directory should the diagnostic data and metadata be stored?
  3. Should notifications be sent by email?
  4. My Oracle Support credentials can be saved.

The corresponding locations are marked at the bottom of the output.

AHF is then installed on the server. In a cluster installation also on the other cluster nodes.

[root@ra01dbadm01 AHF2123]# ./ahf_setup

AHF Installer for Platform Linux Architecture x86_64

AHF Installation Log : /tmp/ahf_install_212300_88621_2023_04_17-19_16_25.log

Starting Autonomous Health Framework (AHF) Installation

AHF Version: 21.2.3 Build Date: 202109091658

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.

Choose Data Directory from below options :

1. /u01/app/oracle [Free Space : 175637 MB]
2. Enter a different Location

Choose Option [1 - 2] : 1

AHF Data Directory : /u01/app/oracle/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. ra01dbadm02

The AHF Location and AHF Data Directory must exist on the above nodes
AHF Location : /opt/oracle.ahf
AHF Data Directory : /u01/app/oracle/oracle.ahf/data

Do you want to install/upgrade AHF on Cluster Nodes ? [Y]|N : Y

Extracting AHF to /opt/oracle.ahf

Configuring TFA Services

Discovering Nodes and Oracle Resources


TFA will configure Storage Cells using Existing SSH Setup:

Cells were configured via SSH.  Do you want to also store the Password for Cells in Oracle Wallet (Recommended): [Y]|N N
TFA-00002 Oracle Trace File Analyzer (TFA) is not running
.-----------------------------------.
|   | EXADATA CELL | CURRENT STATUS |
+---+--------------+----------------+
| 1 | ra01celadm01 | ONLINE         |
| 2 | ra01celadm02 | ONLINE         |
| 3 | ra01celadm03 | ONLINE         |
'---+--------------+----------------'


Not generating certificates as GI discovered

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             |
+-------------+---------------+-------+------+------------+----------------------+
| ra01dbadm01 | RUNNING       | 96583 | 5000 | 21.2.3.0.0 | 21230020210909165804 |
'-------------+---------------+-------+------+------------+----------------------'

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  | /u01/app/oracle/oracle.ahf/data                  |
| Repository      | /u01/app/oracle/oracle.ahf/data/repository       |
| Diag Directory  | /u01/app/oracle/oracle.ahf/data/ra01dbadm01/diag |
'-----------------+--------------------------------------------------'


Starting exachk scheduler from AHF ...

AHF install completed on ra01dbadm01

Installing AHF on Remote Nodes :

AHF will be installed on ra01dbadm02, Please wait.

Installing AHF on ra01dbadm02 :

[ra01dbadm02] Copying AHF Installer

[ra01dbadm02] Running AHF Installer

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_212300_88621_2023_04_17-19_16_25.log to /u01/app/oracle/oracle.ahf/data/ra01dbadm01/diag/ahf/

After a successful installation, the status of the components is available. And you can see the list of functions that can be called up in this framework.

[root@ra01dbadm01 AHF]#  tfactl toolstatus

Running command tfactltoolstatus on ra01dbadm01 ...

.------------------------------------------------------------------.
|                 TOOLS STATUS - HOST : ra01dbadm01                |
+----------------------+--------------+--------------+-------------+
| Tool Type            | Tool         | Version      | Status      |
+----------------------+--------------+--------------+-------------+
| AHF Utilities        | alertsummary |       21.2.3 | DEPLOYED    |
|                      | calog        |       21.2.3 | DEPLOYED    |
|                      | dbcheck      |       21.2.3 | DEPLOYED    |
|                      | dbglevel     |       21.2.3 | DEPLOYED    |
|                      | exachk       |       21.2.3 | DEPLOYED    |
|                      | grep         |       21.2.3 | DEPLOYED    |
|                      | history      |       21.2.3 | DEPLOYED    |
|                      | ls           |       21.2.3 | DEPLOYED    |
|                      | managelogs   |       21.2.3 | DEPLOYED    |
|                      | menu         |       21.2.3 | DEPLOYED    |
|                      | param        |       21.2.3 | DEPLOYED    |
|                      | ps           |       21.2.3 | DEPLOYED    |
|                      | pstack       |       21.2.3 | DEPLOYED    |
|                      | summary      |       21.2.3 | DEPLOYED    |
|                      | tail         |       21.2.3 | DEPLOYED    |
|                      | triage       |       21.2.3 | DEPLOYED    |
|                      | vi           |       21.2.3 | DEPLOYED    |
+----------------------+--------------+--------------+-------------+
| Development Tools    | oratop       |       14.1.2 | DEPLOYED    |
+----------------------+--------------+--------------+-------------+
| Support Tools Bundle | darda        | 2.10.0.R6036 | DEPLOYED    |
|                      | oswbb        | 22.2.0AHF    | NOT RUNNING |
|                      | prw          | 12.1.13.11.4 | NOT RUNNING |
'----------------------+--------------+--------------+-------------'

Note :-
  DEPLOYED    : Installed and Available - To be configured or run interactively.
  NOT RUNNING : Configured and Available - Currently turned off interactively.
  RUNNING     : Configured and Available.

Uninstalling the AHF is also very straightforward.

With the call ahfctl uninstall, all services are stopped, then the symbolic links are removed and finally the software and data are deleted.


[root@ra01dbadm01 ~]# ahfctl uninstall

AHF Uninstallation Log : /tmp/ahf_uninstall_395958_2023_04_17-18_55_13.log
Starting AHF Uninstall
NOTE : Uninstalling will delete the repository as well since Install type is GI
AHF will be uninstalled on:
ra01dbadm01
ra01dbadm02

Do you want to continue with AHF uninstall ? [Y]|N : Y

Stopping AHF service on local node ra01dbadm01...
Stopping TFA Support Tools...

Removed symlink /etc/systemd/system/multi-user.target.wants/oracle-tfa.service.
Removed symlink /etc/systemd/system/graphical.target.wants/oracle-tfa.service.

Stopping exachk scheduler ...
Removing exachk cache discovery....
Successfully completed exachk cache discovery removal.



Unable to send message to TFA



Removed exachk from inittab



Stopping and removing AHF in ra01dbadm02...


Removed symlink /etc/systemd/system/graphical.target.wants/oracle-tfa.service.
Removed symlink /etc/systemd/system/multi-user.target.wants/oracle-tfa.service.
Removing exachk cache discovery....
Successfully completed exachk cache discovery removal.



Unable to send message to TFA



Removed exachk from inittab


Successfully uninstalled AHF on node ra01dbadm02
Removing AHF setup on ra01dbadm01:
Removing /etc/rc.d/rc0.d/K17init.tfa
Removing /etc/rc.d/rc1.d/K17init.tfa
Removing /etc/rc.d/rc2.d/K17init.tfa
Removing /etc/rc.d/rc4.d/K17init.tfa
Removing /etc/rc.d/rc6.d/K17init.tfa
Removing /etc/init.d/init.tfa...
Removing /etc/systemd/system/oracle-tfa.service...
Removing /opt/oracle.ahf/rpms
Removing /opt/oracle.ahf/jre
Removing /opt/oracle.ahf/common
Removing /opt/oracle.ahf/bin
Removing /opt/oracle.ahf/python
Removing /opt/oracle.ahf/analyzer
Removing /opt/oracle.ahf/tfa
Removing /opt/oracle.ahf/chm
Removing /opt/oracle.ahf/ahf
Removing /opt/oracle.ahf/exachk
Removing /opt/oracle.ahf/ahfscope
Removing /opt/oracle.ahf/chadiag
Removing /opt/oracle.ahf/iwa
Removing /u01/app/oracle/oracle.ahf/data/ra01dbadm01
Removing /opt/oracle.ahf/install.properties
Removing /u01/app/oracle/oracle.ahf/data/repository
Removing /u01/app/oracle/oracle.ahf/data
Removing /u01/app/oracle/oracle.ahf
Removing /sys/fs/cgroup/cpu/oratfagroup/

You May Also Like

Manual Upgrade Autonomous Health Framework
25 Apr 2023
List OCI Ressources
30 May 2023
Automatic Upgrade Autonomous Health Framework
27 Apr 2023

Leave a Reply

Your email address will not be published. Required fields are marked *