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
Fonctionnalités
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.

Fonctionnalités

- Monitoring des baies Coraid multi niveaux :
-> monitoring des disks
-> monitoring des ensembles lblades
-> monitoring des sous ensembles lblades

- Utilisation de l'ensemble des ports séries d'un serveur :
-> plusieurs baies Coraid peuvent etre rattachées à un même
serveur.

- Gestion des accès concurrents aux ports séries :
-> une alerte Nagios est remontée en cas de non disponibilité
d'un port série.

- Mode de communication passif avec le serveur Nagios :
-> la communication avec le serveur Nagios se fait avec
l'utilitaire send_nsca (fourni par le setup CNDM).

- Utilisation d'un service Windows NT avec démarrage automatique du
plugin CNDM.

- Configuration en mode texte simple via des fichiers de propriétés.

Pré requis

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

- Microsoft Windows NT 4.0, Windows 2000, Windows XP ou les versions
serveur de Windows (2003 serveur...).

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

- Serveur Nagios avec démon NSCA.

- Environ 1 Mo d'espace libre.

- Ports série (RS232) disponibles.

Installation

Le setup installe CNDM en tant que service NT. Ce service n'est pas
démarré par défaut. Il est nécessaire de paramétrer les 3 fichiers
suivants avant de pouvoir lancer le service :

- Fichier conf/configuration.properties :
Configuration principale de CNDM.

- Fichier conf/serial.properties :
Configuration des ports série et correspondance avec les
services Nagios.

- Fichier nagios.nsca/send_nsca.cfg :
Paramétrage de l'utilitaire NSCA.

Pour la configuration, voir les instructions et commentaires dans
chacun des fichiers ci-dessus.

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 par l'option "Uninstall" du menu démarrer.

La désinstallation comprends l'arrêt du service NT, la suppression du
service et la suppression complète de 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