Oracle Autonomous Health Framework Installation Command-Line Options

E.1 Oracle Autonomous Health Framework Installation Command-Line Options

Understand the options that you can supply to the Oracle Autonomous Health Framework installer script to customize the installation.

The Oracle Autonomous Health Framework installer script:

Takes you through an interview process if you do not specify any installation parameters.
Appends /oracle.ahf to -ahf_loc if it does not already exist.
Appends /oracle.ahf/data to -data_dir if it does not already exist.
Writes the log to the /tmp/ahf_install_timestamp.log file, for example, /tmp/ahf_install_9263_2018_09_25-07_55_52.log.

Syntax

ahf_setup 
[-ahf_loc AHF Location]
[-data_dir AHF Repository]
[-nodes node1,node2]
[-extract[orachk|exachk|-notfasetup]]
[-force]
[-local]
[-silent]
[-tmp_loc directory]
[-debug [-level 1-6]]

Parameters

Table E-1 ahf_setup Command Parameters

Parameter	Description
`-ahf_loc`	Specify the installation directory. Ensure that this directory exists before trying this option.
`-data_dir`	Specify the data directory where Oracle Autonomous Health Framework stores all the collections, metadata, and so on. Ensure that this directory exists before trying this option.
`-nodes`	By default, Oracle Autonomous Health Framework is installed on all the cluster nodes. Specify a comma-delimited list of nodes where you want to install AHF.
`-extract`	Extracts the files from the installer. This option is default for non-root users. Specify the `-notfasetup` option just to extract and not to configure Oracle Trace File Analyzer. Run the `ahf_setup -extract [exachk\|orachk]` command to install a local copy of Oracle ORAchk or Oracle EXAchk without installing the rest of AHF.
`-force`	The `-force` option is applicable only when you specify the compliance type `orachk` or `exachk` with the `-extract` option else the installer script ignores the `-force` option. `-extract orachk\|exachk`
`-local`	Installs only on the local node.
`-silent`	Use this option for the Oracle Autonomous Health Framework installer script not to prompt any installation questions. If you use `-silent` option, then ensure that you use `-data_dir` option. The installer script fails if you do not use `-data_dir` option.
`-tmp_loc`	Specify a temporary ___location for the Oracle Autonomous Health Framework installer script to extract the install archive. Ensure that this directory exists before trying this option. Default: `/tmp`.
`-perlhome`	Specify a custom ___location for Perl binaries.
`-debug`	Debugs the Oracle Autonomous Health Framework installer script.
`-level`	Specify the Oracle Autonomous Health Framework Install debug level. Default `4` with option `-debug`. `1` - FATAL `2` - ERROR `3` - WARNING `4` - INFO `5` - DEBUG `6` - TRACE

Understanding the Location of the Data Directory

If you install Oracle Autonomous Health Framework using the -data_dir option, then the installer script uses the ___location that you specify. The installer script will not create the specified data directory so ensure that this directory exists before trying the -data_dir option. You can specify a new data directory either under the current Oracle Trace File Analyzer install ___location or under a different directory.
If you install Oracle Autonomous Health Framework using the -silent option, then ensure that you use the -data_dir option, otherwise, the installer script will fail.
If you install Oracle Autonomous Health Framework without the -data_dir option, then the installer script will list all possible options:
- Oracle Autonomous Health Framework installation ___location (-ahf_loc) if the free space is more than 5 GB
- Oracle Trace File Analyzer repository if installed outside the Oracle Grid Infrastructure Home
- Directory one level above the Oracle Grid Infrastructure Base
- Option to enter a different directory

If you do not use the -silent option and do not specify –ahf_loc and –data_dir, then the installer script displays the default options for you to confirm.

For example:

# /tmp/ahf_setup -nodes node1

AHF Installation Log : /tmp/ahf_install_15992_2019_10_10-08_07_38.log

Starting Autonomous Health Framework (AHF) Installation

AHF Version: 193000 Build Date: 201910100757

Default AHF Location : /opt/oracle.ahf

Do you want to update default AHF Location ? Y|[N] : 

AHF Location : /opt/oracle.ahf

Choose Data Directory from below options : 

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

Choose Option [1 - 2] : 1

AHF Data Directory : /u01/app/oracle.ahf/data

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

Extracting AHF to /opt/oracle.ahf

Parent topic: Oracle Autonomous Health Framework Command-Line and Shell Options