Setup:Centreon2/fr

Un article de Wiki Centreon.

Sommaire

Installation de Centreon

Avant d'aller plus loin, voici une petite astuce pour éviter de saisir les différents chemins vers les binaires utilisés, par exemple : nagios, ndomod, ...

export PATH="$PATH:/usr/local/nagios/bin/"

L'installation de Centreon contient une partie textuelle en ligne de commande et une partie graphique.

Téléchargement de Centreon

Pour télécharger Centreon, deux méthodes existes. La plus courante est de se procurer l'archive sur le site de centreon.

  • Téléchargement via le site
# cd /usr/local/src/
# wget http://download.centreon.com/index.php?id=4242
  • Téléchargement via le serveur SVN
$> svn co http://svn.centreon.com/trunk/tools
$> cd tools
$> dos2unix makePackage.sh
$> chmod +x makePackage.sh
$> ./makePackage.sh

Attention, il est possible de télécharger la dernière version de Centreon présente sur le serveur SVN. Cette version bénéficie des dernières corrections importantes mais peut présenter des bugs.

Désarchivez le paquet et placez vous dans le répertoire obtenu:

# tar -xzf centreon-2.0.2.tar.gz
# cd centreon-2.0.2


Installation en ligne de commande

Ajouter les droits d'écriture sur le fichier sudoers :

# chmod +w /etc/sudoers

Nous allons maintenant lancer le script d'installation. Ce script vous posera tout une liste de questions concernant les répertoires d'installation, les dépendances, etc. Nous essayerons de commenter le plus possibles les divers questions au fur et à mesure de l'avancement.

# ./install.sh -i

Au lancement du script, le programme confirme si toutes les dépendances sont satisfaites.

###############################################################################
#                                                                             #
#                         Centreon (www.centreon.com)                         #
#                          Thanks for using Centreon                          #
#                                                                             #
#                                    v 2.0                                    #
#                                                                             #
#                             infos@oreon-project.org                         #
#                                                                             #
#                   Make sure you have installed and configured               #
#                   sudo - sed - php - apache - rrdtool - mysql               #
#                                                                             #
###############################################################################
------------------------------------------------------------------------
        Checking all needed binaries
------------------------------------------------------------------------
rm                                                         OK
cp                                                         OK
mv                                                         OK
chmod                                                      OK
chown                                                      OK
echo                                                       OK
cat                                                        OK
more                                                       OK
mkdir                                                      OK
find                                                       OK
sed                                                        OK


Ensuite, vous devez accepter la licence d'utilisateur de Centreon (licence GPL Version 2) pour continuer. Si vous refusez cette licence, vous abandonnez l'installation.

This General Public License does not permit incorporating your program into
proprietary programs.  If your program is a subroutine library, you may
consider it more useful to permit linking proprietary applications with the
library.  If this is what you want to do, use the GNU Library General
Public License instead of this License.

Do you accept GPL license ?
[y/n], default to [n]:
> y

Le module d'installation va alors vous demander si vous souhaitez installer les modules : l'interface Web Centreon, Centcore, les plugins Centreon et les Traps handler Centreon.

------------------------------------------------------------------------
        Please choose what do you want to install
------------------------------------------------------------------------

Do you want to install Centreon Web Front
[y/n], default to [n]:
> y

Do you want to install Centreon CentCore
[y/n], default to [n]:
> n

Do you want to install Centreon Nagios Plugins
[y/n], default to [n]:
> y

Do you want to install Centreon Snmp Traps process
[y/n], default to [n]:
> n


L'installer va maintenant procéder à l'installation des différents modules.

Commençons par Centreon Web, l'interface de centreon.

------------------------------------------------------------------------ 
        Start CentWeb Installation
------------------------------------------------------------------------

Where is your Centreon directory?
default to [/usr/local/centreon]
>

Ici on nous demande où installer Centreon. Tapez "Entrée" pour prendre le chemin par défaut sinon saisir un autre chemin. Si le répertoire que vous avez saisi n'existe pas, il vous sera demandé de valider votre choix pour créer le répertoire.

Do you want me to create this directory ? [/usr/local/centreon]
[y/n], default to [n]:
> y
Path /usr/local/centreon                                   OK

Ici on nous demande le répertoire de stockage des journaux/logs de centreon.

Where is your Centreon log directory
default to [/usr/local/centreon/log/]
>

Do you want me to create this directory ? [/usr/local/centreon/log/]
[y/n], default to [n]:
> y
Path /usr/local/centreon/log/                              OK

Très important : l'emplacement des fichiers de configuration de Centreon. Attention si cet endroit venait à changer par la suite, vous seriez obliger de relancer l'installation de Centreon, certains fichiers devant être régénérés.

Where is your Centreon etc directory
default to [/etc/centreon]
>

Do you want me to create this directory ? [/etc/centreon]
[y/n], default to [n]:
> y
Path /etc/centreon                                         OK

Where is your Centreon generation_files directory?
default to [/usr/local/centreon/]
>
Path /usr/local/centreon/                                  OK

Ici le path de RRDs.pm pour centstorage et les plugins ce centreon.

Note: Le chemin du fichier "RRDs.pm" peut changer d'une distribution à l'autre. Sur Fedora il sera de la forme "/usr/lib/perl5/vendor_perl/5.8.8/i386-linux-thread-multi/RRDs.pm", sur Debian "/usr/lib/perl5/RRDs.pm" et sur CentOS 5 64Bits "/usr/lib64/perl5/vendor_perl/5.8.8/x86_64-linux-thread-multi/RRDs.pm".

Where is installed RRD perl modules [RRDs.pm]
default to [/usr/lib/perl5/RRDs.pm]
>/usr/lib/perl5/vendor_perl/5.8.8/i386-linux-thread-multi/RRDs.pm
Path /usr/lib/perl5                                        OK
/usr/bin/rrdtool                                           OK
/usr/bin/mail                                              OK

Localisation de PEAR.php.

Note: Comme pour le fichier suivant, la localité du fichier "PEAR.php" peut changer d'une distribution à l'autre. Sur Fedora, il sera de la forme "/usr/share/pear/PEAR.php", sur Debian "/usr/share/php/PEAR.php" et sur CentOS 64Bits "/usr/share/pear/PEAR.php".

Where is PEAR [PEAR.php]
default to [/usr/share/php/PEAR.php]
>/usr/share/pear/PEAR.php
Path /usr/share/php                                        OK

Maintenant on nous pose tout une série de questions à propos de Nagios. Cela va nous permettre de charger des informations concernant Nagios à partir de l'existant. Cela nous permettra de bien localiser chacune des parties de Nagios.

Where is installed Nagios ?
default to [/usr/local/nagios/]
>
Path /usr/local/nagios/                                    OK

Where is your nagios config file
default to [/usr/local/nagios/etc//nagios.cfg]
>
Path /usr/local/nagios/etc                                 OK

Where is your Nagios var directory ?
default to [/usr/local/nagios/var/]
>
Path /usr/local/nagios/var/                                OK

Where is your Nagios plugins (libexec) directory ?
default to [/usr/local/nagios/libexec/]
>
Path /usr/local/nagios/libexec/                            OK

Where is your nagios binary ?
default to [/usr/local/nagios/bin/nagios]
>
/usr/local/nagios/bin/nagios                               OK

Where is your Nagios image directory ?
default to [/usr/local/nagios/share/images/logos/]
>
Path /usr/local/nagios/share/images/logos/                 OK

Where is your nagiostats binany ?
default to [/usr/local/nagios/bin/nagiostats]
>
/usr/local/nagios/bin/nagiostats                           OK
p1_file : /usr/local/nagios/bin/p1.pl                      OK
/usr/bin/php                                               OK
Finding Apache group :                                     apache
Finding Apache user :                                      apache
Finding Nagios user :                                      nagios
Finding nagios user nagios in /etc/passwd                  OK
Finding Nagios group :                                     nagios
Finding nagios group 'nagios' in /etc/group                OK

Le script nous pose maintenant une question concernant NDO. Il vaut mieux ici répondre positivement à la question. Si nous désirons utiliser Centreon sans NDO, nous ne pourrons pas bénéficier des dernières avancées : AJAX, monitoring performant, etc.

Do you want use NDO ?
[y/n], default to [n]:
> y

Le script nous demande ici l'emplacement de la librairie dynamique de NDO. Ce chemin sera ensuite repris pour configurer correctement Nagios pour fonctionner avec NDO.

Where is your NDO ndomod binary ?
default to [/usr/sbin/ndomod.o]
> /usr/local/nagios/bin/ndomod-3x.o
/usr/local/nagios/bin/ndomod-3x.o                          OK

Ici nous configurons le sudo pour donner les droits à Centreon de faire certaines manipulations (redémarrage de nagios essentiellement).

------------------------------------------------------------------------
        Configure Sudo
------------------------------------------------------------------------

Where is sudo configuration file
default to [/etc/sudoers]
>
/etc/sudoers                                               OK
Nagios init script                                         OK
Your sudo is not configure

Do you want I configure your sudo ? (WARNING)
[y/n], default to [n]:
> y
Configuring Sudo                                           OK

Ici il nous est demandé si nous désirons appliquer la configuration de Apache. Cette version beta ne prend pas en charge les scripts de démarrage httpd sur Fedora, précisez donc non lorsque le script demande s'il faut recharger la configuration. Vous rechargerez le serveur manuellement à la suite de cette installation!

------------------------------------------------------------------------
        Configure Apache server
------------------------------------------------------------------------

Do you want write Apache configuration file ?
[y/n], default to [n]:
> y
Create '/etc/apache2/conf.d/centreon.conf'                 OK
Configuring Apache                                         OK

Do you want reload your Apache ?
[y/n], default to [n]:
> n
Preparing Centreon temporary files

Maintenant commence la préparation et la mise en place des fichiers PHP de centreon.

------------------------------------------------------------------------
        Start Centreon Web Front Installation
------------------------------------------------------------------------
 
In process
Change macros for php file
Change macros for php file                                 OK
Copy CentWeb in system directory
CentWeb file installation                                  OK
Install Centreon cron                                      OK

Les Librairies PEAR : nous avons intégré l'installation des librairies PEAR depuis l'installer. Normalement l'installer est capable d'installer toutes les librairies de manière automatique. Bien sûr pour que cela fonctionne il faut absolument que le serveur ait accès à internet. Sinon il vous faudra procéder à une installation manuelle en téléchargeant chaque paquet PEAR.

Pear Modules
Check PEAR modules
PEAR                            1.5.0       1.4.11         NOK
DB                              1.7.6                      NOK
DB_DataObject                   1.8.4                      NOK
DB_DataObject_FormBuilder       1.0.0RC4                   NOK
MDB2                            2.0.0                      NOK
Date                            1.4.6                      NOK
HTML_Common                     1.2.2                      NOK
HTML_QuickForm                  3.2.5                      NOK
HTML_QuickForm_advmultiselect   1.1.0                      NOK
HTML_Table                      1.6.1                      NOK
Archive_Tar                     1.1         1.3.1          OK
Auth_SASL                       1.0.1                      NOK
Console_Getopt                  1.2         1.2            OK
HTTP                            1.2.2                      NOK
Image_GraphViz                  1.1.0                      NOK
Net_SMTP                        1.2.8                      NOK
Net_Socket                      1.0.1                      NOK
Net_Traceroute                  0.21                       NOK
Net_Ping                        2.4.1                      NOK
Validate                        0.6.2                      NOK
XML_RPC                         1.4.5                      NOK
SOAP                            0.10.1                     NOK
Log                             1.9.11                     NOK

Après avoir affiché l'état dans lequel se trouvent les différentes lib, il vous est proposé de lancer l'installation des librairies de manière automatique.

Do you want I install/upgrade your PEAR modules
[y/n], default to [y]:
> y

Upgrading PEAR modules
PEAR                            1.5.0       1.4.11      1.7OK
Installing PEAR modules
DB                              1.7.6       1.7.13         OK
DB_DataObject                   1.8.4       1.8.8          OK
DB_DataObject_FormBuilder       1.0.0RC4    1.0.0RC7       OK
MDB2                            2.0.0       2.4.1          OK
HTML_QuickForm_advmultiselect   1.1.0       1.4.1          OK
HTML_Table                      1.6.1       1.8.2          OK
Auth_SASL                       1.0.1       1.0.2          OK
HTTP                            1.2.2       1.4.0          OK
Image_GraphViz                  1.1.0       1.2.1          OK
Net_SMTP                        1.2.8       1.3.0          OK
Net_Traceroute                  0.21        0.21.1         OK
Net_Ping                        2.4.1       2.4.3          OK
Validate                        0.6.2       0.8.1          OK
XML_RPC                         1.4.5       1.5.1          OK
SOAP                            0.10.1      0.11.0         OK
Log                             1.9.11      1.10.1         OK

Normalement l'installer a fini d'installer les modules PEAR. Il nous affiche une dernière fois l'état de l'installation des modules PEAR.

Check PEAR modules
PEAR                            1.5.0       1.7.1          OK
DB                              1.7.6       1.7.13         OK
DB_DataObject                   1.8.4       1.8.8          OK
DB_DataObject_FormBuilder       1.0.0RC4    1.0.0RC7       OK
MDB2                            2.0.0       2.4.1          OK
Date                            1.4.6       1.4.7          OK
HTML_Common                     1.2.2       1.2.4          OK
HTML_QuickForm                  3.2.5       3.2.10         OK
HTML_QuickForm_advmultiselect   1.1.0       1.4.1          OK
HTML_Table                      1.6.1       1.8.2          OK
Archive_Tar                     1.1         1.3.2          OK
Auth_SASL                       1.0.1       1.0.2          OK
Console_Getopt                  1.2         1.2.3          OK
HTTP                            1.2.2       1.4.0          OK
Image_GraphViz                  1.1.0       1.2.1          OK
Net_SMTP                        1.2.8       1.3.0          OK
Net_Socket                      1.0.1       1.0.8          OK
Net_Traceroute                  0.21        0.21.1         OK
Net_Ping                        2.4.1       2.4.3          OK
Validate                        0.6.2       0.8.1          OK
XML_RPC                         1.4.5       1.5.1          OK
SOAP                            0.10.1      0.11.0         OK
Log                             1.9.11      1.10.1         OK
All PEAR module                                            OK

L'installer peut ainsi continuer.

------------------------------------------------------------------------
               Centreon Post Install
------------------------------------------------------------------------
 
Create /usr/local/centreon/www/install/install.conf.php    OK
Create /etc/centreon/instCentWeb.conf                      OK

Nous passons maintenant à l'installation de CentStorage, autrefois appelé ODS (Oreon Data Storage). Ce Module de centreon permet d'historiser en base de données RRD et MySQL pour le moment. Centstorage permettra aussi de peupler des graphs pour un meilleur suivi de vos diverses metrics de supervision.

------------------------------------------------------------------------
        Start CentStorage Installation
------------------------------------------------------------------------

Where is your Centreon Run Dir directory?
default to [/var/run/centreon]
>

Do you want me to create this directory ? [/var/run/centreon]
[y/n], default to [n]:
> y
Path /var/run/centreon                                     OK

Where is your CentStorage binary directory
default to [/usr/local/centreon/bin]
>

Do you want me to create this directory ? [/usr/local/centreon/bin]
[y/n], default to [n]:
> y
Path /usr/local/centreon/bin                               OK

Where is your CentStorage RRD directory
default to [/var/lib/centreon]
>

Attention le répertoire lib de centreon doit se trouver sur une partition assez conséquente pour ne pas risquer un encombrement rapide de la partition. Dans ce répertoire se trouvera toutes les bases RRDTool.

Pensez aussi à placer les bases MySQL dans un endroit assez bien taillé. Les base de logs et de données de performances nécessitent beaucoup d'espace disque.

Do you want me to create this directory ? [/var/lib/centreon]
[y/n], default to [n]:
> y
Path /var/lib/centreon                                     OK
Finding Nagios group :                                     nagios
Finding nagios group 'nagios' in /etc/group                OK
Finding Nagios user :                                      nagios
Finding nagios user nagios in /etc/passwd                  OK
Preparing Centreon temporary files
/tmp/centreon-setup exists, it will move...
Creating Centreon Directory '/var/lib/centreon/status'     OK
Creating Centreon Directory '/var/lib/centreon/metrics'    OK
Replace Centstorage Macro                                  OK
Set CentStorage properties                                 OK
Replace Centstorage init script Macro                      OK

Do you want I install CentStorage init script ?
[y/n], default to [n]:
> y

Do you want I install CentStorage run level ?
[y/n], default to [n]:
> y

Adding system startup for /etc/init.d/centstorage ...
  /etc/rc0.d/K30centstorage -> ../init.d/centstorage
  /etc/rc1.d/K30centstorage -> ../init.d/centstorage
  /etc/rc6.d/K30centstorage -> ../init.d/centstorage
  /etc/rc2.d/S40centstorage -> ../init.d/centstorage
  /etc/rc3.d/S40centstorage -> ../init.d/centstorage
  /etc/rc4.d/S40centstorage -> ../init.d/centstorage
  /etc/rc5.d/S40centstorage -> ../init.d/centstorage
Set logAnalyser properties                                 OK
Set nagiosPerfTrace properties                             OK
Install CentStorage cron                                   OK
Create /etc/centreon/instCentStorage                       OK

CentStorage est installé, il reste à installer SNMPTT (Uniquement pour les version > Beta 3)!

Where is your SNMP configuration directory
default to [/etc/snmp]
> 
/etc/snmp                                                  OK
Where is your SNMPTT binaries directory
default to [/opt/snmptt]
> /usr/local/src/centreon-2.0-b3/snmptt
/usr/local/src/centreon-2.0-b3/snmptt    

Il ne reste plus qu'à répondre à quelques questions pour installer les plugins de centreon.

------------------------------------------------------------------------
        Start CentPlugins Installation
------------------------------------------------------------------------

Where is your CentPlugins lib directory
default to [/var/lib/centreon]
>
Path /var/lib/centreon                                     OK
Finding Nagios user :                                      nagios
Finding nagios user nagios in /etc/passwd                  OK
Finding Nagios group :                                     nagios
Finding nagios group 'nagios' in /etc/group                OK
Preparing Centreon temporary files
/tmp/centreon-setup exists, it will move...
CentPlugins is installed

L'installation automatique est maintenant terminée... Quelques étapes manuelles sont encore nécessaires.

Rechargez la configuration d'Apache

  • sur Fedora :
# service httpd reload
  • sur Debian :
# /etc/init.d/apache reload
  • sur OpenSuse :
# /etc/init.d/apache2 reload

Éditez le fichier « /etc/sudoers » et ajoutez la ligne ci-dessous avant la ligne "## END: CENTREON SUDO":

Defaults:CENTREON !requiretty

Puis supprimer les droits d'écriture sur le fichier sudoers :

# chmod -w /etc/sudoers

Si l'interface Web de Nagios a été installée, créer un compte pour accéder à l'interface web de Nagios :

# htpasswd -c /usr/local/nagios/etc/htpasswd.users votre_login

Désactivation de Selinux, éditer le fichier de configuration de SELINUX :

# vi /etc/selinux/config

Et remplacer par le texte en gras :

# This file controls the state of SELinux on the system.
# SELINUX= can take one of these three values:
# enforcing - SELinux security policy is enforced.
# permissive - SELinux prints warnings instead of enforcing.
# disabled - No SELinux policy is loaded.
SELINUX=disabled
# SELINUXTYPE= can take one of these two values:
# targeted - Only targeted network daemons are protected.
# strict - Full SELinux protection.
SELINUXTYPE=targeted

Vous devez redémarrer votre machine pour que cela soit pris en compte.


Installation Web

Nous pouvons maintenant aller sur l'URL suivante : http://SERVER_ADDRESS/centreon/ Nous sommes automatiquement redirigé vers http://SERVER_ADDRESS/centreon/install/setup.php Nous allons maintenant devoir valider les dernières étapes de l'installation.

  • Démarrage de l'installation Web
Step 1

Cliquez sur "Next"

  • Validation de la licence
Step 2

Pour valider, cliquez "I Accept" suivi de "next".

  • Validation des variables d'environnement de l'installation.
Step 3

Attention, sur les distributions Fedora, remplacez "www-data" par "apache". Si vous utilisez une distribution OpenSuse, remplacez "www-data" par "wwwrun". Puis cliquez sur "Next".

  • Validation des Modules PHP et des droits d'accès pour le répertoire de configuration de centreon.
Step 4

Tant que tout n'est pas vert, effectuez les changements pour que cela le devienne, puis cliquez sur "Next".

  • Validation des Modules PEAR
Step 5

Normalement les modules ont été installés lors de l'installation en mode shell. Tout devrait être vert. Cliquez sur "Next".

  • Définir les Accès MySQL
Step 6

Complétez les champs vides suivant : root password, centreon database name, centstorage database name, et les password. La localisation de la base de données est optionnelle. De même pour la localisation de Nagios. Cette option est utilisée uniquement si vous décidez de déporter votre base de données sur un serveur dédié. En version 2.1, 3 bases de données seront alors créés (Centreon -> relatif au fonctionnement de Centreon, Censtorage -> utilisé pour l'historisation, et Centstatus -> la base de données commune à NDO et Centreon).

  • Test de connexion MySQL
Step 7

Si tout est "OK", cliquez "Next" sinon "Back" pour ajuster vos accès à MySQL.

  • Création du user "Administrateur"
Step 8

Veuillez saisir les informations concernant le "Super" Administrateur.

  • Activation de LDAP
Step 9

Si vous désirez activer l'authentification LDAP, cliquez "Yes". Sinon, laissez "No". Ensuite cliquez "Next".

  • Écriture des fichiers de configuration de Centreon et de Centstorage
Step 10

Si tout est "vert", Cliquez sur "Next". Sinon veillez à ce que les droits du répertoire "etc" de Centreon soit en écriture pour Apache. Selinux peut bloquer cette étape, pensez à le désactiver, redémarrer la machine et relancer l'installation web pour passer cette étape. Cliquez ensuite sur "Next".

  • Création des bases de données et mise en place d'une configuration standard.
Step 11

Cliquez "Next".

  • Fin de L'installation.
Step 12

Pour du support communautaire, consultez les liens présents sur la page (WebSite, forum, Doc). Du support professionnel vous est aussi proposé.

  • Première connexion!
Step 13

Vous pouvez maintenant vous authentifier sur le portail de Centreon. Il ne vous reste plus qu'à configurer vos vérifications.

Installation de la base NDO

Dans un terminal, taper les commandes suivantes :

# mysql -u root -p
mysql> CREATE DATABASE `ndo` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
mysql> exit;
mysql -u root -p ndo < /usr/local/src/centreon-2.0.1/www/install/createNDODB.sql
# mysql -u root -p
mysql> GRANT SELECT, INSERT, UPDATE, DELETE ON `ndo` . * TO 'centreon'@'localhost';
mysql> exit;

Configuration de SNMP

Éditez le fichier de configuration de snmpd pour ajouter la communauté « votre_communauté » :

# cp /etc/snmp/snmpd.conf /etc/snmp/snmpd.conf.origin
# rm /etc/snmp/snmpd.conf	
# vi /etc/snmp/snmpd.conf

et ajoutez la ligne suivante à la fin du fichier :

rocommunity votre_communauté

Pour que les check_snmp fonctionnent, il faut modifier le fichier /etc/snmp/snmpd.conf pour avoir :

#       sec.name  source          community
#com2sec paranoid  default         public
com2sec readonly  default         public
#com2sec readwrite default         private

Enfin, il faut ouvrir le port udp 161 sur chaque collecteur que l'on veut surveiller. Avant la ligne

-A RH-Firewall-1-INPUT -j REJECT --reject-with icmp-host-prohibited

ajouter :

-A RH-Firewall-1-INPUT -p udp -m udp --dport 161 -j ACCEPT

Redémarrer le service iptables pour prendre en compte la modification, ainsi que le service snmpd :

# /etc/init.d/iptables restart
# /etc/init.d/snmpd restart

Ajout de services au démarrage

Sur les collecteurs :

# /sbin/chkconfig --level 35 snmpd on
# /sbin/chkconfig --level 35 snmptrapd on
# /sbin/chkconfig --level 35 nagios on
# /sbin/chkconfig --level 01246 nagios off

Sur le serveur central :

# /sbin/chkconfig --level 35 snmpd on
# /sbin/chkconfig --level 35 ndo2db on 
# /sbin/chkconfig --level 01246 ndo2db off 
# /sbin/chkconfig --level 35 nagios on
# /sbin/chkconfig --level 01246 nagios off
# /sbin/chkconfig --level 35 httpd on
# /sbin/chkconfig --level 35 mysqld on
Outils personnels