            INSTRUCTIONS POUR INSTALLER NAGWEN

1 - PREREQUIS

  Ce plug-in part du principe que l'acceptation de requete passives est operationnel.
  
  Vous devez donc avoir :
      - un serveur Nagios sur un poste distant
      - ce serveur doit accepter et grer les requetes NSCA
       cf http://www.nagios.org/download/extras.php pour plus de dtails



2 - INSTALLATION

   - aller dans le repertoire /usr/local
   - y decompresser le fichier nagwen.tar.gz
   - configurer Nagwen (cf chapitre 3)
   - faire quelques tests d'envoi 
       cd /usr/local/nagwen/sbin
       ./nagwen_report.sh
   - ajout la ligne suivante dans le cron : 
     0 * * * * cd /usr/local/nagwen/sbin; ./nagwen_report.sh >/dev/null 2>&1

   
   Nagwen est fourni avec le binaire send_nsca (dans bin/) et quelques plugins-nagios compiles. 
   Si vous souhaitez compiler vous mme ces outils, vous pouvez les tlcharger 
      - nsca : http://www.nagios.org/download/extras.php
      - Nagios-plugins : http://sourceforge.net/projects/nagiosplug/




3 - CONFIGURATION

    Il y a 3 fichiers principaux de configuration
    
    a) nagwen.cfg
      C'est le fichier principal. Vous devez absolument renseigner les valeurs suivantes :
      
        - NAGIOS_SERVEUR
	  indiquer l'adresse IP de votre serveur Nagios

	- NAGIOS_HOST
	  indiquer le nom de l'hote, renseign sur votre serveur Nagios

	- NAGIOS_SERVICES
	  indiquer la liste des services  tester sur cette machine


      Il peut galement etre utile de renseigner les valeurs suivantes :
        - NAGWEN_FREQUENCE_REPORT_ALL
	  indiquer ici la frquence  laquelle un rapport complet est envoy au serveur Nagios
          Exemple :
	    si 1, tout est envoy ds que l'on lancer nagwen_report.sh
	    si 5, tout est envoy au premier nagwen_report
	          rien n'est envoy au 2me, 3me, 4me et 5me lancement de nagwen_report
		  tout est envou au 6me nagwen_report
	  par contre, si un service echoue (c.a.d son code de retour est different de 0), 
	  l'information est automatiquement envoy, dans tous les cas
	  cel permet donc de faire un test des services toutes les 30 minutes, mais de n'envoyer
	  au serveur que toutes les 3 heures (pour ne pas le charger inutilement)
	  
	- NAGWEN_LOG
	  indiquer ici le fichier de log de Nagwen

	- NAGWEN_MAIL
	  indiquer ici un mail pour l'envoi d'informations complementaires

     
     b) nagwen_services.cfg
        Vous pouvez parametrer le comportement pour chaque service.
	Chaque service peut avoir les variables suivantes :
	
	 - NAGIOS_NOMSERVICE_NB_RETRY
           Nombre d'essais avant de valider une alerte.
	   Exemple : si le processeur est occup  80%, cel gnre normalement un tat 'CRITICAL'.
	   Nanmoins, cet tat peut tre temporaire. Si NAGIOS_CPU_NB_RETRY=3, un tat 'CRITICAL' ne sera envoy au serveur 
	   qu'aprs 3 tentatives.
	   Cette variable vaut NB_RETRY dans le script du service (cf 'Creation de son service')
	   
	 - NAGIOS_NOMSERVICE_WARNING
	   Niveau de warning pour le service. Ce niveau est utilis differement selon les services
	   Cette variable vaut WARNING dans le script du service (cf 'Creation de son service')

	 - NAGIOS_NOMSERVICE_CRITICAL
	   Niveau de critical pour le service. Ce niveau est utilis differement selon les services
	   Cette variable vaut CRITICAL dans le script du service (cf 'Creation de son service')

	

         Ce fichier peut galement contenir des variables spcifiques pour certains tests.
	 
	 - NAGIOS_DISK_PART
	   On peut lister ici la liste des partitions pour le serveur 'DISK' (utilisation du plug-in nagios_cpu)


     c) send_nsca.cfg
        c'est le fichier de config de NSCA
	le modifier si vous souhaitez mettre un cryptage sur les donnes



4 - Integration d'un service personnel

    Pour utiliser un service personnel (appelons-le TOTO, il faut remplir les tapes suivantes :
       
       a) ajouter dans le fichier nagwen.cfg ce service  la variable NAGIOS_SERVICES

       b) eventuellement, renseigner les valeurs NAGIOS_TOTO_NB_RETRY, NAGIOS_TOTO_WARNING et NAGIOS_TOTO_CRITICAL
          dans le fichier nafwen_services.cfg

       c) crer un script nagwen_toto.sh dans le repertoire bin/
          ce script doit remplir 2 valeurs :
	    - code : code de retour pour le service
	      valeurs possibles : 0 (OK), 1, 2 ou 3 (UNKNOWN)

       d) faire un test ...
	   

5 - Live Update


6 - Divers ...

    La rapport complet de tous les services se fait via la script sbin/nagwen_report.sh.








    
