1.6 Installing and Upgrading Oracle Autonomous Health Framework

Learn to install or upgrade Oracle Autonomous Health Framework on Linux, Unix, and Microsoft Windows operating systems.

1.6.1 Installing Oracle Autonomous Health Framework on Linux

Install Oracle Autonomous Health Framework as root to obtain the fullest capabilities. Oracle Autonomous Health Framework has reduced capabilities when you install it as a non-root user.

1.6.1.1 (Recommended) Installing on Linux or Unix as root User in Daemon Mode

To obtain the fullest capabilities of Oracle Autonomous Health Framework, install it as root.

Note:

Perl version 5.10 or later is required to install Oracle Autonomous Health Framework.

Oracle Autonomous Health Framework maintains Access Control Lists (ACLs) to determine which users are allowed access. By default, the GRID_HOME owner and ORACLE_HOME owners have access to their respective diagnostics. No other users can perform diagnostic collections.

If Oracle Autonomous Health Framework is already installed, then reinstalling performs an upgrade to the existing location.

To install as root:

  1. Download the Oracle Autonomous Health Framework zipped file, copy the downloaded file to the required machine, and then unzip the file.
  2. Run the ahf_setup command:
    ahf_setup
    If you plan to run only Oracle ORAchk or Oracle EXAchk and do not want to run any Oracle Trace File Analyzer processes, then use the install option of -extract -notfasetup.

The installation prompts you to do a local or cluster installation.

Cluster installation requires passwordless SSH user equivalency for root to all cluster nodes. If you have not already configured passwordless SSH user equivalency, then the installation optionally sets up passwordless SSH user equivalency and then removes at the end.

If you do not wish to use passwordless SSH, then you install Oracle Autonomous Health Framework on each host using a local installation. Run the tfactl syncnodes command to generate and deploy relevant SSL certificates.

Oracle Clusterware does not manage Oracle Autonomous Health Framework because Oracle Autonomous Health Framework must be available if Oracle Clusterware stops working.

The installation configures Oracle Autonomous Health Framework for auto-start. The implementation of auto-start is platform-dependent. Linux uses init, or an init replacement, such as upstart or systemd and Microsoft Windows uses a Windows service.

Installing Oracle Autonomous Health Framework as root on Linux or Solaris automatically sets up and runs the Oracle ORAchk or Oracle EXAchk daemon.

The daemon restarts at 1 am every day to discover any environment changes. The daemon runs a full local Oracle ORAchk check once every week at 3 am, and a partial run of the most impactful checks at 2 am every day through the oratier1 or exatier1 profiles. The daemon automatically purges the oratier1 or exatier1 profile run that runs daily, after a week. The daemon also automatically purges the full local run after 2 weeks. You can change the daemon settings after enabling auto start.

To remove auto start:
orachk -autostop
To auto start, run:
orachk -autostart

The installer prompts you to specify one or more email addresses of the recipients who can receive diagnostic notifications. Oracle Autonomous Health Framework notifies the recipients with the results of Oracle ORAchk and Oracle EXAchk compliance checking, or when Oracle Autonomous Health Framework detects significant faults.

1.6.1.2 Installing on Linux or UNIX as Non-root User in Non-Daemon Mode

If you are unable to install as root, then install Oracle Autonomous Health Framework as the Oracle home owner.

Note:

Perl version 5.10 or later is required to install Oracle Autonomous Health Framework.

Oracle Autonomous Health Framework has reduced capabilities when you install it as the non-root user in non-daemon mode. Therefore, you cannot complete the following tasks:

  • Automate diagnostic collections

  • Collect diagnostics from remote hosts

  • Collect files that are not readable by the Oracle home owner, for example, /var/log/messages, or certain Oracle Grid Infrastructure logs

To install as the Oracle home owner, use the –ahf_loc option, and optionally specify the -notfasetup option to prevent the running of any Oracle Trace File Analyzer processes.
ahf_setup -ahf_loc install_dir [-notfasetup]

For more information, run ahf_setup -h.

1.6.2 Installing AHF on Microsoft Windows

Install Oracle Trace File Analyzer as a Microsoft Windows service. Run the AHF compliance framework (ORAchk/EXAchk) on-demand.

Note:

You cannot install Oracle Autonomous Health Framework into a directory if there is a space in the name of the directory, for example, Program Files.

Strawberry Perl for Windows version 5.30 or later (OR) Perl 5 version 28 binaries located in Grid home, and .NET Framework version 4.0.30319 or later

  1. Copy the downloaded zip file to a temporary location on a required machine, and then unzip it.
  2. Open a command prompt as administrator, and then run the installer script by specifying a Perl home and the location where you want to install Oracle Autonomous Health Framework, for example:
    installahf.bat -perlhome D:\oracle\product\12.2.0\dbhome_1\perl -ahf_loc c:\AHF

    You can also run installahf.bat -perlhome D:\oracle\product\12.2.0\dbhome_1\perl and provide AHF location during installation when the installer prompts.

  3. To install AHF on Oracle Grid Infrastructure:
    installahf.bat -crshome crshome_path

For clusterwide AHF setup, perform a local installation on each host, and then run the tfactl syncnodes command to generate and deploy relevant SSL certificates.

1.6.3 Installing AHF on Oracle Big Data Appliance

Run the ahf_setup command to run Oracle Autonomous Health Framework on the Oracle Big Data Appliance.

  1. Download the Oracle Autonomous Health Framework zipped file to a directory on the Oracle Big Data Appliance, as root user.
  2. Run the ahf_setup command and you can optionally specify the –extract option.
    ahf_setup -ahf_loc install_dir

    For more information, run ahf_setup -help.

1.6.4 Maintaining Oracle Autonomous Health Framework to the Latest Version

Oracle releases a new version of Oracle Autonomous Health Framework approximately every three months.

Applying standard Release Update Revisions (RURs) automatically updates Oracle Autonomous Health Framework. However, the Release Update Revisions (RURs) do not contain the rest of the Oracle Database support tools bundle updates. Download the latest version of Oracle Autonomous Health Framework with Oracle Database support tools bundle from My Oracle Support note 2550798.1.

Upgrading is similar to first-time installation. As root, use the ahf_setup script. If Oracle Autonomous Health Framework is already installed, then the installer updates the existing installation. When already installed, a cluster upgrade does not need SSH. The cluster upgrade uses the existing daemon secure socket communication between hosts.

$ ahf_setup