## page was renamed from Projet/Supervision/AutomatisationdeNagios
Procédure pour utiliser le système d'automatisation de la configuration de Nagios

== Principe de fonctionnement ==
 * La configuration de Nagios est faite sous forme de template : on suit le même format de configuration, sauf que l'adresse IP est remplacée par $address et le nom de la machine est remplacé par $hostname;
 * Le logiciel `cheetah` transforme ces fichiers de template en classes Python ; un script, [[attachment:compile|compile]] permet de lancer cheetah.
 * Un fichier CSV `liste.csv` sert de base de données, il contient le nom de la machine, le système d'exploitation, le type de test à faire et le groupe de contact;
 * Un "parser" ([[attachment:parser.py|parser.py]]) en Python fait le lien entre les templates (classes générées par Cheetah) et le fichier CSV.


== Stockage des fichiers ==
Tous les fichiers sont dans le Subversion.

Dans le répertoire etc/nagios2/templates il y a la définition des templates, le fichier CSV et le programme qui sert à générer la configuration.

Les templates définis actuellement sont : `disquesCEH`, `healthswitch`, `host`, `disquesDEH`, `disquesS`, `healthlinux`, `healthwindows`, `process.tmpl`.


Le fichier CSV s'appelle actuellement `liste.csv`.

Sur le serveur Nagios, il y a deux répertoires spéciaux : `/etc/nagios2/auto.d` et `/etc/nagios2/manuel.d`.
Tous les fichiers avec l'extension .cfg placés dans un de ces répertoires seront pris en compte par Nagios.
Le contenu du répertoire `auto.d` est effacé et régénéré à chaque modification d'un template ou du fichier CSV, donc il ne faut pas faire de modifications personnalisées.
Le répertoire `manuel` est prévu pour entreposer toutes les modifications personnalisées (hors template).

== Ajout de machine ==
Pour ajouter une machine, il faut rajouter une entrée dans le fichier CSV selon le format suivant :
 '''''hostname,ip,parent,os,test à faire (nom du template),groupe de contact'''''
Par exemple :
{{{
 intranet,10.36.0.10,dmzrpv,Linux,Health,contactgroup1
}}}

Et lancer le script `compile`.

Pour supprimer une machine, il suffit d'enlever son entrée du fichier `liste.csv` et d'exécuter le script.

== Modification d'un template ==
Ajout/suppression d'un nouveau service dans un template, modification d'un seuil.

Pour modifier un template il suffit d'adapter le fichier ".tmpl" à nos besoins et de lancer le script `compile`.

'''NB''' : ne pas oublier de faire un "commit" dans le Subversion.

Cette modification fera en sorte que la configuration de toutes les machines qui utilisent ce template sera mise à jour.

== Ajout d'un nouveau template ==
Nouveau service, nouvel ensemble de tests pour un groupe de machine

Voici les étapes pour ajouter un nouveau template. 

Pour les exemples, on suppose ici que le template s'appelle bd.tmpl.

 * Créer le template (fichier bd.tmpl) en suivant le modèle suivant :

{{{
 define service {
        use                             generic-service
        host_name                       $hostname
        service_description             LE_NOM_DU_SERVICE
        contact_groups                  $contact
        check_command                   commande!argument1!argument2
 }
}}}

Par exemple :

{{{
 define service {
        use                             generic-service
        host_name                       $hostname
        service_description             TEST_PING_BD
        contact_groups                  $contact
        check_command                   check_ping!10.0,5%!50.0,20%
 }
}}}

 * Ajouter ce fichier dans le Subversion
 svn add bd.tmpl
 * Modifier le script parser.py : ajouter la ligne suivant à la fin de la première partie du script (section des imports)
  `from bd import bd`
 * Dans la fonction "genServices" (à partir de la ligne 25), copier/coller un bloc comprenant le "elif" jusqu'au file.write(tmpl.respond).

Par exemple copier la section :

{{{
elif check == "Health" and type == "Windows":
 tmpl = healthwindows()
	tmpl.hostname = hostname
        tmpl.contact = contact
        file.write(tmpl.respond())
}}}

Coller cette section et remplacer la valeur de "check" par la valeur qui sera mise dans le fichier CSV pour le champ "type de test" (par exemple BD) et modifier ou supprimer le 'and type == "Windows"' en fonction du besoin.
Si un test dépend du système d'exploitation, il faut laisser cette dernière partie, sinon elle peut être supprimée.
Par exemple si nous avons un test de BD pour Linux et un autre pour Windows, on pourra ajouter les parties suivantes :
{{{
elif check == "BD" and type == "Windows":
	tmpl = bdwindows()
	tmpl.hostname = hostname
        tmpl.contact = contact
        file.write(tmpl.respond())
elif check == "BD" and type == "Linux":
	tmpl = bdlinux()
	tmpl.hostname = hostname
        tmpl.contact = contact
        file.write(tmpl.respond())
}}}

Par contre si notre test est indépendant du système d'exploitation, on pourra écrire la section suivante :
{{{
elif check == "BD":
	tmpl = bd()
	tmpl.hostname = hostname
        tmpl.contact = contact
        file.write(tmpl.respond())
}}}

'''Attention : L'indentation est importante en Python, une erreur rendra le script non fonctionnel'''

 * il nous reste à utiliser notre nouveau template, en modifiant le fichier CSV. Par exemple :
 dmzreflets,10.36.0.253,zeus,Switch,BD,BD_CONTACT

 * lancer le script `compile`.

== Suppression d'un template ==

 * supprimer le fichier .tmpl
 * modifier `parser.py` en enlevant les reférences au template à supprimer
 * supprimer les entrées de machines utilisant ce template
 * lancer le script `compile`.