Verifying the Oracle health check binaries and intentional offline for an instance of Oracle

Last published : Oct 21, 2026
This section describes the steps to verify the state of Oracle instance, the Oracle health check binaries, and intentional offline behavior for an Oracle agent.
Note: The steps listed in the table below should be executed by the operating system user specified in Owner attribute.
Table: Oracle health check options lists the checks you can verify with Oracle health check binaries.

Table: Oracle health check options

Verify Solution
If the ORACLE_HOME variable is set. Run the following command to verify that the $ORACLE_HOME variable is correctly set.
# echo $ORACLE_HOME
Set the ORACLE_HOME environment variable if it is not already set.
For example, run the following command to set the ORACLE_HOME variable:
lang=bash
\# export ORACLE_HOME=/u01/oraHome
where /u01/oraHome is the Oracle home directory path.
If the SID for the Oracle instance is set. Run the following command to verify that the $ORACLE_SID variable is correctly set.
# echo $ORACLE_SID
If required, run the # export ORACLE_SID=db command to set the $ORACLE_SID variable.
If the library path is set. Run the following command to verify that the $LD_LIBRARY_PATH variable is correctly set.
# echo $LD_LIBRARY_PATH
If required, run the # export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH command to set the $LD_LIBRARY_PATH variable.
If the Oracle instance is online. Run the following command to verify that the Oracle health check binary reports the status correctly\:
# ./oraapi__
where _ is the system architecture and the Oracle full version.
For example, # ./oraapi_64_121010 , where oraapi_64_121010 is a binary built for Oracle version 12 on a 64-bit system.
The system displays the following message:
lang=txt
Instance is online
Run # echo $?
If the system displays 110 the instance is online and active.
If the Oracle instance is offline. Run the following command to verify that the Oracle health check binary reports the status correctly\:
# ./oraapi__
where _ is the system architecture and the Oracle full version.
For example, # ./oraapi_64_121010 , where oraapi_64_121010 is a binary built for Oracle version 12 on a 64-bit system.
The system displays the following message:
lang=txt
Failure: Instance Shutdown class: SOFT
lang=txt
Proper Shutdown
Run # echo $?
If the system displays 100 the instance is offline.
If the Oracle instance is abnormally terminated. If any of the important Oracle process is killed (for example, ora_pmon_, ora_smon_), the Oracle instance is abnormally terminated.
In such a case run the Oracle health check binary, and the system displays following message:
For example, run # ./oraapi_64_121010
lang=txt
Failure: Abnormal Termination
class: SOFT
Abnormal termination
Run # echo $?
If the system displays 98 the termination of Oracle processes. The VCS resource fails over as Oracle termination was abnormal and not intentional.