Diagnostics

Install / Uninstall  Autonomous Health Framework

18 Apr. 2023 /

Das Mittel der Wahl, um Informationen wie Healthchecks oder Diagnostic Collections zu bekommen, ist das Autonomous Health Framework (AHF)

In einfachen Schritten lässt sich das AHF installieren.

Neben der Dokumentation und wichtigen FAQs findet sich auch die Software in dieser MOS Note:

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

Wenn die Software in ein entsprechendes Verzeichnis auf dem Server geladen und entpackt ist, kann sie mit ahf_setup ausgeführt werden.

Zur Installation des AHF sind nur wenige Angaben nötig:

  1. Wo soll die Software installiert werden? [DEFAULT: /opt/oracle.ahf]
  2. In welchem Verzeichnis werden die Diagnose Daten und Metadaten abgelegt?
  3. Sollen Benachrichtigungen per eMail versendet werden?
  4. My Oracle Support Zugangsdaten können gespeichert werden.

Die entsprechenden Stellen sind unten im Output markiert.

Anschließend wird AHF auf dem Server installiert. In einer Clusterinstallation auch auf den weiteren Clusterknoten.

[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/

Nach einer erfolgreicher Installation ist der Status der Komponenten abrufbar. Und man sieht die Liste, welche Funktionen in diesem Framework aufrufbar sind.

[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.

Auch die Deinstallation des AHF ist denkbar einfach.

Mit dem Aufruf ahfctl uninstall werden alle Services gestoppt, anschließend die symbolischen links gelöscht und schließlich die Software und die Daten gelöscht.


[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
Automatic Upgrade Autonomous Health Framework
27 Apr. 2023
List OCI Ressources
30 Mai 2023

Leave a Reply

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert