Description:
------------

The xserve-raid-tools package provides command line tools and
a daemon for monitoring Apple Xserve RAIDs.  It also contains a
"plugin" so that one can monitor Apple Xserve RAIDs with Nagios.

The package is known to work on on RedHat Enterprise Linux 3, RedHat
Fedora Core 3, Mac OS X 10.3 and Mac OS X 10.4.  It is written in
perl and has a minimal set of requirements, so it's very portable.

The xserve-raid-status command prints a table listing the RAIDs
and disks installed, their type, make, model, capacity and status.
It can also be told to only list logical devices (RAIDs) or physical
devices (disks).

The xserve-raid-info command prints information about the
configuration of an Xserve RAID.  It's output is very similar to
the output from most of the tabs of the RAID Admin tool, except of
course, the output is in plain text.

The xserve-raid-log command prints the log entries for both
controllers sorted by date and time.  Unfortunately, Xserve RAIDs
tend to briefly have their system clocks set incorrectly, so you will
probably see some entries listed as "Wed Dec 31" and/or "Thu Jan  1".
These refer to the years 1969 and 1970--shortly after the Unix Epoch
(00:00:00 1970-01-01 GMT.)  The only way to discern an approximate
time for these entries is to manually run "xserve-raid-log" with
the "-d -d" options and interpolate the time based on the adjacent
(xml <string></string>) entries that have good time stamps.

The xserve-raid-checkd daemon sends email notifications when an
Xserve RAID changes it's state: all optimal, one RAID building or
rebuilding, in standby power state, has a dead RAID or unreachable
(communications failure.)

Lastly, the check_xserve_raid command can act as a Nagios plugin.
Refer to the Nagios documentation for information about integrating
it into Nagios.


Requirements:
-------------

 - nc (netcat)
 - perl 
 - the perl XML::Parser perl module
 - the perl POSIX module (only needed by xserve-raid-checkd)


Source:
-------

 ftp://noc.hep.wisc.edu/pub/src/xserve-raid-tools/


Install:
--------

 ./configure
 make install 


Running xserve-raid-checkd at boot:
-----------------------------------

 If RedHat, then
     cp xserve-raid-checkd.init /etc/init.d/xserve-raid-checkd
     chkconfig --add xserve-raid-checkd 
     service xserve-raid-checkd start

 If other Linux or SVR4-style-startup Unix, then
     cp xserve-raid-checkd.init /etc/init.d/xserve-raid-checkd
     (cd /etc/rc2.d; ln -s ../init.d/xserv-raid-checkd \
       S99xserve-raid-checkd )
     /etc/init.d/xserve-raid-checkd start

 If BSD-ish Unix, then 
     echo '/usr/local/bin/xserve-raid-checkd' >> /etc/rc.local
     /usr/local/bin/xserve-raid-checkd


Configure:
----------

 Edit /usr/local/etc/xserve-raid-tools.conf


Disclaimer:
-----------

This is not Apple software.  It is third party software written
by a member of the High Energy Physics group at the University of
Wisconsin, and is distributed under the GNU General Public License.


Contact:
--------

steve
- - -
<rader@hep.wisc.edu>
systems & network manager
high energy physics
university of wisconsin