Autonomous Health Framework (AHF)安装/升级

Production Releases
Released	Download
Nov 2022	 AHF 22.3.1 for Linux
Nov 2022	 AHF 22.3.1 for ZLinux
Nov 2022	 AHF 22.3.1 for ARM64
Nov 2022	 AHF 22.3.1 for Solaris x86
Nov 2022	 AHF 22.3.1 for Solaris SPARC 64
Nov 2022	 AHF 22.3.1 for AIX 6 & 7
Nov 2022	 AHF 22.3.1 for Windows (64bit)
Nov 2022	 AHF 22.3.1 for HPUX

The easiest way to maintain AHF is to use auto upgrade:

Configure AHF auto upgrade: ahfctl setupgrade -swstage /scratch/ahf_stage -autoupgrade on -frequency 7
When a new version of AHF is available, simply download and stage in the swstage directory
AHF will detect the new version (based on the checking frequency you specified) and auto upgrade
For more details see ahfctl upgrade commands

AHF is included in Database 12+ and Grid Infrastructure 12+ Release Updates, these are the recent AHF versions along with the corresponding RU release version they are shipped in.

复制

The Autonomous Health Framework (AHF) installer includes:

TFA

Primary diagnostic collection tool, with Database Support Tools Bundle

ORAchk / EXAchk

Oracle Stack Compliance Checks

procwatcher

Automate & capture database performance diagnostics & session level hangs

See 459694.1 for more details.

events

Reports warnings and errors seen in the logs

managelogs

Shows disk space usage and purges ADR log and trace files

alertsummary

Provides summary of events for one or more database or ASM alert files from all nodes

ls / dir

Lists all files TFA knows about for a given file name pattern across all nodes

summary

High level summary of the configuration

vi / notepad

Open alert or trace files for viewing a given database and file name pattern in the vi editor

tail

Run a tail on an alert or trace files for a given database and file name pattern

param

Show all database and OS parameters that match a specified pattern

oswatcher

Collect and archive OS metrics, useful for instance / node evictions & performance Issues.

See 301137.1 for more details.

oratop

Near real-time database monitoring

See 1500864.1 for more details.

pstack

Generate process stack for specified processes across all nodes

grep / findstr

Search alert or trace files with a given database and file name pattern, for a search string

dbglevel

Set and unset multiple CRS trace levels with one command

history

Show the shell history for the tfactl shell

changes

Report any noted changes in the system setup over a given time period. This includes database a parameters, OS parameters, patches applied etc

calog

Reports major events from the Cluster Event log

ps / tasklist

Finds processes

triage

Summarize oswatcher/exawatcher data

静默方式（-silent）

[root@AHFtest01 ~]# unzip /home/oracle/AHF-LINUX_v22.3.1.zip -d .

Archive:  /home/oracle/AHF-LINUX_v22.3.1.zip
  inflating: ./README.txt
  inflating: ./ahf_setup
 extracting: ./ahf_setup.dat
  inflating: ./oracle-tfa.pub
复制

[root@AHFtest01 ~]# chown -R root:oinstall AHF_data/ ahf_setup* oracle-tfa.pub
[root@AHFtest01 ~]# ll

drwxr-xr-x  2 root   oinstall         6 Dec  8 13:12 AHF_data
-r-xr-xr-x  1 root   oinstall 505832109 Dec  1 09:18 ahf_setup
-rw-r--r--  1 root   oinstall       384 Dec  1 09:18 ahf_setup.dat
-rw-r--r--  1 root   oinstall       625 Dec  1 09:18 oracle-tfa.pub
-rw-r--r--  1 root   root          1525 Dec  1 09:18 README.txt
复制

[root@AHFtest01 ~]# ./ahf_setup help

AHF Installer for Platform Linux Architecture x86_64
AHF-00003: Invalid Option help for AHF

   Usage for ./ahf_setup

   ./ahf_setup [[-ahf_loc <location>][-data_dir <location>][-nodes <n1,n2>][-extract[orachk|exachk|-notfasetup] [-local][-silent][-tmp_loc <directory>][-force][-autorun_window <hours>][-debug [-level <1-6>]]]

        -ahf_loc          -    Install into the directory supplied. (Default /opt/oracle.ahf)
        -data_dir         -    AHF Data Directory where all the collections, metadata, etc. will be stored
        -nodes            -    Comma separated Remote Node List
        -extract          -    Extract only files from Installer. (Default for non-root users)
        -nosymlink        -    Do not create symlinks on Exadata DOM0. (Default for non-root users)
        -notfasetup       -    Do not Configure TFA when used with -extract
        -local            -    Only install on the local node
        -silent           -    Do not ask any install questions
        -tmp_loc          -    Temporary location directory for AHF to extract the install archive to (must exist) (Default /tmp)
        -perlhome         -    Custom location of perl binaries
        -force            -    Force AHF Install
        -debug            -    Debug AHF Install Script
        -autorun_window   -    Apply autorun_window value in hours (0-23) to AHF compliance schedules
        -level            -    AHF Instal Debug Level 1-6 (Default 4 with option -debug)
                               [FATAL - 1, ERROR - 2, WARNING - 3, INFO - 4, DEBUG - 5, TRACE - 6]
        -setupmos         -    Setup My Oracle Support configuration.
        -nosetupmos       -    Do not prompt for My Oracle Support configuration.

   Note :
   1. Without parameters AHF will take you through an interview process for installation
   2. If -silent option is used, then ensure that you use the -data_dir option, otherwise, the installer script will fail
   3. The -force option is used for expert installations only, this flag will override all installer checks

复制

[root@AHFtest01 ~]# ./ahf_setup -ahf_loc /opt -silent -data_dir /root/AHF_data

AHF Installer for Platform Linux Architecture x86_64

AHF Installation Log : /tmp/ahf_install_223100_228434_2022_12_08-09_25_21.log

Starting Autonomous Health Framework (AHF) Installation

AHF Version: 22.3.1 Build Date: 202211301442

AHF is already installed at /opt/oracle.ahf

Installed AHF Version: 19.3.1 Build Date: 201911181744

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

1. AHFtest02

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

Upgrading /opt/oracle.ahf

Shutting down AHF Services

Upgrading AHF Services

Starting AHF Services

AHF upgrade completed on AHFtest01

Upgrading AHF on Remote Nodes :

AHF will be installed on AHFtest02, Please wait.

AHF will not perform install/upgrade on AHFtest02 as -silent in enabled

AHF is successfully upgraded to latest version

.-----------------------------------------------------------------.
| Host      | TFA Version | TFA Build ID         | Upgrade Status |
+-----------+-------------+----------------------+----------------+
| AHFtest01 |  22.3.1.0.0 | 22310020221130144218 | UPGRADED       |
| AHFtest02 |  19.3.1.0.0 | 19310020191118174453 | NOT UPGRADED   |
'-----------+-------------+----------------------+----------------'

Setting up AHF CLI and SDK

Moving /tmp/ahf_install_223100_228434_2022_12_08-09_25_21.log to /u01/app/oracle.ahf/data/AHFtest01/diag/ahf/
[root@AHFtest01 ~]#
复制

[root@AHFtest02 ~]# unzip /home/oracle/AHF-LINUX_v22.3.1.zip -d .

Archive:  /home/oracle/AHF-LINUX_v22.3.1.zip
  inflating: ./README.txt
  inflating: ./ahf_setup
 extracting: ./ahf_setup.dat
  inflating: ./oracle-tfa.pub
复制

[root@AHFtest02 ~]# chown -R root:oinstall AHF_data/ ahf_setup* oracle-tfa.pub
[root@AHFtest02 ~]# ll

drwxr-xr-x  2 root   oinstall         6 Dec  8 13:12 AHF_data
-r-xr-xr-x  1 root   oinstall 505832109 Dec  1 09:18 ahf_setup
-rw-r--r--  1 root   oinstall       384 Dec  1 09:18 ahf_setup.dat
-rw-r--r--  1 root   oinstall       625 Dec  1 09:18 oracle-tfa.pub
-rw-r--r--  1 root   root          1525 Dec  1 09:18 README.txt
复制

[root@AHFtest02 ~]# ./ahf_setup -ahf_loc /opt -silent -data_dir /root/AHF_data

AHF Installer for Platform Linux Architecture x86_64

AHF Installation Log : /tmp/ahf_install_223100_52135_2022_12_08-13_14_32.log

Starting Autonomous Health Framework (AHF) Installation

AHF Version: 22.3.1 Build Date: 202211301442

AHF is already installed at /opt/oracle.ahf

Installed AHF Version: 19.3.1 Build Date: 201911181744

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

1. AHFtest01

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

Upgrading /opt/oracle.ahf

Shutting down AHF Services

Upgrading AHF Services

Starting AHF Services

AHF upgrade completed on AHFtest02

Upgrading AHF on Remote Nodes :

AHF will be installed on AHFtest01, Please wait.

AHF will not perform install/upgrade on AHFtest01 as -silent in enabled

AHF is successfully upgraded to latest version

.-----------------------------------------------------------------.
| Host      | TFA Version | TFA Build ID         | Upgrade Status |
+-----------+-------------+----------------------+----------------+
| AHFtest02 |  22.3.1.0.0 | 22310020221130144218 | UPGRADED       |
| AHFtest01 |  22.3.1.0.0 | 22310020221130144218 | UPGRADED       |
'-----------+-------------+----------------------+----------------'

Setting up AHF CLI and SDK

Moving /tmp/ahf_install_223100_52135_2022_12_08-13_14_32.log to /u01/app/oracle.ahf/data/AHFtest02/diag/ahf/

[root@AHFtest02 ~]#
复制

[root@klarity02 ~]# ahfctl -h

Usage : ahfctl <command> [options]
        | applypatch
        | applyupdate
        | celldiagcollect
        | checkpassword
        | checksmtp
        | checkupload
        | compliance
        | deleteupdatebackup
        | get
        | getosgroup
        | getresourcelimit
        | getsmtp
        | getupdate
        | getupgrade
        | getupload
        | import
        | loadpolicy
        | printresourcestats
        | querypatch
        | queryupdate
        | redact
        | rmap
        | rollbackpatch
        | rollbackupdate
        | set
        | setosgroup
        | setpassword
        | setresourcelimit
        | setsmtp
        | setupdate
        | setupgrade
        | setupload
        | showrepo
        | startahf
        | statusahf
        | stopahf
        | switch
        | uninstall
        | unloadpolicy
        | unset
        | unsetpassword
        | unsetresourcelimit
        | unsetsmtp
        | unsetupdate
        | unsetupgrade
        | unsetupload
        | update
        | upgrade
        | upgradehistory
        | upload
        | version

For detailed help on each command use: ahfctl <command> -h
复制

[root@klarity02 ~]# ahfctl version

AHF version: 22.3.1
复制

[root@klarity02 ~]# ahf -h

usage: ahf category action [options]

category:
  {analysis,configuration,software}
    analysis            Analysis category actions
    configuration       Configuration category actions
    software            Software category actions

options:
  -h, --help            show this help message and exit
  --version, -v         Get version
AHF-01000: internal error: 0
Cause:     'ahf' encountered an internal error.
Action:    Open a Service Request and provide the log file to Oracle Support.
复制

[root@klarity02 ~]# ahf -v

AHF version: 22.3.1.0.0
Build Timestamp: 20221130144218
复制

应答式安装（两节点同时安装）

[oracle@AHFdb11 oracle]$ ./ahf_setup -data_dir ./AHF_data/

AHF Installer for Platform Linux Architecture x86_64

AHF Installation Log : /tmp/ahf_install_223100_430863_2022_12_08-15_11_21.log

Starting Autonomous Health Framework (AHF) Installation

AHF Version: 22.3.1 Build Date: 202211301442

[ERROR] : AHF-00006: AHF has already been installed as root user. Please contact Administrator to be provided access.

[oracle@AHFdb11 oracle]$ exit
logout
[root@AHFdb11 ~]# cd /u01/app/oracle
[root@AHFdb11 oracle]# ./ahf_setup -data_dir ./AHF_data/

AHF Installer for Platform Linux Architecture x86_64

AHF Installation Log : /tmp/ahf_install_223100_431497_2022_12_08-15_11_51.log

Starting Autonomous Health Framework (AHF) Installation

AHF Version: 22.3.1 Build Date: 202211301442

AHF is already installed at /opt/oracle.ahf

Installed AHF Version: 21.4.2 Build Date: 202202111356

Do you want to upgrade AHF [Y]|N : Y

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

1. AHFdb12

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

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

Upgrading /opt/oracle.ahf

Shutting down AHF Services

Upgrading AHF Services

Starting AHF Services
No new directories were added to TFA
Directory /u01/app/grid/crsdata/AHFdb11/trace/chad was already added to TFA Directories.

AHF upgrade completed on AHFdb11

Upgrading AHF on Remote Nodes :

AHF will be installed on AHFdb12, Please wait.

Upgrading AHF on AHFdb12 :

[AHFdb12] Copying AHF Installer

[AHFdb12] Running AHF Installer

Do you want AHF to store your My Oracle Support Credentials for Automatic Upload ? Y|[N] : N

AHF is successfully upgraded to latest version

.---------------------------------------------------------------.
| Host    | TFA Version | TFA Build ID         | Upgrade Status |
+---------+-------------+----------------------+----------------+
| AHFdb11 |  22.3.1.0.0 | 22310020221130144218 | UPGRADED       |
| AHFdb12 |  22.3.1.0.0 | 22310020221130144218 | UPGRADED       |
'---------+-------------+----------------------+----------------'

Setting up AHF CLI and SDK

Moving /tmp/ahf_install_223100_431497_2022_12_08-15_11_51.log to /u01/app/oracle.ahf/data/AHFdb11/diag/ahf/

[root@AHFdb11 oracle]#

复制