Installer / Configurer

DOCUMENTATION DEXPLOITATION

NAGIOS &
CENTREON
Installation -
DEBIAN
p. 1


FVT




INFORMATIONS / REVISIONS

Date Auteur Version Changements
07/02/2014 Francis Viallet 1.0 Version initiale









DIFFUSION AUDIENCE

Ce document sadresse au Directeur informatique ainsi quaux quipes dadministration du rseau.





p. 2


FVT
SOMMAIRE


2 SOMMAIRE
I) PREREQUIS 3
1.1 CONFIGURATION 3
II) INSTALLATION DES DEPENDANCES : 4
III) NAGIOS 7
3.1 PREREQUIS 7
3.2 TELECHARGEMENT ET EXTRACTION DES SOURCES DE NAGIOS : 8
3.3 COMPILATION DES SOURCES ET INSTALLATION DE NAGIOS 10
3.4 DEMARRAGE NAGIOS 12
3.5 TEST CONNEXION NAGIOS 14
3.6 INSTALLATION PLUGINS NAGIOS 16
IV) NDOUTILS 18
4.1 TELECHARGEMENT ET EXTRACTION NDOUTILS 18
4.2 COMPILATION, INSTALLATION ET DEMARRAGE DE NDOUTILS 20
V) INSTALLATION DE CENTREON 22
5.1 TELECHARGEMENT DE CENTREON 22
5.2 INSTALLATION DE CENTREON 23
5.3 FINALISATION DE LINSTALLATION CENTREON 32
5.4PREMIERE UTILISATION, MANIPULATION 37


p. 3


FVT
I) Prrequis



1.1 Configuration

Vous devez avoir configur votre adressage IP en statique, et si souhait avoir ajout votre machine
Linux au domaine.


p. 4


FVT
II) Installation des dpendances :

Afin de permettre une excution correcte de nagios et centreon, nous devons installer tous les
logiciels, qui sont ncessaires aux scripts dinstallation ou aux programmes Nagios et Centreon ainsi
que leurs sous programmes (par exemple on installe MySQL pour stocker les bases et rglages de
Centreon, PHP et apache pour linterface web, les noyaux linux et les compilateurs ncessaires pour
linstallation, etc.)
Malheureusement, Centreon nest pas compatible avec la dernire version de PHP, installe par
dfaut.
Nous allons donc utiliser celle de la version de debian prcdente, en ajoutant les sources de cette
version (squeeze) dans notre liste de sources puis en crant un fichier de prfrences indiquant daller
piocher dans ces dpts pour les paquet PHP.

On va donc ajouter notre source dans /etc/apt/sources.list :
vi /etc/apt/source.list

-On ajoute le dernier paragraphe (on commente pour indiquer ce que lon a fait puis on
rajoute les sources de squeeze.)

#Squeeze source, for PHP oldstable packages to make Centron compatible
#Configuration pour indiquer d'aller chercher PHP uniquement dans cette source faite ici :
#/etc/apt/preferences.d/preferences
deb http://ftp.fr.debian.org/debian/ squeeze main non-free
deb-src http://ftp.fr.debian.org/debian/ squeeze main non-free

p. 5


FVT
On va alors maintenant diter ou ajouter le fichier de prfrences
/etc/apt/preferences.d/preferences :
vi /etc/apt/preferences.d/preferences

-On rajoute notre configuration pour aller chercher PHP prioritairement dans les sources de
squeeze (on noublie pas les commentaires pour ceux qui regardent aprs)
#Configuration pour aller chercher les paquets PHP dans le dpots squeeze et les autres dans
#les dpots de la version utilise (wheezy)

Package: php5*
Pin: release a=oldstable
Pin-Priority: 700

Package: libapache2-mod-php5
Pin: release a=oldstable
Pin-Priority: 700

Package: php-pear
Pin: release a=oldstable
Pin-Priority: 700

Package: *
Pin: release a=stable
Pin-Priority: 600

p. 6


FVT
On met jour notre liste de sources et paquets ainsi que la prise en compte de la
configuration du gestionnaire de paquet apt :
apt-get update

On peut maintenant lancer le tlchargement et linstallation des paquets :
apt-get install apache2 php5 php5-mysql php-pear php5-ldap php5-snmp php5-gd mysql-
server-5.5 libmysqlclient-dev rrdtool librrds-perl libconfig-inifiles-perl snmpd libnet-snmp-
perl libgd2-xpm libgd2-xpm-dev libpng12-dev debconf-utils libglib2.0-dev make build-
essential libgnutls-dev libssl-dev libsnmp-perl libkrb5-dev libldap2-dev libsnmp-dev gawk
libmcrypt-dev fping gettext libwrap0-dev snmp smbclient dnsutils daemon sudo ntp nmap
saidar traceroute curl libltdl3-dev wget libgetargs-long-perl libgd-tools libapache2-mod-
gnutls


On choisit un mot de passe super-utilisateur MySQL (System2008) lorsque demand :


On vrifie la version de PHP avec dpkg :
dpkg -l | grep php

On voit bien que les paquets ont t pris dans Squeeze et non Wheezy et quils sont bien en
5.3 et non 5.4
dpkg : outil de gestion des paquets et dpackageur
apt : outil de gestion des sources et installateur de paquets
| dpkg : | permet de rediriger la sortie vers la commande suivante, grep va retourner les lignes
contenant la chaine de caractres prcise ensuite.
p. 7


FVT
III) NAGIOS


3.1 Prrequis

On va pralablement crer un utilisateur nagios puis lui affecter un mot de passe
(System2008) (cet utilisateur sera celui qui lancera les processus nagios, il aura tous les droits
sur les fichiers de nagios mais pas sur le systme) :
/usr/sbin/useradd -m -s /bin/bash nagios
passwd nagios


On cr les groupes nagios et nagcmd puis on leur attribue des utilisateurs
(nagios aux deux et www-data qui est l'utilisateur apache uniquement nagcmd)
(nagios sera le groupe utilisant les fichiers nagios et dont les utilisateurs auront les droits sur
les fichiers nagios, nagcmd servira pour les commandes dinstallation de nagios) :
/usr/sbin/groupadd nagios # (il existe dj, cr avec luser nagios)
/usr/sbin/groupadd nagcmd
/usr/sbin/usermod -G nagios nagios
/usr/sbin/usermod -a -G nagcmd nagios
/usr/sbin/usermod -a -G nagcmd www-data

(Loption a permet de rajouter l'utilisateur au groupe sans l'enlever des groupes auxquels il
est dj affect (ce que fait -G sans -a))

on vrifie avec cat /etc/group | grep nagios ( droite les utilisateurs gauche les groupes)

p. 8


FVT
3.2 TELECHARGEMENT et EXTRACTION des SOURCES de NAGIOS :

On se rend ( laide dun navigateur web), pour rcuprer le lien de linstallateur, ladresse :
http://www.nagios.org/download


On prend nagios core ; on clique sur download sous la version DIY ; puis skip to download



On prend ensuite la latest stable release de nagios 3,
En effet celui-ci est entirement support par centreon et Debian et est bien plus stable que la
version 4, encore trop jeune (<12mois) (et quelques bugs un peu gnants sur debian):
Pour cela on clique droit sur le lien puis copier ladresse du lien


On a alors dans le presse-papiers :
http://prdownloads.sourceforge.net/sourceforge/nagios/nagios-3.5.1.tar.gz

p. 9


FVT
On retourne ensuite dans notre terminal sur notre Debian puis on se met dans /tmp/
cd /tmp/
et on fait un wget du lien obtenu prcdemment :
wget lelientlchargerdansledossieroonest


Aprs quelques rsolutions de noms et redirections l'archive est enregistre dans /tmp/


on voit avec un ls que le fichier est bien enregistr sous le nom nagios-xxxx.tar.gz
on l'extrait avec tar -xzf ;
on vrifie avec un ls ;
on peut supprimer l'archive avec rm -rf ;
on se place dans le dossier produit par l'extraction :


p. 10


FVT
3.3 COMPILATION des sources et INSTALLATION de NAGIOS

REMARQUE : On est donc toujours dans notre dossier extrait contenant les fichiers sources (codes
sources, etc.) de nagios que nous avons tlcharg et extrait prcdemment : /tmp/nagios-xxxx/

On lance le script de prinstallation (il va configurer la compilation et l'installation)
./configure --with-command-group=nagcmd


On se fait une petite capture d'cran de la fin (peut tre utile plus tard) :



REMARQUE :
On peut voir que tous les fichiers de nagios seront situs dans des sous rpertoires de /usr/local/
Alors que l'installation par apt-get install nagios-x installera les diffrents composants de nagios dans
les diffrents rpertoires systmes suivant leur fonction.
Lavantage dutiliser apt-get pour installer nagios et centreon est que cela limitera les diffrents
problmes dintgration, notamment les problmes avec NDOutils.
(Le fait que tous les fichiers soient dans /usr/local/ nous facilitera la tche, notamment pour lInstall de
centreon)
p. 11


FVT
On compile toutes les sources avec make all


On installe nagios avec make install


On installe le script de lancement (init.d) de nagios avec make install-init


On configure les permissions de nagios avec make install-commandmode


On cr des fichiers exemples (les templates) de nagios avec make install-config

(Ces templates sont dans /usr/local/nagios/etc/ pour les activer ou dsactiver manuellement -
si on le souhaite- il faudra modifier le fichier de config nagios :
/usr/local/nagios/etc/nagios.cfg)

On installe l'interface web de nagios avec make install-webconf


puis on reboot le serveur web apache avec service apache2 restart



p. 12


FVT
3.4 DEMARRAGE NAGIOS

On vrifie la configuration avec :
/usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg



On ajoute le script de lancement de nagios au dmarrage :
update-rc.d nagios defaults

Si on obtient lerreur suivante : missing LSB tags and overrides (pourrais compromettre le
dmarrage automatique de nagios et toute commande du type service nagios ),
-On modifie le script de dmarrage ainsi :
vi /etc/init.d/nagios

- Puis on rajoute au dbut du fichier (dessous #!/bin/sh)
### BEGIN INIT INFO
# Provides: nagios
# Required-Start: $remote_fs $syslog
# Required-Stop: $remote_fs $syslog
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start daemon at boot time
# Description: Enable service provided by daemon.
### END INIT INFO

-On enregistre

p. 13


FVT
-On re-ajoute nagios au lancement au dmarrage de debian avec
update-rc.d nagios defaults

Cest un succs cette fois-ci.

On dmarre Nagios avec
service nagios start


p. 14


FVT
3.5 Test Connexion NAGIOS

On lance un navigateur web sur une machine dans le mme sous rseau que notre debian avec nagios
lanc puis on entre lIP de notre serveur nagios suivi de /nagios
user : nagiosadmin password : System2008

(SI INTERNAL ERROR VOIR APRES CAPTURES ECRAN)




p. 15


FVT
SI PROBLEME avec APACHE 500 ERROR vrifiez que toutes les dpendances sont installes

-Si Oui, crez le fichier d'authentification utilisateur nagios (nagiosadmin) et attribuez lui le
MDP (System2008) avec :
htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin


-Puis redmarrez apache et nagios :
service apache2 restart
service nagios restart



-Si cela ne rsout pas l'erreur vrifiez les logs apache :
cat /var/log/apache2/error.log

p. 16


FVT
3.6 Tlchargement, Compilation et Installation des PLUGINS NAGIOS

On remarque que dans Hosts > LocalHost ou un hte supervis > view status detail les checks
retournent des erreurs.
En effet, les plugins de Nagios (les services) qui effectuent ces checks ne sont pas installs, nous allons
donc le faire :

On fait pareil que pour nagios core pour tlcharger et dcompresser les plugins dispos sur le
site de nagios dans downloads (Attention tre dans /tmp/)
-On rcupre donc le lien de larchive des plugins

-Puis on tlcharge les plugins avec wget, on les extraits avec tar et on se rend dans le dossier
dcompress :



On lance alors la pr-config avec :
./configure --with-nagios-user=nagios --with-nagios-group=nagios


On lance ensuite la compilation avec make all


Puis l'installation avec make install


p. 17


FVT
On relance nagios avec service nagios restart


On retourne sur linterface web, puis petit petit, en fonction de la planification des checks,
les services repassent au vert :


p. 18


FVT
IV) NDOUTILS

NDOutils permet la synchronisation entre Nagios et Centreon, la remonte dinformations sur les
htes monitors par Nagios dans linterface de Centreon :

4.1 Tlchargement et extraction NDOUTILS

On le rcupre (le lien) sur le site de centreon car la version de Nagios est bogue :
http://svn.centreon.com/trunk/Patch-NDOutils/

On fait pareil que pour Nagios pour tlcharger NDOutils (Attention tre dans /tmp/)
wget -r -np http://svn.centreon.com/trunk/Patch-NDOutils/

(-r permet de tlcharger rcursivement et -np de ne pas tlcharger les parents mais juste ce
qui est aprs /Patch-NDOutils/)

On navigue jusque dans le dossier tlcharg du site Patch- :


On donne les droits en excution tout le monde avec chmod -R 777 ./


On lance la prconfig :
./configure --prefix=/usr/local/nagios --enable-mysql --disable-pgsql --with-ndo2db-
user=nagios --with-ndo2db-group=nagios --with-mysql-lib=/usr/lib64/mysql/




p. 19


FVT
On vrifie et on se garde un petit screenshot de la configuration :

p. 20


FVT
4.2 Compilation, Installation et Dmarrage de NDOUTILS

On lance la compilation des sources avec make all


Il ny a pas de script dinstallation ( pas possible de faire un make install par exemple), nous
devons terminer l'installation la main (On copie les fichiers NDOutils puis les fichiers de
configuration et on donne les droits en excution nagios et on le rend propritaire) :
cp ./src/ndomod-3x.o /usr/local/nagios/bin/ndomod.o
cp ./src/ndo2db-3x /usr/local/nagios/bin/ndo2db
cp ./config/ndo2db.cfg-sample /usr/local/nagios/etc/ndo2db.cfg
cp ./config/ndomod.cfg-sample /usr/local/nagios/etc/ndomod.cfg

chmod 774 /usr/local/nagios/bin/ndo*
chmod 774 /usr/local/nagios/etc/ndo*
chown nagios:nagios /usr/local/nagios/bin/ndo*
chown nagios:nagios /usr/local/nagios/etc/ndo*

p. 21


FVT

On donne les droits en excution au script de lancement de NDOutils (daemon-init), puis on le
copie (en le renommant ndo2db) dans le dossier avec les autres scripts de lancement de
debian, et on lajoute au dmarrage :
chmod +x daemon-init
cp daemon-init /etc/init.d/ndo2db
update-rc.d ndo2db defaults


On dmarre NDOutils :
service ndo2db start


p. 22


FVT
V) INSTALLATION DE CENTREON


5.1 Tlchargement de CENTREON

On va maintenant tlcharger centreon de la mme manire que nagios :
http://www.centreon.com/Content-Download/donwload-centreon-monitoring-tools
- On rcupre le lien (pour Centreon on peut prendre la dernire version, dernire teste
fonctionnelle : 2.5.1) :



On copie ladresse du lien de la dernire version stable (clic droit sur le lien > copier ladresse
du lien) puis on va sen servir pour tlcharger centreon dans notre debian avec wget puis
lextraire :


On remarque que le fichier est sauvegard sous index.php ?id= , Ce nest pas grave on
pourra quand mme lextraire.
On lextrait avec tar xzf

p. 23


FVT
5.2 Installation de CENTREON

On va lancer le script dinstallation, puis rpondre la srie de questions concernant la
configuration de notre debian, nagios, les plugins, ndoutils, etc
./install.sh -i

Cela ncessite une bonne connaissance de larborescence de nagios en particulier.

Les captures dcran et commentaire de la procdure vous renseignent donc :






p. 24


FVT
On accepte la licence GPL et on choisit les programmes centreon installer (oui tous)

On choisit les dossiers o vont tre copis les fichiers de centreon et on les cr (dfauts
recommands)

p. 25


FVT

On indique o sont situs les modules dinterprtation du langage PERL et des plugins PEAR
On indique ensuite le nom dutilisateur et le groupe de centreon et on les cr (par dfaut
recommand)



p. 26


FVT
On indique ensuite la configuration des utilisateurs du moteur de monitoring (nagios) et du broker
(NDOutils)
Puis on va configurer sudo qui permettra centreon de gr les droits des diffrents utilisateurs.
Et indiquer o se sites les fichier de dmarrage de nagios, ainsi que le fichier binaire (excutable) de
nagios, les emplacements des fichiers de configuration de nagios
Et aussi indiquer le dossier de configuration de NDOutils ainsi que son script de lancement


p. 27


FVT
On va ensuite lancer la configuration du serveur apache pour permettre laffichage de la page web
dadministration de centreon et redmarrer apache


p. 28


FVT
On va ensuite installer les modules PERL manquants ou en mettre jour



p. 29


FVT
On indique o les fichiers de centreon doivent tre installs (par dfaut recommand)

On installe ensuite le service CentStorage pour les bases de donnes de centreon et on lajoute au
dmarrage avec ses niveaux de priorits


p. 30


FVT
On indique o sont situs les binaires de centreon et on lance linstallation du noyau de centreon,
ainsi que le script au dmarrage et ses niveaux de priorits

On installe les plugins (on choisit leur dossier, etc.)


p. 31


FVT
On renseigne ensuite lemplacement du programme snmp (utile pour les checks)


LINSTALLATION DE CENTREON EST MAINTENANT TERMINEE, il ne reste plus qu finir la
configuration via linterface web.





p. 32


FVT
5.3 Finalisation de linstallation CENTREON

On se connecte sur linterface web travers un navigateur internet dune machine dans le
mme sous-rseau, en tapant dans la barre dadresse lIP de notre serveur ou est install
centreon, suivi de /centreon.



On arrive sur linterface de configuration de centreon



Toutes les dpendances sont OK


p. 33


FVT
On va configurer laccs de centreon nagios en lui indiquant les rpertoires ou sont situs
diffrents composants requis :

Nagios directory : /usr/local/nagios/
Nagiostats binary : /usr/local/nagios/bin/nagiostats
Nagios image directory : /usr/local/nagios/share/images/

On va maintenant configurer laccs au broker utilis (NDOutils) :

Ndomod binary (ndomod.o) : /usr/local/nagios/bin/ndomod.o

On va entrer les informations du compte de connexion (admin) de centreon :

Ici je rentre administrateur de partout pour le test (notamment en mot de passe, mais vous pouvez en
choisir un autre)
p. 34


FVT
Ici, Centreon demande le mot de passe super-utilisateur de MySQL (saisi lors de linstallation
des dpendances (System2008), voir capture dcran).
Ceci lui permettra de crer sa Base de Donnes centreon avec pour nom dutilisateur
centreon et mot de passe choisi : System2008



Ici centreon nous demande de modifier le fichier de configuration de MySQL afin dy ajouter la
ligne innodb_file_per_table=1, sous la section [mysqld] .

-On va donc diter le fichier /etc/mysql/my.cnf :
vi /etc/mysql/my.cnf
-Puis se rendre dans cette section [mysqld]

p. 35


FVT
-Aller jusqu * InnoDB et rajouter la ligne innodb_file_per_table=1 de cette faon
(noubliez pas denregistrer) :

-On redmarre MySQL :


-On retourne sur linterface web de centreon puis on clique sur refresh
Centreon va maintenant crer et configurer sa Data Base




Linstallation et Configuration de Centreon est enfin termine, on peut cliquer sur finish :

p. 36


FVT
On doit alors se loguer sur linterface web avec les identifiants du compte admin choisis
ltape 5 Admin Information :


On arrive ensuite sur la page daccueil de linterface web de centreon :



Retour dans notre terminal, on lance les services Centreon frachement configurs puis le
snmp :
service centcore start
service centstorage start
service snmptt start
service snmpd start

on reboot
reboot


p. 37


FVT
5.4 Premire utilisation, MANIPULATION

On va maintenant lancer la premire synchronisation entre nagios et centreon via NDOutils
Pour cela, une fois connect linterface web de centreon, se rendre dans :
Configuration > Monitoring Engines > Generate

On slectionne les 3 premires lignes pour crer, vrifier et exporter dans nagios les fichiers
de configuration (hosts.cfg, nagios.cfg), sans redmarrer nagios.


Puis on clique sur export pour lancer les oprations dexportation

On redmarre ensuite le plugin NDOutils avec service ndo2db restart



p. 38


FVT
Puis on retourne dans notre interface web pour redmarrer nagios partir de centreon :




Nos htes apparaissent ensuite (seulement notre serveur centreon pour le moment) :



Pour rajouter un hte on va dans Config > htes > Add
Puis une fois ajout centreon on va lexporter dans nagios avec :
Configuration > Monitoring Engines > Generate
Puis on peut cocher toutes les cases et cliquer sur export


REMARQUE : Il peut y avoir un petit temps dattente avant que les htes soient ajouts la vue
hosts dans Monitoring > Hosts > Hosts