check_apple_xsan – Xsan Monitoring Plugin

Descriptio

check_apple_xsan checks the status of your Apple Xsan. It sends alerts for the following error conditions.

• unavailable / failed filesystems
• unavailable / failed stripe groups
• unavailable / failed XSAN controllers
• XSAN controller failover
• available space per filesystem (configurable minfree-softlimit and 100% full)
• available space per stripe group (configurable minfree-softlimit and 100% full)

The following Versions are supported:
PPC und Intel: 10.4 and 10.with Xsan 1.X
PPC und Intel: 10.5 with Xsan 2

Documentation

grattler:/opt/local/libexec/nagios root# ./check_apple_xsan -h
check_apple_xsan, 1.0
ConSol* GmbH 2008

Check Mac OS X Xsan Status

Usage:
check_apple_xsan [-v] [-m minfree] [-m filesys:minfree] [-M filesys] [-t timeout]  [-T]
check_apple_xsan [-r]
check_apple_xsan [-h]
check_apple_xsan [-V]

<minfree>      Global minimum free percentage on filesystems
<filesys:minfree>
Per <filesys> minimum free percentage
With the “-m” flag, a warning is issued if the free space
on a file system drops below the given <minfree> percentage
[-M           <filesys>] Also check free percentage for individual stripe groups (LUNs)
for file system <filesys>
[-t]           <timeout>      Timeout in seconds to abort command with status “UNKNOWN”
Default: 40 seconds
[-T]           Don’t update status file (“test mode”)

[-v]           Also print a message for each failure
[-vv]         Also print raw status data
[-vvv]       Also print lots of debugging output

[-h]           Print this help message and exit
[-V]           Print program version and exit
[-r]            Reset error/warning messages (delete status file)
While errors/warnings are present, updated Xsan configurations
like added files systems or controllers will not be monitored

When an error condition was discovered and fixed, you have to manually reset the error. Simply run:

# check_apple_xsan -r

Installation

The installation is pretty simple. In case you have configured the nrpe daemon correctly, you only have to put the plugin into your libexec directory. Then you only need to configure nrpe.cfg accordingly.

Example

grattler:/opt/local/libexec/nagios root# ./check_apple_xsan
OK: Xsan

Example error messages:
CRITICAL: Xsan:SanVol1: file system full: 0% free
CRITICAL: Xsan:SanVol2: file system is down
WARNING: Xsan:SanVol3: file system minfree: 8% free, Thresh:10%”);
WARNING: Xsan:SanVol1: controller failover apple2.local->apple1.local

The plugin is not freely available, but we share it if we are booked for consulting purposes or if you have a support contract.