Vous êtes ici:

Nous allons tester l'installation des sources Centreon version 20.04 avec Debian Buster. Nous n'utiliserons pas les paquets centreon-engine fournis par la communauté Debian car ceux-ci correspondent à la version 18.10. Grande nouveauté de la version 20.04, l'abandon de centcore au profit d'un nouveau gestionnaire d'événement gorgone. Pour l'installation d'une plateforme distribuée, voir le tutoriel Installation d'un poller distant.

Avis aux lecteurs
- Suite à l'arrêt du service Bintray pour Conan le 1er mai 2021, j'ai dû modifier ce tutoriel pour la compilation du connecteur, du moteur et du broker. Un grand merci au staff des dev de Centreon pour leur réactivité.
- Comme les paquets sources ne sont pas encore en ligne, je vous mets la deuxième solution en téléchargeant les dépôts GitHub.

1 Préparation de la VM

1.1 Mise à jour et ssh

Afin de travailler dans de bonnes conditions et d’utiliser les fonctions copier/coller de Putty ou d’une session Terminal, il est nécessaire d’installer un serveur ssh. Connectez-vous en root sur le serveur Debian, et saisissez la commande suivante :

Nouveauté Buster
Si vous vous connectez avec un utilisateur sans droit d'administration et que vous élevez vos privilèges en root, il faut lancez la commande su avec le paramètre suivant :

su -

Sinon vous n'aurez pas le path des dossiers sbin ou sont situés les exécutables pour l'administration.

Il se peut que l’installation échoue si l’installation de Debian est trop ancienne par rapport aux nouveaux patchs de sécurisation, dans ce cas saisissez les commandes suivantes afin de mettre le serveur Debian à jour :

apt update && apt upgrade -y

2 Installation de Centreon Clib

Centreon Clib est une librairie commune, écrite en C/C++, pour certains modules de Centreon. C'est un pré-requis nécessaire au fonctionnement de Centreon-Engine. Contrairement aux autres installations précédentes de mon site, nous installerons la librairie partagée dans le dossier /usr/lib. Nous éviterons l’utilisation de la commande ldconfig.

2.1 Pré requis

Installons les paquets nécessaires au fonctionnement de cette librairie.

apt install cmake python3-pip -y

Astuces
Lors de l'installation des packages Debian, si vous avez ces messages d'erreurs non-bloquants :
locales

Vous devrez configurer les paramètres régionaux (locale settings)

dpkg-reconfigure locales

Il faudra, dans notre exemple, sélectionner la langue fr_FR.UTF-8.

2.2 Installation

2.2a Installation via le github Centreon

Téléchargez le paquet git

apt install git -y

Téléchargez le dépôt github

cd /usr/local/src
git clone -b 20.04.x https://github.com/centreon/centreon-clib 
cd centreon-clib
mkdir build
cd build

2.2b Installation via les paquets sources

Attention, n'utilisez pas cette solution jusqu'à nouvel avis

Téléchargez le binaire dans le dossier /usr/local/src et décompressez-le.

cd /usr/local/src
wget http://files.download.centreon.com/public/centreon-clib/centreon-clib-20.04.1.tar.gz
tar xzf centreon-clib-20.04.1.tar.gz 
cd centreon-clib-20.04.1
mkdir build
cd build

Préparons la compilation. Attention, notez les deux points à la fin de la ligne de commande.

cmake \
       -DWITH_TESTING=0 \
       -DWITH_PREFIX=/usr  \
       -DWITH_SHARED_LIB=1 \
       -DWITH_STATIC_LIB=0 \
       -DWITH_PKGCONFIG_DIR=/usr/lib/pkgconfig ..

Extrait du résultat

-- Configuration Summary
-- ---------------------
--
--   Project
--     - Name                      Centreon Clib
--     - Version                   20.04.2
--     - With shared library       Yes
--     - With static library       No
--
--   System
--     - Name                      Linux
--     - Version                   4.19.0-13-amd64
--     - Processor                 x86_64
--
--   Build
--     - Compiler                  /usr/bin/c++ (GNU)
--     - Extra compilation flags    -std=c++14
--     - Build unit tests          No
--
--   Installation
--     - Prefix                    /usr
--     - Library directory         /usr/lib
--     - Include directory         /usr/include
--     - Package                   None
--     - pkg-config directory      /usr/lib/pkgconfig
--
-- Configuring done
-- Generating done
-- Build files have been written to: /usr/local/src/centreon-clib/build

Ensuite compilez cette configuration et terminez par l’installation. Ne tenez pas compte des messages d'erreur du à la version du compilateur C++ plus restrictive. La librairie étant copiée dans le dossier /usr/lib, celle-ci est automatiquement prise en compte.

make && make install

C'est terminé pour Centreon Clib, nous pouvons continuer par l'installation des connecteurs Centreon.

3 Installation des connecteurs Centreon

Centreon Perl Connector et Centreon SSH connecteur sont des modules optionnels améliorant la vitesse d'exécution des plugins en scripts Perl et en SSH. Ils nécessitent l'utilisation de Centreon Engine. Vous trouverez un article expliquant les avantages de l'utilisation d'un connecteur Perl. Nouveauté avec la version 20.04, l'utilisation de conan pour gérer les dépendances de C++. Simplification, les deux connecteurs seront compilés en même temps.

3.1 Pré requis

Tout d'abord, installons les paquets nécessaires au fonctionnement de ces connecteurs.

apt install libperl-dev libssh2-1-dev libgcrypt-dev -y

Installons maintenant conan

pip3 install conan

L'installation, au préalable, de Centreon Clib est obligatoire.

3.2 Installation

3.2a Installation via le github Centreon

Téléchargez le dépôt github

cd /usr/local/src
git clone -b 20.04.x https://github.com/centreon/centreon-connectors
cd centreon-connectors
mkdir build
cd build

3.2b Installation via les paquets sources

Attention, n'utilisez pas cette solution jusqu'à nouvel avis

La dernière version stable est la 20.04.0. Téléchargez le binaire dans le dossier /usr/local/src et décompressez-le.

cd /usr/local/src
wget http://files.download.centreon.com/public/centreon-connectors/centreon-connectors-20.04.0.tar.gz
tar xzf centreon-connectors-20.04.0.tar.gz 
cd centreon-connectors-20.04.0
mkdir build
cd build

Installons les librairies C++ nécessaires.

conan install .. -s compiler.libcxx=libstdc++11 --build=missing

Préparons la compilation.

cmake \
  -DWITH_PREFIX=/usr \
  -DWITH_PREFIX_BINARY=/usr/lib/centreon-connector  \
  -DWITH_CENTREON_CLIB_INCLUDE_DIR=/usr/include \
  -DWITH_TESTING=0 ..

Extrait du résultat

-- The CXX compiler identification is GNU 8.3.0
-- Check for working CXX compiler: /usr/bin/c++
-- Check for working CXX compiler: /usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Could NOT find PkgConfig (missing: PKG_CONFIG_EXECUTABLE)
-- Could NOT find PkgConfig (missing: PKG_CONFIG_EXECUTABLE)
-- Found Perl: /usr/bin/perl (found version "5.28.1")
-- Found PerlLibs: /usr/lib/x86_64-linux-gnu/libperl.so.5.28 (found version "5.28.1")
INFO -D_REENTRANT -D_GNU_SOURCE -DDEBIAN -fwrapv -fno-strict-aliasing -pipe -I/usr/local/include -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64  -I/usr/lib/x86_64-linux-gnu/perl/5.28/CORE
-- Conan: Using autogenerated Findfmt.cmake
-- Found fmt: 7.1.3 (found version "7.1.3")
-- Library fmt found /root/.conan/data/fmt/7.1.3/_/_/package/56e0cf6d16ee57367a0661ab743f4e43b29223f8/lib/libfmt.a
-- Found: /root/.conan/data/fmt/7.1.3/_/_/package/56e0cf6d16ee57367a0661ab743f4e43b29223f8/lib/libfmt.a
-- Conan: Using autogenerated Findspdlog.cmake
-- Found spdlog: 1.8.5 (found version "1.8.5")
-- Library spdlog found /root/.conan/data/spdlog/1.8.5/_/_/package/c7e1b1004c948250b7562beecd9031d66e8b92a7/lib/libspdlog.a
-- Found: /root/.conan/data/spdlog/1.8.5/_/_/package/c7e1b1004c948250b7562beecd9031d66e8b92a7/lib/libspdlog.a
-- Conan: Dependency fmt already found
-- Library spdlog found /root/.conan/data/spdlog/1.8.5/_/_/package/c7e1b1004c948250b7562beecd9031d66e8b92a7/lib/libspdlog.a
-- Found: /root/.conan/data/spdlog/1.8.5/_/_/package/c7e1b1004c948250b7562beecd9031d66e8b92a7/lib/libspdlog.a
-- Configuring done
-- Generating done
-- Build files have been written to: /usr/local/src/centreon-connectors/build

Ensuite compilons cette configuration et installons dans le dossier /usr/lib/centreon-connector/

make && make install

C'est terminé, nous pouvons continuer par l'installation de Centreon Engine.

4 Installation de Centreon Engine

Ce chapitre présente l'installation du moteur de supervision créé par l'équipe de Centreon. Nous utiliserons la dernière version 20.04. Nous en profiterons pour installer les scripts systemd.

4.1 Pré Requis

Tout d'abord, Il faudra créer un utilisateur centreon-engine

groupadd -g 6001 centreon-engine
useradd -u 6001 -g centreon-engine -m -r -d /var/lib/centreon-engine -c "Centreon-engine Admin" -s /bin/bash centreon-engine

L'installation, au préalable, de Centreon Clib est obligatoire.
Il faut aussi installer des paquets supplémentaires.

apt install libcgsi-gsoap-dev zlib1g-dev libssl-dev libxerces-c-dev -y

4.2 Installation

4.2a Installation via le github Centreon

Téléchargez le dépôt github

cd /usr/local/src
git clone -b 20.04.x https://github.com/centreon/centreon-engine
cd centreon-engine
mkdir build
cd build

4.2b Installation via les paquets sources

Attention, n'utilisez pas cette solution jusqu'à nouvel avis

La dernière version stable est la 20.04.11. Téléchargez le binaire dans le dossier /usr/local/src et décompressez-le.

cd /usr/local/src
wget http://files.download.centreon.com/public/centreon-engine/centreon-engine-20.04.11.tar.gz
tar xzf centreon-engine-20.04.11.tar.gz 
cd centreon-engine-20.04.11
mkdir build
cd build

Installons les librairies C++ nécessaires.

conan install .. -s compiler.libcxx=libstdc++11 --build=missing

Préparons la compilation.

cmake  \
    -DWITH_CENTREON_CLIB_INCLUDE_DIR=/usr/include  \
    -DWITH_CENTREON_CLIB_LIBRARY_DIR=/usr/lib  \
    -DWITH_PREFIX=/usr  \
    -DWITH_PREFIX_BIN=/usr/sbin  \
    -DWITH_PREFIX_CONF=/etc/centreon-engine  \
    -DWITH_USER=centreon-engine  \
    -DWITH_GROUP=centreon-engine  \
    -DWITH_LOGROTATE_SCRIPT=1 \
    -DWITH_VAR_DIR=/var/log/centreon-engine  \
    -DWITH_RW_DIR=/var/lib/centreon-engine/rw  \
    -DWITH_STARTUP_SCRIPT=systemd  \
    -DWITH_STARTUP_DIR=/lib/systemd/system  \
    -DWITH_PKGCONFIG_SCRIPT=1 \
    -DWITH_PKGCONFIG_DIR=/usr/lib/pkgconfig  \
    -DWITH_TESTING=0  ..

Extrait du résultat

-- Configuration Summary
-- ---------------------
--
--   Project
--     - Name                        Centreon Engine
--     - Version                     20.04.13
--
--   System
--     - Name                        Linux
--     - Version                     4.19.0-13-amd64
--     - Processor                   x86_64
--
--   Build
--     - Compiler                    /usr/bin/c++ (GNU)
--     - Extra compilation flags      -std=c++14
--     - Build static core library   yes
--     - External commands module    enabled
--     - Unit tests                  disabled
--     - pkg-config script           enabled
--     - logrotate script            enabled
--     - Startup script              Systemd script
--
--   Install
--     - Prefix                      /usr
--     - Binary prefix               /usr/sbin
--     - Configuration prefix        /etc/centreon-engine
--     - Library prefix              /usr/lib/centreon-engine
--     - Include prefix              /usr/include/centreon-engine
--     - var directory               /var/log/centreon-engine
--     - Log archive directory       /var/log/centreon-engine/archives
--     - RW directory                /var/lib/centreon-engine/rw
--     - pkg-config directory        /usr/lib/pkgconfig
--     - logrotate directory         /etc/logrotate.d
--     - Startup directory           /lib/systemd/system
--     - User                        centreon-engine
--     - Group                       centreon-engine
--     - Package                     None
--
--   Libraries
--     - clib include directory      /usr/include
--     - clib library directory      /usr/lib/libcentreon_clib.so
-- Configuring done
-- Generating done
-- Build files have been written to: /usr/local/src/centreon-engine/build

Ensuite compilons cette configuration et installons dans le système de fichiers.

make && make install

Pour vérifier, avant de continuer, le bon fonctionnement de la librairie partagée, saisissez la commande suivante:

centengine -V
[1620812307] [29735] Centreon Engine 20.04.13
[1620812307] [29735]
[1620812307] [29735] Copyright 1999-2009 Ethan Galstad
[1620812307] [29735] Copyright 2009-2010 Nagios Core Development Team and Community Contributors
[1620812307] [29735] Copyright 2011-2018 Centreon
[1620812307] [29735]
[1620812307] [29735] This program is free software: you can redistribute it and/or
[1620812307] [29735] modify it under the terms of the GNU General Public License version 2
[1620812307] [29735] as published by the Free Software Foundation.
[1620812307] [29735]
[1620812307] [29735] Centreon Engine is distributed in the hope that it will be useful,
[1620812307] [29735] but WITHOUT ANY WARRANTY; without even the implied warranty of
[1620812307] [29735] MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
[1620812307] [29735] General Public License for more details.
[1620812307] [29735]
[1620812307] [29735] You should have received a copy of the GNU General Public License
[1620812307] [29735] along with this program. If not, see
[1540917958] [62218] <http://www.gnu.org/licenses/>.

Mettre le service centengine en démarrage automatique. Nous verrons plus loin la création d'un cgroup centreon nécessaire au démarrage du service (paragraphe 8.9a)

systemctl enable centengine.service && systemctl daemon-reload

L'installation de Centreon-Engine est terminée, il faut passer à l'installation des plugins.

5 Installation des Plugins pour Centreon-Engine

Les plugins, appelés aussi sondes, sont des programmes exécutables obligatoires pour faire fonctionner notre supervision. Les plugins ne sont pas installés par défaut. Il faut les télécharger et faire leur installation. Depuis quelques temps, Les plugins historiques peuvent être récupérés sur deux sites différents, le site de nagios-plugins.org et le site monitoring-plugins.org. D'autres plugins, principalement en Perl, seront fournis avec l’interface de Centreon.
Depuis peu, l’équipe de Centreon a réalisé ses propres plugins en Perl. Ces plugins font parti intégrante de cette version donc ces plugins sont nécessaires à l'installation.

5.1 Plugins historiques

5.1.a Installation par les paquets Debian

Installons le paquet des plugins historiques. Grâce aux dépendances, les paquets nécessaires au fonctionnement de ces plugins s'installeront automatiquement.

apt install monitoring-plugins -y

5.1.b Installation par les sources, prérequis

Tout d'abord, installons les paquets nécessaires au fonctionnement des plugins historiques pour Debian.

apt install libgnutls28-dev libssl-dev libkrb5-dev libldap2-dev libsnmp-dev gawk libwrap0-dev libmcrypt-dev smbclient fping gettext dnsutils libmodule-build-perl libmodule-install-perl libnet-snmp-perl -y

5.1.c Installation par les sources, récupération des plugins sur le site de nagios-plugins.org

cd /usr/local/src
wget http://nagios-plugins.org/download/nagios-plugins-2.3.3.tar.gz

Décompression

tar -xzf nagios-plugins-2.3.3.tar.gz
cd nagios-plugins-2.3.3

5.1.d Installation par les sources, ou sur le site de monitoring-plugins.org

cd /usr/local/src
wget --no-check-certificate https://www.monitoring-plugins.org/download/monitoring-plugins-2.3.1.tar.gz

Décompression

tar -xzf monitoring-plugins-2.3.1.tar.gz
cd monitoring-plugins-2.3.1

5.1.e Installation par les sources, compilation et installation

./configure --with-nagios-user=centreon-engine --with-nagios-group=centreon-engine --prefix=/usr/lib/nagios/plugins --libexecdir=/usr/lib/nagios/plugins --enable-perl-modules --with-openssl=/usr/bin/openssl
make 
make install

5.2 Plugin Centreon

Pour utiliser la majorité des plugins Centreon, vous aurez besoin des paquets suivants.

apt install libxml-libxml-perl libjson-perl libwww-perl libxml-xpath-perl libnet-telnet-perl libnet-ntp-perl libnet-dns-perl libnet-ldap-perl libdbi-perl libdbd-mysql-perl libdbd-pg-perl libdatetime-perl liburi-encode-perl libdate-manip-perl -y

Téléchargez le dernier binaire dans le dossier /usr/local/src et décompressez-le.

cd /usr/local/src
wget http://files.download.centreon.com/public/centreon-plugins/centreon-plugins-20201006.tar.gz
tar xzf centreon-plugins-20201006.tar.gz 
cd centreon-plugins-20201006

Le chemin utilisé pour les plugins Centreon est préconisé pour une installation centreon-web > 2.8.x. Les fichiers avec extension pl sont des fichiers perl fastpacked.

chmod +x *
mkdir -p /usr/lib/centreon/plugins
mv * /usr/lib/centreon/plugins/

6 Installation de Centreon-Broker

L'équipe de Centreon a développé son propre broker plus modulaire et plus performant que celui proposé par Nagios, NDOutil. Il est, depuis peu, compatible avec Nagvis grâce à un connecteur spécifique. Cette nouvelle version de broker intègre un nouveau connecteur utilisant l'interpréteur LUA. Avec la version 20.04, nous pouvons utiliser le paquet rrdtools livré avec Buster.

6.1 Pré requis

Tout d'abord, Il faudra créer un groupe système et un utilisateur système centreon-broker

groupadd -g 6002 centreon-broker
useradd -u 6002 -g centreon-broker -m -r -d /var/lib/centreon-broker -c "Centreon-broker Admin"  -s /bin/bash centreon-broker

Comme vous utilisez Centreon-Engine, celui-ci devra accéder au dossier log de Centreon-Broker pour exécuter son module cbmod.so. Pour cela, l'utilisateur centreon-engine devra être membre du groupe centreon-broker.

usermod -aG centreon-broker centreon-engine

Il faut aussi installer des paquets supplémentaires.

apt install git librrd-dev libmariadb-dev libgnutls28-dev lsb-release liblua5.2-dev -y

6.2 Installation

6.2a Installation via le github Centreon

Téléchargez le dépôt github

cd /usr/local/src
git clone -b 20.04.x https://github.com/centreon/centreon-broker
cd centreon-broker
mkdir build
cd build

6.2b Installation via les paquets sources

Attention, n'utilisez pas cette solution jusqu'à nouvel avis

Téléchargez le binaire dans le dossier /usr/local/src et décompressez-le.

cd /usr/local/src
wget http://files.download.centreon.com/public/centreon-broker/centreon-broker-20.04.9.tar.gz
tar xzf centreon-broker-20.04.9.tar.gz
cd centreon-broker-20.04.9
mkdir build
cd build

Installons les librairies C++ nécessaires.

conan install .. -s compiler.libcxx=libstdc++11 --build=missing

Préparons la compilation.

cmake \
      -DWITH_DAEMONS='central-broker;central-rrd' \
      -DWITH_GROUP=centreon-broker \
      -DWITH_PREFIX=/usr  \
      -DWITH_PREFIX_BIN=/usr/sbin  \
      -DWITH_PREFIX_CONF=/etc/centreon-broker  \
      -DWITH_PREFIX_LIB=/usr/lib/centreon-broker \
      -DWITH_PREFIX_VAR=/var/lib/centreon-broker \
      -DWITH_PREFIX_MODULES=/usr/share/centreon/lib/centreon-broker \
      -DWITH_STARTUP_SCRIPT=systemd  \
      -DWITH_STARTUP_DIR=/lib/systemd/system  \
      -DWITH_TESTING=0 \
      -DWITH_USER=centreon-broker ..

Extrait du résultat

-- Configuration Summary
-- ---------------------
--
--   Project
--     - Name                       Centreon Broker
--     - Version                    20.04.14
--
--   System
--     - Name                       Linux
--     - Version                    4.19.0-13-amd64
--     - Processor                  x86_64
--
--   Build
--     - Compiler                   /usr/bin/c++ (GNU)
--     - Extra compilation flags     -std=c++14
--     - Unit tests                 disabled
--     - Startup script             systemd
--     - Module                     stats, neb, correlation, rrd, sql, storage, influxdb, graphite, bam, tcp, tls, lua
--
--   Install
--     - Prefix                     /usr
--     - Binary prefix              /usr/sbin
--     - Library prefix             /usr/lib/centreon-broker
--     - Modules prefix             /usr/share/centreon/lib/centreon-broker
--     - Include prefix             /usr/include/centreon-broker
--     - Configuration prefix       /etc/centreon-broker
--     - Startup dir                /lib/systemd/system
--     - User                       centreon-broker
--     - Group                      centreon-broker
--     - Package                    None
--
-- Configuring done
-- Generating done
-- Build files have been written to: /usr/local/src/centreon-broker/build

Ensuite compilons cette configuration et installons dans le système de fichiers.

make && make install

Mettre le service cbd en démarrage automatique.

systemctl enable cbd.service && systemctl daemon-reload

L'installation de Centreon-Broker est terminée, il faut passer à l’installation de Centreon. Si vous n’avez pas configuré SNMP, il est temps de le faire.

7 Installation du protocole SNMP

La gestion des traps SNMP exige l’installation d’un paquet supplémentaire.

7.1 Prérequis

Installons les paquets nécessaires pour le SNMP

apt install snmp snmpd snmptrapd libnet-snmp-perl libsnmp-perl libmodule-build-perl libmodule-install-perl -y

7.2 Paramétrages

Pour le fonctionnement du SNMP, modifiez le fichier /etc/snmp/snmpd.conf. Pour une installation standalone (1 Central), cette configuration suffira.

agentAddress udp:localhost:161
rocommunity public localhost

Pour une installation distribuée (1 Central et 1 poller), il est fortement conseillé de faire une supervision croisée : le Central supervise le poller distant et inversement. On utilisera cette configuration en remplaçant le mot clé par l'adresse IP du poller distant.

agentAddress udp:161
rocommunity public <IP Poller distant>

Pour éviter d’avoir un deamon snmpd trop bavard, (réduction des logs), modifier le fichier /lib/systemd/system/snmpd.service

.....
ExecStart=/usr/sbin/snmpd -LS4d -Lf /dev/null -u Debian-snmp -g Debian-snmp -I -smux,mteTrigger,mteTriggerConf -f -p /run/snmpd.pid
.....

Et pour recevoir les traps modifier le fichier /etc/default/snmptrapd

# snmptrapd options (use syslog).
TRAPDOPTS='-On -Lsd -p /run/snmptrapd.pid'

Ou cette modification, si vous voulez avoir les logs des traps reçus. Attention, évitez d'activer cette options si vous avez un nombre de traps très importants, le fichiers de logs augmentera très vite.

# snmptrapd options (use syslog).
TRAPDOPTS='-On -Lsdf /var/log/snmptrapd.log -p /run/snmptrapd.pid'

7.3 Installation des mibs

7.3a Modification du dépôt Debian

Modifiez le fichier /etc/apt/sources.list. Rajoutez non-free sur les dépôts.

deb http://ftp.fr.debian.org/debian/ buster main non-free
deb-src http://ftp.fr.debian.org/debian/ buster main non-free

Faites une mise à jour

apt update

7.3b Ajout des mibs

Il vous reste à rajouter les mibs

apt install snmp-mibs-downloader -y

7.3c Modification de la configuration SNMP

Commentez la ligne du fichier /etc/snmp/snmp.conf

#mibs :

Redémarrez les services SNMP

systemctl daemon-reload && systemctl restart snmpd snmptrapd

7.3d Vérification du fonctionnement

Pour vérifier le fonctionnement pour la configuration en standalone, saisir la ligne suivante

snmpwalk -c public -v 2c localhost

Pour la configuration en standalone, saisir la ligne suivante sur le poller distant configuré.

snmpwalk -c public -v 2c <IP Central Centreon>

Vous devez obtenir une très longue liste d'OID SNMP.

8 Installation de Centreon Web

L’installation de l’interface graphique de Centreon se fait en deux temps. Premièrement, commencez votre installation en ligne de commande, puis terminez par l’utilisation de l’interface Web.

8.1 Prérequis

Tout d'abord, Il faudra créer un utilisateur centreon

groupadd -g 6000 centreon
useradd -u 6000 -g centreon -m -r -d /var/lib/centreon -c "Centreon Admin" -s /bin/bash centreon

Rajoutez l'utilisateur centreon-broker dans le groupe centreon. Ceci permettra au broker de créer les fichier RRD.

usermod -aG centreon centreon-broker

Il faut installer les paquets supplémentaires.

apt install php php7.3-opcache libapache2-mod-php php-mysql php-curl php-json php-gd php-intl php-mbstring php-xml php-zip php-fpm php-readline ntp rrdtool php-sqlite3 php-pear sudo tofrodos bsd-mailx lsb-release mariadb-server libconfig-inifiles-perl libcrypt-des-perl librrds-perl libdigest-hmac-perl libdigest-sha-perl libgd-perl php-ldap php-snmp php7.3-db php-date -y

Activons les modules

a2enmod proxy_fcgi setenvif proxy rewrite
a2enconf php7.3-fpm
a2dismod php7.3
systemctl restart apache2 php7.3-fpm

Nouveauté avec la version 19.10.x, il faut obligatoirement configurer le paramètre date.timezone pour le php-fpm. Pour cela, éditez le fichier de configuration pour apache. Attention, bien respectez la casse et ne pas mettre d'espace.

vi /etc/php/7.3/fpm/php.ini

Saisissez la valeur adaptée à votre configuration.

[Date]
; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = Europe/Paris

8.2 préparation de MariaDB

La version Centreon 20.04 autorise maintenant le mode strict, il n'est plus nécessaire de paramétrer la variable sql_mode.

Remarques droit Mysql avec Debian
Pour effectuer des tests rapides sur une installation de préprod, vous pouvez désactiver la sécurité en utilisant root sans mot de passe. Pour cela, ouvrir une session mysql.

mysql
MariaDB [(none)]> use mysql;
MariaDB [mysql]> update user set plugin='' where user='root';
MariaDB [mysql]> flush privileges;

Vous pouvez aussi utiliser cette commande

/usr/bin/mysql <<EOF
use mysql;
update user set plugin='' where user='root';
flush privileges;
EOF

Afin de pouvoir partitioner certaines tables de la base centreon_storage, modifiez le fichier de configuration systemd de MySQL en ajoutant le fichier suivant.

mkdir /etc/systemd/system/mariadb.service.d

tee /etc/systemd/system/mariadb.service.d/limitnofile.conf <<EOF
[Service]
LimitNOFILE=32000
EOF

Ajouter le fichier suivant pour finir la configuration.

tee /etc/mysql/conf.d/centreon.cnf <<EOF
#
# Custom MySQL/MariaDB server configuration for Centreon
#
[server]
innodb_file_per_table=1
open_files_limit = 32000

key_buffer_size = 256M
sort_buffer_size = 32M
join_buffer_size = 4M
thread_cache_size = 64
read_buffer_size = 512K
read_rnd_buffer_size = 256K
max_allowed_packet = 8M

# For 4 Go Ram
#innodb_additional_mem_pool_size=512M
#innodb_buffer_pool_size=512M

# For 8 Go Ram
#innodb_additional_mem_pool_size=1G
#innodb_buffer_pool_size=1G
EOF

Redémarrez le serveur MySql en prenant compte les modifications.

systemctl daemon-reload && systemctl restart mysql

8.3 Installation de Gorgone

Nouveautés de la version 20.04, installation d'un nouveau gestionnaire d'événements remplaçant centcore.

8.3a Prérequis pour les librairies

Installer les paquets suivants

apt install libzmq3-dev libssh-dev libextutils-makemaker-cpanfile-perl libmodule-build-perl libmodule-install-perl -y

8.3b Installation ZMQ-LibZMQ4

cd /usr/local/src
wget http://search.cpan.org/CPAN/authors/id/M/MO/MOSCONI/ZMQ-LibZMQ4-0.01.tar.gz
tar zxf ZMQ-LibZMQ4-0.01.tar.gz && cd ZMQ-LibZMQ4-0.01
sed -i -e "s/tools/.\/tools/g" Makefile.PL
perl Makefile.PL
make && make install
cd ..
wget https://cpan.metacpan.org/authors/id/D/DM/DMAKI/ZMQ-Constants-1.04.tar.gz
tar zxf ZMQ-Constants-1.04.tar.gz && cd ZMQ-Constants-1.04
perl Makefile.PL
make && make install

8.3c Installation lib-ssh

cd /usr/local/src
git clone https://github.com/garnier-quentin/perl-libssh.git
cd perl-libssh
perl Makefile.PL
make
make install

Alternatives pour l'installation des librairies
Autre méthode proposée par Bruno D, l'utilisation de cpan

cpan install ZMQ::LibZMQ4 ZMQ::Constants Libssh::Session Libssh::Sftp

8.3d Autre prérequis

Installer les paquets suivants

apt install libcryptx-perl libschedule-cron-perl libcrypt-cbc-perl libcpanel-json-xs-perl libjson-pp-perl libyaml-perl libyaml-libyaml-perl libdbd-sqlite3-perl libdbd-mysql-perl libapache-dbi-perl libdata-uuid-perl libhttp-daemon-perl libhttp-message-perl libmime-base64-urlsafe-perl libdigest-md5-file-perl libwww-curl-perl libio-socket-ssl-perl libnetaddr-ip-perl libhash-merge-perl -y

8.3e Installation en ligne de commande

Téléchargez le binaire du 09/02/2021 dans le dossier /usr/local/src et décompressez-le.

cd /usr/local/src
wget http://files.download.centreon.com/public/centreon-gorgone/centreon-gorgone-20.04.10.tar.gz
tar xzf centreon-gorgone-20.04.10.tar.gz
cd centreon-gorgone-20.04.10

Lancez la ligne de commande ci-dessous pour débuter l'installation.

./install.sh -i

Au lancement du script, le programme demande de lire la licence

###############################################################################
#                                                                             #
#                                                                             #
#                        Centreon Gorgone daemon module                       #
#                                                                             #
#                                                                             #
###############################################################################


Please read the license.
	Press enter to continue.

Acceptez la licence. L'installation vérifie les prérequis.

Do you accept the license ?
[y/n], default to [n]:
> y
------------------------------------------------------------------------
	Checking all needed binaries
------------------------------------------------------------------------
rm                                                         OK
cp                                                         OK
mv                                                         OK
/usr/bin/chmod                                             OK
/usr/bin/chown                                             OK
echo                                                       OK
more                                                       OK
mkdir                                                      OK
find                                                       OK
/usr/bin/grep                                              OK
/usr/bin/cat                                               OK
/usr/bin/sed                                               OK

Vous pouvez répondre n à la première question, l'installation créera automatiquement les ressources manquantes. J'ai répondu y pour visualiser toutes les étapes, il faudra modifier le dossier par défaut, sur Debian c'est /etc/default.

------------------------------------------------------------------------
	Checking the mandatory folders
------------------------------------------------------------------------

Do you want to be asked for confirmation before creating missing resources ?
[y/n], default to [y]:
> y

Where is your Gorgone log folder
default to [/var/log/centreon-gorgone]
>

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

Where is your Gorgone database folder
default to [/var/lib/centreon-gorgone]
>

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

Where is your Gorgone config (etc) folder
default to [/etc/centreon-gorgone]
>

Do you want to create this directory ? [/etc/centreon-gorgone]
[y/n], default to [n]:
> y
Path /etc/centreon-gorgone                                 OK
Creating folder /etc/centreon-gorgone/config.d             OK
Path /etc/centreon-gorgone/config.d                        OK

Where are your Gorgone user's folder
default to [/usr/bin/]
>
Path /usr/bin/                                             OK

Where are your Gorgone's perl files
default to [/usr/share/perl5]
>
Path /usr/share/perl5                                      OK

Where is your sysconfig folder ?
default to [/etc/sysconfig]
> /etc/default
Path /etc/default                                          OK

L'installation va créer le compte centreon-gorgone.

------------------------------------------------------------------------
	Checking the required users
------------------------------------------------------------------------

What is the Gorgone group ?
default to [centreon-gorgone]
>

Do you want to create this group ? [centreon-gorgone]
[y/n], default to [n]:
> y
Creating group centreon-gorgone                            OK

What is the Gorgone user ?
default to [centreon-gorgone]
>

Do you want to create this user ? [centreon-gorgone]
[y/n], default to [n]:
> y
Creating user centreon-gorgone (Gorgone user)              OK

------------------------------------------------------------------------
	Adding Gorgone user to the mandatory folders
------------------------------------------------------------------------
Modify owner of /var/log/centreon-gorgone                  OK
Modify rights of /var/log/centreon-gorgone                 OK
Modify owner of /var/lib/centreon-gorgone                  OK
Modify rights of /var/lib/centreon-gorgone                 OK
------------------------------------------------------------------------
	Installing Gorgone daemon
------------------------------------------------------------------------
Creating and adding rights on gorgoned.service             OK
Creating and adding rights on gorgoned                     OK
Creating and adding rights on gorgoned                     OK
Creating and adding rights on config.yaml                  OK
Creating and adding rights on gorgoned                     OK
Creating and adding rights on gorgone_config_init.pl       OK
------------------------------------------------------------------------
	Starting gorgoned.service
------------------------------------------------------------------------
Created symlink /etc/systemd/system/multi-user.target.wants/gorgoned.service → /etc/systemd/system/gorgoned.service.
Created symlink /etc/systemd/system/centreon.service.wants/gorgoned.service → /etc/systemd/system/gorgoned.service.

###############################################################################
#                                                                             #
#                         Thanks for using Gorgone.                           #
#                          -----------------------                            #
#                                                                             #
#           Please add the configuration in a file in the folder :            #
#                           /etc/centreon-gorgone/config.d                             #
#                     Then start the gorgoned.service                         #
#                                                                             #
#                You can read the documentation available here :              #
#      https://github.com/centreon/centreon-gorgone/blob/master/README.md     #
#                                                                             #
#      ------------------------------------------------------------------     #
#                                                                             #
#     Report bugs at https://github.com/centreon/centreon-gorgone/issues      #
#                                                                             #
#                        Contact : contact@centreon.com                       #
#                          http://www.centreon.com                            #
#                                                                             #
#                          -----------------------                            #
#              For security issues, please read our security policy           #
#           https://github.com/centreon/centreon-gorgone/security/policy      #
#                                                                             #
###############################################################################

Continuons avec l'installation de Centreon-Web

8.4 Installation en ligne de commande

Téléchargez le binaire du 10/05/2021 dans le dossier /usr/local/src et décompressez-le.

cd /usr/local/src
wget http://files.download.centreon.com/public/centreon/centreon-web-20.04.13.tar.gz
tar xzf centreon-web-20.04.13.tar.gz
cd centreon-web-20.04.13

8.4a Installation des dépendances Php

Avant de continuer l'installation, installer PHP composer.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/bin --filename=composer

résultat de la commande

Lancer la commande dans le dossier d'installation de centreon-web-20.04.x pour installer les dépendances php

composer install --no-dev --optimize-autoloader -n

La commande devrait se terminer par ces messages.

résultat de la commande

8.4b Installation des dépendances Javascript

Installez les paquets nécessaires à l'environnement d'exécution javascript nodejs.

apt install curl -y
curl -sL https://deb.nodesource.com/setup_14.x | bash -
apt install -y nodejs

Toujours dans le dossier d'installation de centreon-web-20.04.x, exécutez les commandes suivantes.

npm ci

résultat de la commande

Continuez par cette commande.

npm run build

résultat de la commande npm run build

Lancez la ligne de commande ci-dessous pour débuter l'installation.

./install.sh -i

Au lancement du script, le programme confirme si toutes les dépendances sont satisfaites. Répondre y pour l'installation de gorgone.

###############################################################################
#                                                                             #
#                           Centreon (www.centreon.com)                       #
#                                                                             #
#                               infos@centreon.com                            #
#                                                                             #
#                   Make sure you have installed and configured               #
#         centreon-gorgone - sudo - sed - php - apache - rrdtool - mysql      #
#                                                                             #
###############################################################################
------------------------------------------------------------------------
	Checking all needed binaries
------------------------------------------------------------------------
rm                                                         OK
cp                                                         OK
mv                                                         OK
/usr/bin/chmod                                             OK
/usr/bin/chown                                             OK
echo                                                       OK
more                                                       OK
mkdir                                                      OK
find                                                       OK
/usr/bin/grep                                              OK
/usr/bin/cat                                               OK
/usr/bin/sed                                               OK

------------------------------------------------------------------------
	Check mandatory gorgone service status
------------------------------------------------------------------------

Is the Gorgone module already installed?
[y/n], default to [n]:
> y

You will now read Centreon Licence.
	Press enter to continue.

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.

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

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

------------------------------------------------------------------------
        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 Nagios Plugins
[y/n], default to [n]:
> y

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

Le script d'installation va maintenant procéder à l'installation des différents modules. Commençons par l'installation de gorgone, laissez les options par défaut.

------------------------------------------------------------------------
	Gorgone module Installation
------------------------------------------------------------------------

Where is your gorgone module folder ? [/var/lib/centreon-gorgone]
default to [/var/lib/centreon-gorgone]
>
Path /var/lib/centreon-gorgone                             OK

Where is your gorgone configuration folder ? [/etc/centreon-gorgone]
default to [/etc/centreon-gorgone]
>

What is the Gorgone user ? [centreon-gorgone]
default to [centreon-gorgone]
>

What is the Gorgone group ? [centreon-gorgone]
default to [centreon-gorgone]
>

Passons à Centreon Web, l'interface de centreon. Ici, on nous demande où installer Centreon UI. Laissez par défaut.

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

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

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

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

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

Très important : L'emplacement des fichiers de configuration de centreon. Attention si cet endroit venait à changer par la suite, vous seriez obligé de relancer l'installation de centreon, certains fichiers devant être regénérés. Saisir les valeurs par défaut et répondre y pour la création des dossiers. Il faudra saisir le chemin du fichier de configuration fpm pour le serveur Apache.

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 cache directory?
default to [/var/cache/centreon]
>

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

Where is your Centreon variable library directory?
default to [/var/lib/centreon]
>
Path /var/lib/centreon                                     OK
/usr/bin/rrdtool                            OK
/usr/bin/mail                                              OK

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

Where is PEAR [PEAR.php] 
default to [/usr/share/php/PEAR.php]
>
Path /usr/share/php                                        OK
/usr/bin/perl                                              OK
check PHP version                                          OK
Composer dependencies are installed                        OK
Frontend application is built                              OK
Enable Apache configuration                                OK
ERROR: Conf centreon does not exist!
Finding Apache user :                                      www-data
Finding Apache group :                                     www-data
PHP FPM config directory not found                         CRITICAL

Where is your PHP FPM conf.d directory
> /etc/php/7.3/fpm/pool.d/

Utilisation d'un groupe centreon et d'un utilisateur centreon, validez entrée par défaut

What is the Centreon group ? [centreon]
default to [centreon]
> 

What is the Centreon user ? [centreon]
default to [centreon]
>

Laissez les valeurs par défaut.

What is the Monitoring engine user ? [centreon-engine]
default to [centreon-engine]
>

What is the Broker user ? [centreon-broker]
default to [centreon-broker]
>

What is the Monitoring engine log directory ? [/var/log/centreon-engine]
default to [/var/log/centreon-engine]
>

Path                                                       OK
Path                                                       OK
Add group centreon to user www-data                        OK
Add group centreon to user centreon-engine                 OK
Add group centreon-engine to user www-data                 OK
Add group centreon-engine to user centreon                 OK
Add group www-data to user centreon                        OK

Configuration des commandes utilisées par Sudo. Validez les chemins par défaut et surtout répondre y pour la création du fichier /etc/sudoers.d/centreon et pour la configuration de sudo.

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

Where is sudo configuration file
default to [/etc/sudoers.d/centreon]
>

Do you want me to create this file ? [/etc/sudoers.d/centreon]
[y/n], default to [n]:
> y
/etc/sudoers.d/centreon

What is the Monitoring engine binary ? [/usr/sbin/centengine]
default to [/usr/sbin/centengine]
>

What is the Monitoring engine configuration directory ? [/etc/centreon-engine]
default to [/etc/centreon-engine]
>

Where is the configuration directory for broker module ? [/etc/centreon-broker]
default to [/etc/centreon-broker]
>

Where is your service command binary ?
default to [/usr/sbin/service]
>
Your sudo is not configured

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

Configuration du serveur Web. Laissez par défaut en répondant y, un warning pour le démarrage du PHP FPM sans importance

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

Do you want to add Centreon Apache sub configuration file ?
[y/n], default to [n]:
> y
Create '/etc/apache2/conf-available/centreon.conf'         OK
Configuring Apache                                         OK

Do you want to reload your Apache ?
[y/n], default to [n]:
> y
Reloading Apache service                                   OK

------------------------------------------------------------------------
	Configure PHP FPM service
------------------------------------------------------------------------

Do you want to add Centreon PHP FPM sub configuration file ?
[y/n], default to [n]:
> y
Creating directory /var/lib/centreon/sessions              OK
Create '/etc/php/7.3/fpm/pool.d/centreon.conf'             OK
Configuring PHP FPM                                        OK

Do you want to reload PHP FPM service ?
[y/n], default to [n]:
> y
Unable to reload PHP FPM service                           WARNING
Preparing Centreon temporary files
Modify rights on /var/log/centreon                         OK
Modify rights on /var/lib/centreon/installs                OK
Modify rights on /etc/centreon                             OK
Modify rights on /var/cache/centreon                       OK
Change macros for insertBaseConf.sql                       OK
Change macros for sql update files                         OK
Change macros for php files                                OK
Change macros for php env and config file                  OK
Change macros for perl binary                              OK
Modify rights on /etc/centreon-engine                      OK
Add group centreon-broker to user www-data                 OK
Add group centreon-broker to user centreon-engine          OK
Add group centreon to user centreon-broker                 OK
Add group centreon-gorgone to user centreon                OK
Add group centreon-gorgone to user www-data                OK
Add group centreon to user centreon-gorgone                OK
Add group centreon-broker to user centreon-gorgone         OK
Add group centreon-engine to user centreon-gorgone         OK
Add group www-data to user centreon-gorgone                OK
Modify rights on /etc/centreon-broker                      OK
Copy CentWeb in system directory
Install CentWeb (web front of centreon)                    OK
Modify rights for install directory                        OK
Install libraries                                          OK
Write rights to Smarty Cache                               OK
Change macros for centreon.cron                            OK
Install Centreon cron.d file                               OK
Change macros for centAcl.php                              OK
Change macros for downtimeManager.php                      OK
Change macros for centreon-backup.pl                       OK
Install cron directory                                     OK
Modify rights for eventReportBuilder                       OK
Modify rights for dashboardBuilder                         OK
Modify rights for centreon-backup.pl                       OK
Modify rights for centreon-backup-mysql.sh                 OK
Change macros for centreon.logrotate                       OK
Install Centreon logrotate.d file                          OK
Prepare centFillTrapDB                                     OK
Install centFillTrapDB                                     OK
Prepare centreon_trap_send                                 OK
Install centreon_trap_send                                 OK
Prepare centreon_check_perfdata                            FAIL
Install centreon_check_perfdata                            FAIL
Prepare centreonSyncPlugins                                OK
Install centreonSyncPlugins                                OK
Prepare centreonSyncArchives                               OK
Install centreonSyncArchives                               OK
Install generateSqlLite                                    OK
Install changeRrdDsName.pl                                 OK
Install export-mysql-indexes                               OK
Install import-mysql-indexes                               OK
Install clapi binary                                       OK
Centreon Web Perl lib installed                            OK

------------------------------------------------------------------------
	Pear Modules
------------------------------------------------------------------------
Check PEAR modules
PEAR                            1.4.9       1.10.6         OK
DB                              1.7.6                      NOK
Date                            1.4.6       1.4.7          OK

Do you want to install/upgrade your PEAR modules
[y/n], default to [y]:
> y
Upgrading PEAR modules
Installing PEAR modules
DB                              1.7.6       1.10.0         OK
Check PEAR modules
PEAR                            1.4.9       1.10.12        OK
DB                              1.7.6       1.10.0         OK
Date                            1.4.6       1.4.7          OK
All PEAR modules                                           OK
------------------------------------------------------------------------
	Achieve gorgone's module integration
------------------------------------------------------------------------
Create centreon config folders                             OK
Gorgone configuration structure                            OK
------------------------------------------------------------------------
	Create configuration and installation files
------------------------------------------------------------------------

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

Nous continuons avec l'installation de CentStorage. Laissez par défaut et y pour le lancement du service.

------------------------------------------------------------------------
	Starting 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/share/centreon/bin]
>
Path /usr/share/centreon/bin                               OK

Where is your CentStorage RRD directory
default to [/var/lib/centreon]
>
Path /var/lib/centreon                                     OK
Preparing Centreon temporary files
/tmp/centreon-setup exists, it will be moved...
install www/install/createTablesCentstorage.sql            OK
Creating Centreon Directory '/var/lib/centreon/status'     OK
Creating Centreon Directory '/var/lib/centreon/metrics'    OK
Change right : /var/run/centreon                           OK
Install logAnalyserBroker                                  OK
Install nagiosPerfTrace                                    OK
Change macros for centstorage.cron                         OK
Install CentStorage cron                                   OK
Create /etc/centreon/instCentStorage.conf                  OK

Nous continuons avec l'installation des plugins. Laissez par défaut et y pour la création du service.

------------------------------------------------------------------------
	Starting Centreon Plugins Installation
------------------------------------------------------------------------
Path                                                       OK
Path                                                       OK

Where is your CentPlugins lib directory
default to [/var/lib/centreon/centplugins]
>

Do you want me to create this directory ? [/var/lib/centreon/centplugins]
[y/n], default to [n]:
> y
Path /var/lib/centreon/centplugins                         OK
Create /etc/centreon/instCentPlugins.conf                  OK

Installation des plugins pour les Traps SNMP, répondre y pour la création des dossiers.

------------------------------------------------------------------------
	Starting CentreonTrapD Installation
------------------------------------------------------------------------
Path                                                       OK
Path                                                       OK

Where is your SNMP configuration directory
default to [/etc/snmp]
>
/etc/snmp                                                  OK

Where is your CentreonTrapd binaries directory
default to [/usr/share/centreon/bin]
>
/usr/share/centreon/bin                                    OK
Finding Apache user :                                      www-data
Preparing Centreon temporary files
/tmp/centreon-setup exists, it will be moved...
Change macros for snmptrapd.conf                           OK
Replace CentreonTrapd init script Macro                    OK
Replace CentreonTrapd default script Macro                 OK

Do you want me to install CentreonTrapd init script ?
[y/n], default to [n]:
> y
CentreonTrapd init script installed                        OK
CentreonTrapd default script installed                     OK

Do you want me to install CentreonTrapd run level ?
[y/n], default to [n]:
> y
update-rc.d: warning: start and stop actions are no longer supported; falling back to defaults
trapd Perl lib installed                                   OK
Install : snmptrapd.conf                                   OK
Install : centreontrapdforward                             OK
Install : centreontrapd                                    OK
Change macros for centreontrapd.logrotate                  OK
Install Centreon Trapd logrotate.d file                    OK
Create /etc/centreon/instCentPlugins.conf                  OK
###############################################################################
#                                                                             #
#                 Go to the URL : http://debian-test9/centreon/                    #
#                   	     to finish the setup                              #
#                                                                             #
#           Report bugs at https://github.com/centreon/centreon/issues        #
#                                                                             #
#                         Thanks for using Centreon.                          #
#                          -----------------------                            #
#                        Contact : infos@centreon.com                         #
#                          http://www.centreon.com                            #
#                                                                             #
###############################################################################

Pour éviter les problèmes de droit pour les fichiers temporaires des plugins Centreon, modifiez les droits pour le dossier /var/lib/centreon/centplugins

chmod 775 /var/lib/centreon/centplugins
chown centreon: /var/lib/centreon/centplugins

Créez un dossier centcore dans /var/lib/centreon

mkdir /var/lib/centreon/centcore
chown centreon: /var/lib/centreon/centcore
chmod -R 775 /var/lib/centreon/centcore

Il faudra créer le dossier /var/log/centreon-broker et donner la permission au processus centengine d'écrire le fichier de statistique. Pour être sûr que les processus broker puissent démarrer, confirmer les droits de /var/lib/centreon-broker.

mkdir /var/log/centreon-broker
chown centreon-broker:centreon-broker  /var/log/centreon-broker
chmod 775 /var/log/centreon-broker
chmod 775 /var/lib/centreon-broker
chown centreon-broker:centreon-broker /var/lib/centreon-broker

8.5 Installation des widgets

Nous allons mettre en place les widgets avant l'installation en mode Web. Téléchargez les binaires des widgets compatibles avec cette version.

cd /usr/local/src
wget http://files.download.centreon.com/public/centreon-widgets/centreon-widget-engine-status/centreon-widget-engine-status-20.04.1.tar.gz
wget http://files.download.centreon.com/public/centreon-widgets/centreon-widget-graph-monitoring/centreon-widget-graph-monitoring-20.04.1.tar.gz
wget http://files.download.centreon.com/public/centreon-widgets/centreon-widget-grid-map/centreon-widget-grid-map-20.04.0.tar.gz
wget http://files.download.centreon.com/public/centreon-widgets/centreon-widget-host-monitoring/centreon-widget-host-monitoring-20.04.5.tar.gz
wget http://files.download.centreon.com/public/centreon-widgets/centreon-widget-hostgroup-monitoring/centreon-widget-hostgroup-monitoring-20.04.0.tar.gz
wget http://files.download.centreon.com/public/centreon-widgets/centreon-widget-httploader/centreon-widget-httploader-20.04.0.tar.gz
wget http://files.download.centreon.com/public/centreon-widgets/centreon-widget-live-top10-cpu-usage/centreon-widget-live-top10-cpu-usage-20.04.0.tar.gz
wget http://files.download.centreon.com/public/centreon-widgets/centreon-widget-live-top10-memory-usage/centreon-widget-live-top10-memory-usage-20.04.0.tar.gz
wget http://files.download.centreon.com/public/centreon-widgets/centreon-widget-service-monitoring/centreon-widget-service-monitoring-20.04.4.tar.gz
wget http://files.download.centreon.com/public/centreon-widgets/centreon-widget-servicegroup-monitoring/centreon-widget-servicegroup-monitoring-20.04.0.tar.gz
wget http://files.download.centreon.com/public/centreon-widgets/centreon-widget-tactical-overview/centreon-widget-tactical-overview-20.04.0.tar.gz

Décompressez les archives

tar xzf centreon-widget-engine-status-20.04.1.tar.gz
tar xzf centreon-widget-graph-monitoring-20.04.1.tar.gz
tar xzf centreon-widget-grid-map-20.04.0.tar.gz
tar xzf centreon-widget-host-monitoring-20.04.5.tar.gz
tar xzf centreon-widget-hostgroup-monitoring-20.04.0.tar.gz
tar xzf centreon-widget-httploader-20.04.0.tar.gz
tar xzf centreon-widget-live-top10-cpu-usage-20.04.0.tar.gz
tar xzf centreon-widget-live-top10-memory-usage-20.04.0.tar.gz
tar xzf centreon-widget-service-monitoring-20.04.4.tar.gz
tar xzf centreon-widget-servicegroup-monitoring-20.04.0.tar.gz
tar xzf centreon-widget-tactical-overview-20.04.0.tar.gz

Déplaçons les widgets dans le dossier réservé à ceux-ci.

mv centreon-widget-engine-status-20.04.1/engine-status /usr/share/centreon/www/widgets/
mv centreon-widget-graph-monitoring-20.04.1/graph-monitoring /usr/share/centreon/www/widgets/
mv centreon-widget-grid-map-20.04.0/grid-map/ /usr/share/centreon/www/widgets/
mv centreon-widget-host-monitoring-20.04.5/host-monitoring/ /usr/share/centreon/www/widgets/
mv centreon-widget-hostgroup-monitoring-20.04.0/hostgroup-monitoring/ /usr/share/centreon/www/widgets/
mv centreon-widget-httploader-20.04.0/httploader/ /usr/share/centreon/www/widgets/
mv centreon-widget-live-top10-cpu-usage-20.04.0/live-top10-cpu-usage/ /usr/share/centreon/www/widgets/
mv centreon-widget-live-top10-memory-usage-20.04.0/live-top10-memory-usage/ /usr/share/centreon/www/widgets/
mv centreon-widget-service-monitoring-20.04.4/service-monitoring/ /usr/share/centreon/www/widgets/
mv centreon-widget-servicegroup-monitoring-20.04.0/servicegroup-monitoring/ /usr/share/centreon/www/widgets/
mv centreon-widget-tactical-overview-20.04.0/tactical-overview/ /usr/share/centreon/www/widgets/

Il faut terminer l’installation en mode Web.

8.6 Installation en mode Web

Il faut autoriser la configuration Centreon pour le serveur Web Apache et activer mod headers, Merci à Bruno D pour le conseils.

a2enconf centreon.conf
a2enmod headers

Relancez la configuration.

systemctl restart apache2 php7.3-fpm

Utilisez un navigateur internet récent et saisissez l’url suivante :
http://<ip du serveur centreon>/centreon/

Démarrage de l'installation Web, cliquez sur "Next"

L’écran suivant vous indique que la package php7-intl n’est pas installé et que vous n’avez pas configuré le fuseau horaire dans le php.ini du serveur fpm.

Validation des dépendances, cliquez sur "next".

Saisissez les chemins ci-dessous.

Centreon Engine directory:			/usr/sbin/
Centreon Engine Stats binary:			/usr/sbin/centenginestats
Centreon Engine var lib directory:		/var/lib/centreon-engine
Centreon Engine Connector path:			/usr/lib/centreon-connector
Centreon Engine Library (*.so) directory:	/usr/lib/centreon-engine/
Centreon Plugins Path:				/usr/lib/centreon/plugins

Saisissez les chemins ci-dessous.

Centreon Broker etc directory:		/etc/centreon-broker
Centreon Broker module (cbmod.so):	/usr/lib/centreon-broker/cbmod.so
Centreon Broker log directory:		/var/log/centreon-broker
Retention file directory:		/var/lib/centreon-broker
Centreon Broker lib (*.so) directory:	/usr/share/centreon/lib/centreon-broker

Cliquez sur Next

Création du user "Administrateur", admin et son mot de passe. Saisir une adresse valide pour l’email. Cliquez sur Next.

Définir les Accès MySQL, le mot de passe de MySQL. Laisser les noms de base par défaut CENTREON, CENTSTORAGE. Saisir le mot de passe pour ces bases de données. Cliquez sur Next.

Cliquez sur Next

Les widgets sont pré-installés, Cliquez sur Install

Cliquez sur Next

Fin de l'installation, cliquez sur Finish

Vous devriez avoir cette vue avec la nouvelle interface temps réel.

8.7 Préparation de la configuration gorgone

Créez le fichier /etc/centreon/config.yaml

tee /etc/centreon/config.yaml <<EOF
name: config.yaml
description: Configuration for Central server
configuration: !include config.d/*.yaml
EOF
chmod 664 /etc/centreon/config.yaml
chown centreon: /etc/centreon/config.yaml

Modifiez les droits du dossier config.d

chmod 775 /etc/centreon/config.d
chown centreon: /etc/centreon/config.d

Ajoutez le fichier de configuration /etc/centreon/config.d/10-database.yaml. Attention, le nom d'utilisateur et le mot de passe doit être le même que celui de l'installation.

tee /etc/centreon/config.d/10-database.yaml <<EOF
database:
  db_configuration:
    dsn: "mysql:host=localhost:3306;dbname=centreon"
    username: "centreon"
    password: "centreon"
  db_realtime:
    dsn: "mysql:host=localhost:3306;dbname=centreon_storage"
    username: "centreon"
    password: "centreon"
EOF
chown www-data: /etc/centreon/config.d/10-database.yaml

Ajoutez le fichier de configuration /etc/centreon-gorgone/config.d/30-centreon.yaml

tee /etc/centreon-gorgone/config.d/30-centreon.yaml <<EOF
name: centreon.yaml
description: Configure Centreon Gorgone to work with Centreon Web.
centreon: !include /etc/centreon/config.d/*.yaml
EOF

Version centreon-gorgone 20.04.0, problème de création de node proxy
Modifiez le fichier /usr/share/perl5/gorgone/modules/centreon/nodes/class.pm comme indiqué sur le Github centreon-gorgone
fix-nodes

Utilisez cette commande

sed -i -e "s/unshift \$register_subnodes->{\$_->\[0\]}/unshift \@{\$register_subnodes->{\$_->\[0\]}}/g" /usr/share/perl5/gorgone/modules/centreon/nodes/class.pm

Redémarrer le service

systemctl restart gorgoned

Vérifiez le fonctionnement de gorgone, vous devez avoir des nodes proxy comme la copie d'écran ci-dessous.

systemctl status gorgoned

Si vous n'avez pas de process gorgone-proxy, vous pouvez modifier fichier de configuration en ajoutant le paramètre id comme ci-dessous

vi /etc/centreon-gorgone/config.d/40-gorgoned.yaml

Rajoutez la ligne id: 1

gorgone:
  gorgonecore:
    privkey: "/var/lib/centreon-gorgone/.keys/rsakey.priv.pem"
    pubkey: "/var/lib/centreon-gorgone/.keys/rsakey.pub.pem"
    id: 1

Redémarrez et vérifiez de nouveau.

8.8 Préparation de la configuration centreon

Cette nouvelle version ne contient plus les plugins historiques de Centreon ainsi que la base d'exemples de configuration. Cette version est développée pour les nouveaux plugins-pack de Centreon. Vous avez le minimum vital : quelques contacts, périodes temporelles, macro ressources, les traps SNMP et la configuration du poller pour le Central. Actuellement, le module IMP n'est pas encore compatible avec la distribution Debian. Nous allons quand-même installer un exemple de configuration basé sur mes scripts CLAPI pour centreon-deb. Nous allons utiliser la dernière version de mon script de configuration sur mon github.

cd /usr/local/src
apt-get install git -y
git clone https://github.com/kermith72/auto_install.git

Il faudra aussi renseigner la valeur de la macro $USER1$, cliquez sur Configuration -> Pollers -> Resources. Modifiez la valeur avec le chemin des plugins historique /usr/lib/nagios/plugins

8.9 Lancement des services et application de la configuration

Démarrez les services ci-dessous :

systemctl start cbd && systemctl start centreontrapd

cbd : le watchdog du broker: Au lancement du service cbd, vous démarrez le watchdog cbwd qui permettra ensuite de lancer les processus broker. Lors d'une première installation, vous avez seulement un fichier de configuration watchdog.xml dans le dossier /etc/centreon-broker.
ls -l /etc/centreon-broker
total 4
-rwxrwxr-x 1 centreon-broker centreon-broker 999 janv. 30 17:17 watchdog.xml

Comme il n'y a pas encore de fichier de configuration pour les processus broker, vous n'aurez que le programme watchdog cbwd en mémoire comme ci-dessous :
systemctl status cbd
● cbd.service - LSB: Start daemon cbd at boot
Loaded: loaded (/etc/init.d/cbd)
Active: active (running) since mer. 2018-01-31 11:39:08 CET; 6min ago
Process: 77683 ExecStart=/etc/init.d/cbd start (code=exited, status=0/SUCCESS)
CGroup: /system.slice/cbd.service
└─77688 /usr/sbin/cbwd /etc/centreon-broker/watchdog.xml

janv. 31 11:39:08 central-install-8 cbd[77683]: Starting Centreon Broker watchdog: cbd.
janv. 31 11:39:08 central-install-8 systemd[1]: Started LSB: Start daemon cbd at boot.

Et vous avez la possibilité de vérifier le bon fonctionnement du watchdog avec son fichier de log associé :
cat /var/log/centreon-broker/watchdog.log
…….
[1517395681] info: watchdog: starting process 'central-broker'
[1517395681] info: watchdog: process 'central-broker' started (PID 78871)
[1517395681] info: watchdog: starting process 'central-rrd'
[1517395681] info: watchdog: process 'central-rrd' started (PID 78872)
[1517395681] error: watchdog: process 'central-rrd' terminated unexpectedly, restarting it immediately
[1517395681] error: watchdog: process 'central-broker' terminated unexpectedly, restarting it immediately
……..

Vous remarquerez de nombreux messages d'erreur car le watchdog n'arrive pas à lancer les processus broker prédéfinis. Tant que vous n'aurez pas exporter votre première configuration, vous aurez droit à ces messages d'erreur. Un conseil, ne tardez pas à lancer votre première configuration ;) Pour avoir plus d'informations sur le watchdog, lisez cet article.
centreontrapd : la gestion des traps SNMP: Centreontrapd est un service dédié au trap SNMP. Pour vérifiez son status, lancez la commande suivante :
systemctl status centreontrapd
● centreontrapd.service - LSB: Start daemon centreontrapd at boot
Loaded: loaded (/etc/init.d/centreontrapd)
Active: active (running) since mer. 2018-01-31 13:27:33 CET; 1s ago
Process: 83289 ExecStart=/etc/init.d/centreontrapd start (code=exited, status=0/SUCCESS)
CGroup: /system.slice/centreontrapd.service
└─83294 /usr/bin/perl /usr/share/centreon/bin/centreontrapd --logfile=/var/log/centreon/centreontrapd.log --severity=error...

Il est possible de vérifier les erreurs avec son fichier de log associé.
cat /var/log/centreon/centreontrapd.log
2018-01-31 13:27:34 - 83294 - Mode: central server

La ligne ci-dessus indique le fonctionnement pour un Central. Lisez cet article pour la configuration des traps SNMP dans Centreon. Comme pour le service centcore, il est possible d'activer le mode debug comme indiqué ci-dessous.

8.9a création d'un cgroup centreon

Les scripts systemd pour le démarrage du moteur et du broker ont subi une modification avec la version 19.04. Les processus démarrent avec un cgroup (groupe de processus) centreon. Malheureusement, celui-ci n'est pas créé automatiquement, ce qui provoque cette erreur ci-dessous après un redémarrage de Centreon.

Nous allons créer ce cgroup manuellement. créez le fichier /lib/systemd/system/centreon.service.

tee /lib/systemd/system/centreon.service <<EOF
[Unit]
Description=Cgroup Centreon

[Service]
Type=oneshot
ExecStart=/bin/true
ExecReload=/bin/true
RemainAfterExit=yes

[Install]
WantedBy=multi-user.target
EOF

Activez le cgroup.

systemctl daemon-reload && systemctl enable centreon

Au redémarrage du serveur, le cgroup centreon va démarrer les services cbd et centengine.

8.9b installation des icônes

Pour améliorer la présentations des hôtes et services, nous allons installer les icônes de Pixelabs. Si vous avez installé le git d'auto_install, décompressez l'archive.

tar xzf /usr/local/src/auto_install/debian10/icones_pixelabs_v2.tar.gz -C /tmp
tar xzf /usr/local/src/auto_install/debian10/icones_extra.tar.gz -C /tmp
cp -r /tmp/icones_pixelabs_v2/* /usr/share/centreon/www/img/media/
cp -r /tmp/icones_extra/* /usr/share/centreon/www/img/media/
chown -R www-data: /usr/share/centreon/www/img/media/

Afin de permettre l'utilisation des icônes de Pixelabs, nous allons les installer dans la section Média. Sélectionnez le menu Administration > Parameters > Images. Cliquez sur le bouton Synchronize Media Directory

Synchronisation des médias

Fermez la fenêtre "Media Detection" et rafraîchissez la fenêtre précédente. Vous afficherez les icônes réalisées par Pixelabs.

Les icônes du site Pixelabs

8.9c Installation standalone : script création de la configuration initiale

Nous allons utiliser le script téléchargé précédemment create_config_initialV9.sh. Ce dernier script a la particularité de créer l'hôte Central pour une architecture standalone en ajoutant yes à l'argument t. Il est possible de ne pas créer l'hôte Central pour permettre la supervision croisée dans le cas d'une architecture distribuée (installation par défaut). Après avoir modifié les permissions du fichier pour le rendre exécutable. Les paramètres sont les suivants :

-u : admin Centreon
-p : mot de passe de l'admin Centreon
-d : user mariaDB pour Centreon
-w : mot de passe user mariaDB
-s : création des services disk
-m : méthode restart
-i : ajout des icône
-t : évite la création de l'hôte

L'installation en mode distribuée sera expliqué au chapitre suivant. Lancez ce script (en root pour avoir les droits de recharger le moteur) comme ceci pour une installation standalone :

/usr/local/src/auto_install/debian10/create_config_initialV9.sh -u=admin -p=password -d=centreon -w=centreon -s=yes -m=restart -i=yes -t=yes

Voici le résultat de la commande :

Create Command base
Create Command local
Create Command snmp
Create Command Windows snmp
Create Command Windows nrpe
Create Command Cisco snmp
Create Command mysql
Create Command gorgone
Create template service base
Create template service local
Create template service snmp
Create template service Windows snmp
Create template service Windows nrpe
Create template service Cisco snmp
Create template service local database
Create template app centreon poller
Create template app centreon central
Create template app centreon gorgone
Create templates host
- base
- linux local
- linux snmp
- poller
- central
- mysql
- windows snmp
- windows nrpe
- cisco
- gorgone
Create Central
add storage
Configuration OK !

Au bout de quelques secondes, vous devriez voir apparaître les services dans la vue Temps réels

Création des services en mode pending

Erreur des plugins avec le message Execute command failed
Vous pouvez rencontrer ce type d'erreur lors de l'application de la configuration, car le chemin de la commande du plugin n'est pas correct.

Pasted Graphic

Il faudra renseigner la valeur de la macro $USER1$, cliquez sur Configuration -> Pollers -> Resources. Modifiez la valeur avec le chemin des plugins historique /usr/lib/nagios/plugins

macro_user1

Ensuite, vous devriez voir apparaître les hôtes et services dans la barre d'état en haut à droite.

Hôte et services de la barre d'état

Votre supervision est en état de fonctionnement

A partir de la version 7 du script, il est possible de superviser facilement un serveur Windows ou un switch cisco. Les modèles d'hôtes sont disponibles.

8.9d Installation distribuée : script création de la configuration initiale

Nous allons installer la configuration des commandes et des modèles sans créer la supervision du Central. La configuration sera appliquée pour faire fonctionner le moteur et le broker. Lancez ce script (en root pour avoir les droits de recharger le moteur) comme ceci :

/usr/local/src/auto_install/debian10/create_config_initialV9.sh -u=admin -p=password -d=centreon -w=centreon -s=yes -m=restart -i=yes

Voici le résultat de la commande :

Create Command base
Create Command local
Create Command snmp
Create Command Windows snmp
Create Command Windows nrpe
Create Command Cisco snmp
Create Command mysql
Create Command gorgone
Create template service base
Create template service local
Create template service snmp
Create template service Windows snmp
Create template service Windows nrpe
Create template service Cisco snmp
Create template service local database
Create template app centreon poller
Create template app centreon central
Create template app centreon gorgone
Create templates host
- base
- linux local
- linux snmp
- poller
- central
- mysql
- windows snmp
- windows nrpe
- cisco
- gorgone
Configuration OK !

Au bout de quelques secondes, vous devriez voir le fonctionnement du moteur avec la commande Configuration -> Pollers

Pour configurer la supervision du Central voir la page suivante la supervision croisée.

Retour en haut

Vous êtes ici:

Installation Full Centreon 20.04 sur Debian Buster version 10

Menu

1 Préparation de la VM

1.1 Mise à jour et ssh

2 Installation de Centreon Clib

2.1 Pré requis

2.2 Installation

2.2a Installation via le github Centreon

2.2b Installation via les paquets sources

3 Installation des connecteurs Centreon

3.1 Pré requis

3.2 Installation

3.2a Installation via le github Centreon

3.2b Installation via les paquets sources

4 Installation de Centreon Engine

4.1 Pré Requis

4.2 Installation

4.2a Installation via le github Centreon

4.2b Installation via les paquets sources

5 Installation des Plugins pour Centreon-Engine

5.1 Plugins historiques

5.1.a Installation par les paquets Debian

5.1.b Installation par les sources, prérequis

5.1.c Installation par les sources, récupération des plugins sur le site de nagios-plugins.org

5.1.d Installation par les sources, ou sur le site de monitoring-plugins.org

5.1.e Installation par les sources, compilation et installation

5.2 Plugin Centreon

6 Installation de Centreon-Broker

6.1 Pré requis

6.2 Installation

6.2a Installation via le github Centreon

6.2b Installation via les paquets sources

7 Installation du protocole SNMP

7.1 Prérequis

7.2 Paramétrages

7.3 Installation des mibs

7.3a Modification du dépôt Debian

7.3b Ajout des mibs

7.3c Modification de la configuration SNMP

7.3d Vérification du fonctionnement

8 Installation de Centreon Web

8.1 Prérequis

8.2 préparation de MariaDB

8.3 Installation de Gorgone

8.3a Prérequis pour les librairies

8.3b Installation ZMQ-LibZMQ4

8.3c Installation lib-ssh

8.3d Autre prérequis

8.3e Installation en ligne de commande

8.4 Installation en ligne de commande

8.4a Installation des dépendances Php

8.4b Installation des dépendances Javascript

8.5 Installation des widgets

8.6 Installation en mode Web

8.7 Préparation de la configuration gorgone

8.8 Préparation de la configuration centreon

8.9 Lancement des services et application de la configuration

8.9a création d'un cgroup centreon

8.9b installation des icônes

8.9c Installation standalone : script création de la configuration initiale

8.9d Installation distribuée : script création de la configuration initiale