Check Oracle status & health without install Oracle client - enhanced

Major enhancements:
* Added Tablespace usage check. Find's the tablespace with the highest percentage used.
(counting max tablespace filesize against the real filesize minus the free space inside the db file.)
* Better help and command line options.
* Risk of locked users due to wrong parameters is much lower.
* Better error handling.
* Database health error give more info.
* Store default settings in config file.
* Options added to skip specific tests, when specific results are not marked as problematic.

It allows you to check oracle service (ability to connect to database ) and the health of oracle database (TableSpace Usage, Dictionary Cache Hit Ratio, Library Cache Hit Ratio, DB Block Buffer Cache Hit Ratio, Latch Hit Ratio, Disk Sort Ratio, Rollback Segment Waits, Dispatcher Workload) It is possible to define your own parameters.

Big advantage is that it does not need to install the complete ORACLE client or compile other perl modules.

Installation:

1. Download the Oracle instant client. (http://www.oracle.com/technetwork/database/features/instant-client/index-097480.html, pick your OS.) Download the two following packages:
* Instant Client Package - Basic
* Instant Client Package - SQL*Plus
Install these packages, and make sqlplus runnable from anywhere. (i had to add following lines in .bashrc in my nagios account (using client64 on SLES11 system):

ORACLE_HOME=/usr/lib/oracle/10.2.0.5/client64
PATH=$ORACLE_HOME/bin:$PATH
PATH=$ORACLE_HOME/lib:$PATH
LD_LIBRARY_PATH=$ORACLE_HOME/lib
export ORACLE_HOME
export LD_LIBRARY_PATH
export PATH

Test sqlplus with following command: sqlplus user/passwd@"(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(Host=IP or hostname)(Port=port))(CONNECT_DATA=(SID=sid)))"
Remember to fully restart your nagios instance to get these settings into your nagios environment.

2. Copy check_oracle_instant script to libexec directory (on linux /usr/local/nagios/libexec)
and set correct rights and owner.

3. Add correct commands etc to nagios. (you can test from commandline which options to use)

Help info:
This plugin logs into the database and does some health checking inside the database.

Usage: check_oracle_instant -H host -l listener-port -s SID -u username -p password -n tdlbasrw -f filename

Options:
-H --host STRING or IPADDRESS
Address of the indicated host.
-p --lsn portnumber
Oracle listener port number.
-s --sid Connect String
Oracle connect string
-u --user username
Oracle login name
-w --pass password
Oracle password
-n --nocheck dlbasrw
Here you can disable specific tests in case you don't want them:
t: Tablespace usage
d: Dictionary Cache Hit Ratio
l: Library Cache Hit Ratio
b: DB Block Buffer Cache Hit Ratio
a: Latch Hit Ratio
s: Disk Sort Ratio
r: Rollback Segment Waits
w: Dispatcher Workload
-f --file filename
Filename with any (default) option as stated above.
This file contains one line, with all options you wish to use. example:
-l 1521 -u system -p testpass
Settings set after the -f in the commandline wil override the settings in this file.

The author is using this script on a Suse SLES11 OPSview (nagios v3) server against an oracle 10.2 database server.