Coraid Nagios Disk V1.0.3 Monitoring for Linux
===================================================================== 
Copyright (C) 2006 Alyseo http://www.alyseo.com/ 
First english translation made by Michaelian Ennis (Thank you Ian).

Created and maintained by Alyseo under LPG v2: 
See file COPYING or http://www.gnu.org/copyleft/gpl.html 

Contents
======== 
Introduction 
Requirements
Installation
Examples
Uninstalling
Support

Introduction
============
Thank you for using Coraid Nagios Disk Monitoring (CNDM). CNDM enables you to monitor the status of hard drives in one or more Coraid shelves and to send alarms to a Nagios host.  CNDM is a plugin for Nagios operating in passive mode utilizing NSCA for Nagios. This product is multithreaded and can simultaneously monitor as many shelves as you have serial ports. 

Requirements
============

CNDM requires the following to function:
* Linux (Fedora, Unbuntu, Debian, Redhat...). 
* Sun Java JRE 1.5 or greater: http://java.sun.com/javase/downloads/index.jsp 
* NSCA (the utility which communicates with Nagios host (http://www.nagios.org/download/) 
* Approximately 1M of disk space. 
* Serial Ports available.

Installation
============
To install Java:

For Ubuntu Edgy to see: http://ubuntuguide.org/wiki/Ubuntu_Edgy#How_to_install_JRE_v5.0_Update_9 or http://ubuntuguide.org/wiki/Ubuntu_Edgy#How_to_install_Java_Development_Kit_.28JDK.29_v5.0 

To install CNDM in /opt: 
# tar zxvf CoraidNDM-1.0.2.tar.gz 
# cd /cndm 
# mv * /opt or 
# cp -has * /opt 

To compile NSCA:
You must have installed the lib mcrypt if you haven't yet:
# apt-get install libmcrypt4 
# apt-get install libmcrypt-dev 

Then to compile nsca: 
# cd /opt/nsca 
# /configure 
# make all 

The following files 3 files must be edited before launching the service:

* conf/configuration.properties 
this is the primary configuration file of CNDM, if you folowed the instructions above you may need to modify the IP (or the hostname) of your Nagios host. 

* conf/serial.properties
this is the serial port configuration file of the CNDM service. 

* nagios.nsca/send_nsca.cfg
this is the NSCA configuration file. 

See the comments within each file for the parameters a description of the parameters. 
Then you can install startup file and the log rotation file: 
# cp /opt/CoraidNDM/etc/init.d/cndm /etc/init.d 
# cp /opt/CoraidNDM/etc/logrotate.d/cndm /etc/ 

For Ubuntu and Debian to make: 
# update-rc.d cndm defaults 70 

For the other distributions you may have to manually create the links and will certainly have to modify script. 

The Nagios NSCA daemon should be configured to accept the passive check from the CNDM client. Note: the NSCA daemon should be configured to use  inetd/xinetd. 

Sample xinetd configuration:

service nsca
   {
   flags = REUSE
   type = UNLISTED
   port = 5667
   socket_type = stream
   wait = no
   user = nagios
   group = nagios
   server = /opt/nsca/server/nsca 
   server_args = -c /opt/nsca/server/nsca.cfg --inetd
   log_on_failure += USERID
   disable = no
   only_from = 192.168.0.102 192.168.0.106 
   }


Add the following line in /etc/service: 
nsca 5667/tcp # NSCA 

Add the following line in the file nagios.cfg: 
check_external_commands=1 

Sample passive check configuration:

in <nagios>/etc/hosts.cfg add:

define host {
   name generic-host
   register 0
   notifications_enabled 1
   event_handler_enabled 1
   flap_detection_enabled 1
   process_perf_data 1
   retain_status_information 1 
   retain_nonstatus_information 1
   check_command check-host-alive
   max_check_attempts 10
   notification_interval 60
   notification_period 24x7
   notification_options d,u,r
   }


define host { 
   host_name Coraid SR1520
   use generic-host
   alias coraid
   address "adresse IP du serveur Windows sur 
   lequel vous avez installÈ le plugin
   CNDM. Ex: 192.168.0.102"
   contact_groups alyseogroup
   }

in <nagios>/etc/checkcommands.cfg:

 define command {
   command_name check_failedDisk
   command_line na
   }

in <nagios>/etc/services.cfg: 

define service {
   host_name Coraid SR1520
   use generic-service
   check_command check_failedDisk
   service_description check failed disk
   active_checks_enabled 0
   passive_checks_enabled 1 
   }



in <nagios>/conf/serial.properties:

COM1=9600,8,N,1,Alyseo,SR production,Coraid SR1520,check failed disk

Definitions:

"Coraid SR1520" - add that host_name in /etc/hosts.cfg 

"check failed disk" add that service_description in /etc/services.cfg

Examples
=========
How do I start CNDM? 
enter the following commands: 
# /opt/CoraidNDM/bin/launch.sh 
# /etc/init.d/cndm start 

Uninstalling CNDM
================= 
CNDM can be removed by simply deleting the directory containing the product.

Help and support 
================
The CNDM is supported by Alyseo, the authors of CNDM. All technical questions about this product should be directed to: support@alyseo.com . Your suggestions are welcome.  Feel free to share your experience with the product with us as well.


===================================================================== 
This Readme.txt transalted on Wednesday May 16 2007 
=====================================================================