Health checker for UNIX/Linux is a small framework of monitoring scripts. It is meant to be used for low latency & low frequency checks, it is easy to extend where necessary (plugins) and it can be integrated with other toolsets.

Requirements

ksh88/ksh93 (mksh/pdksh will work also but YMMV)
some disk space for storing logs & event files
system dependant tools/utilities (see individual health checks)
UNIX cron or other scheduler
execute as user root only

Build

Use the build templates & scripts in the `build/ directory to roll your own packages.

Installation

HP-UX

Install the core bundle:

swinstall -x mount_all_filesystems=false -s /tmp/hc-hpux-<version>.sd \*

Install the HP-UX plugin bundle:

swinstall -x mount_all_filesystems=false -s /tmp/hc-hpux-platform-<version>.sd \*

Linux

Install the core bundle:

yum localinstall hc-linux-<version>.noarch.rpm
zypper install hc-linux-<version>.noarch.rpm

Install the Linux plugin bundle:

yum localinstall hc-linux-platform-<version>.noarch.rpm
zypper install hc-linux-platform-<version>.noarch.rpm

AIX

Install the core bundle:

installp -Xap -d hc-aix-<version>.bff all

Install the AIX plugin bundle:

installp -Xap -d hc-aix-platform-<version> all

Miscelleanous

Additionally, there may be bundles for display or notification plugins, e.g.:

hc-display-csv
hc-display-init
hc-display-terse
hc-notify-eif
hc-notify-sms

Execute (examples)

Listing available health checks:

/opt/hc/bin/check_health.sh --list

Running a single health check:

/opt/hc/bin/check_health.sh --hc=check_hpux_ioscan --run

Running multiple health checks (at once):

/opt/hc/bin/check_health.sh --hc=check_hpux_ioscan,check_hpux_ovpa_status --run

Running a single health check with a custom configuration file:

/opt/hc/bin/check_health.sh --hc=check_hpux_ioscan --config-file=/etc/opt/hc/check_hpux_ioscan_new.conf --run

Showing information on a health check:

/opt/hc/bin/check_health.sh --hc=check_hpux_ioscan --show

Enabling/disabling a health check:

/opt/hc/bin/check_health.sh --hc=check_hpux_ioscan --check
/opt/hc/bin/check_health.sh --hc=check_hpux_ioscan --disable
/opt/hc/bin/check_health.sh --hc=check_hpux_ioscan --enable

Reporting on failed health checks:

/opt/hc/bin/check_health.sh --report
/opt/hc/bin/check_health.sh --report --last
/opt/hc/bin/check_health.sh --report --today
/opt/hc/bin/check_health.sh --report --id=20160704154001 --detail

Alerting on failed health checks:

/opt/hc/bin/check_health.sh --hc=check_hpux_root_crontab --run --notify=mail --mail-to="alert@acme.com"

References

More documentation can be found at http://www.kudos.be/Projects/Health_checker.html