Copyright (C) 2006 Alyseo
http://www.alyseo.com

Créer et maintenu par Alyseo dans le cadre de la licence GPL v2 :
Voir fichier COPYING.txt ou http://www.gnu.org/copyleft/gpl.html

Contents

Introduction
Pré requis
Installation
Désinstallation
Aide et support

Introduction

Merci d'utiliser Coraid Nagios Disk Monitoring (CNDM).

CNDM vous permet de surveiller l'état des disques durs d'une ou
plusieurs baies Coraid et de remonter des alertes sur un serveur
Nagios.

CNDM est un plugin Nagios fonctionnant en mode passif grâce à
l'utilitaire NSCA de Nagios. Ce produit est multithreader et peux
monitorer simultanément autant de port série que le serveur sur lequel
vous l'installez en possède.

Pré requis

CNDM nécessite les éléments suivants pour fonctionner :

- Linux (Fedora, Unbuntu, Debian, Redhat, ...).

- Sun Java JRE 1.5 ou supérieur : http://java.sun.com/javase/downloads/index.jsp

- NSCA (l'utilitaire de dialogue avec le serveur Nagios (http://www.nagios.org/download/)

- Environ 1 Mo d'espace libre.

- Ports série (RS232) disponibles.

Installation

- Installer Java, pour Ubuntu Edgy voir :

http://ubuntuguide.org/wiki/Ubuntu_Edgy#How_to_install_JRE_v5.0_Update_9
ou
http://ubuntuguide.org/wiki/Ubuntu_Edgy#How_to_install_Java_Development_Kit_.28JDK.29_v5.0

- Installer CNDM dans /opt :
# tar zxvf CoraidNDM-1.0.2.tar.gz
# cd ./cndm
# mv * /opt
ou
# cp -a * /opt

- Compiler NSCA :

Vous devez installer la lib mcrypt si ce n'est pas fait :
# apt-get install libmcrypt4
# apt-get install libmcrypt-dev

Puis compiler nsca :

# cd /opt/nsca
# ./configure
# make all

- Il est nécessaire de paramétrer les 3 fichiers suivants avant de lancer le service :

* fichier conf/configuration.properties
Le fichier de configuration principale de CNDM, vous devez modifier
l'IP (ou le nom) de votre serveur Nagios uniquement si vous avez suivi
les instructions ci-dessus (meme chemin...).

* fichier conf/serial.properties
Le fichier de configuration des ports série et de correspondance
des services Nagios.

* fichier nagios.nsca/send_nsca.cfg
Le fichier de paramétrage de Nsca.
Voir les instructions de paramétrage dans chacun des fichiers ci-dessus.

- Ensuite vous pouvez installer le fichier de startup ainsi que le fichier pour la rotation de log :

# cp /opt/CoraidNDM/etc/init.d/cndm /etc/init.d
# cp /opt/CoraidNDM/etc/logrotate.d/cndm /etc/

Pour Ubuntu et Debian faire :

# update-rc.d cndm defaults 70

Pour les autres distribution vous devez créer les liens manuellement et certainement modifier le script.

- Le démon Nagios NSCA doit également être installé pour accepter les requêtes passives émises par le client CNDM.

Attention : le démon NSCA doit être configuré avec inetd/xinetd pour répondre à plusieurs requêtes successives.

- Exemple de configuration NSCA par xinetd :

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
  }

- Ajouter la ligne suivante dans le fichier /etc/service : nsca 5667/tcp # NSCA

- Ajouter la ligne suivante dans le fichier nagios.cfg :

  check_external_commands=1
- Exemple de configuration d'un service passif avec Nagios, fichier <nagios>/etc/hosts.cfg :
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
}
- Fichier <nagios>/etc/checkcommands.cfg :
define command {
   command_name check_failedDisk
   command_line na
}
- Fichier <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
}
- Fichier <CNDM>/conf/serial.properties :
 COM1=9600,8,N,1,Alyseo,SR production,Coraid SR1520,check failed disk

Définitions :

"Coraid SR1520" -> Idem que host_name dans le fichier <nagios>/etc/hosts.cfg

"check failed disk" -> Idem que service_description dans le fichier <nagios>/etc/services.cfg

Désinstallation

CNDM peut être désinstaller en supprimant l'arborescence du produit.

Aide et support

Le support technique de CNDM est assuré par la société Alyseo,
éditrice de CNDM.

Toutes questions techniques sur ce produit doivent être envoyé à :

support@alyseo.com


Vos suggestions et retour d'expériences sont les bienvenus.

Ce Readme.txt a été mis à jour le vendredi 10 novembre 2006