![Stacks Image 1118366](files/stacks-image-4192055-176x146.png)
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.
![Stacks Image 1118895](files/stacks-image-2782cd4-40x38.png)
- 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 :
![Stacks Image 1118369](files/stacks-image-9a78ccb.png)
![Stacks Image 1118372](files/stacks-image-fa0737e-48x46.png)
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
![Stacks Image 3086](files/stacks-image-756f486-294x186.png)
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
![Stacks Image 1118266](files/stacks-image-fa0737e-48x46.png)
Lors de l'installation des packages Debian, si vous avez ces messages d'erreurs non-bloquants :
![locales](files/locales.png)
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
![Stacks Image 1118910](files/stacks-image-2782cd4-40x38.png)
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
![Stacks Image 3399](files/stacks-image-f13c42d-294x186.png)
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
![Stacks Image 1118917](files/stacks-image-2782cd4-40x38.png)
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
![Stacks Image 4926](files/stacks-image-9d11632-294x186.png)
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.
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
![Stacks Image 1118932](files/stacks-image-2782cd4-40x38.png)
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
![Stacks Image 5223](files/stacks-image-f113bb8-294x186.png)
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.
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
![Stacks Image 5493](files/stacks-image-f029d6c-294x186.png)
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
![Stacks Image 1118945](files/stacks-image-2782cd4-40x38.png)
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
![Stacks Image 33996](files/stacks-image-0793eb4-294x186.png)
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.
![Stacks Image 1118734](files/stacks-image-fa0737e-48x46.png)
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
![Stacks Image 1118953](files/stacks-image-fa0737e-48x46.png)
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
![Stacks Image 1118832](files/stacks-image-da12aaf.jpg)
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.
![Stacks Image 1118835](files/stacks-image-e5a484c.jpg)
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
![Stacks Image 1118890](files/stacks-image-29996fc.jpg)
résultat de la commande
Continuez par cette commande.
npm run build
![Stacks Image 1118840](files/stacks-image-43f02ef.jpg)
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
-
Logs apache personnalisés
- Il peut être intéressant de gérer les logs de l'interface Centreon dans des fichiers à part. Nous utiliserons les directives ErrorLog et CustomLog. Editez le fichier de configuration d'apache pour Centreon
vi /etc/apache2/conf-available/centreon.conf
Rajoutez les deux lignes suivantes après la directive Directory.ErrorLog /var/log/apache2/error.centreon.log
CustomLog /var/log/apache2/access.centreon.log combined
Relancez la configurationsystemctl restart apache2 php7.3-fpm
Après un redémarrage d'apache, vous obtenez deux fichiers de logs spécifiques à l'IHM de Centreon.ls -l /var/log/apache2/*.centreon.log
-rw-r--r-- 1 root root 0 janv. 30 17:39 /var/log/apache2/access.centreon.log
-rw-r--r-- 1 root root 243 janv. 30 17:39 /var/log/apache2/error.centreon.log
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/
http://<ip du serveur centreon>/centreon/
![Stacks Image 35865](files/stacks-image-f1cb5d3.jpg)
Démarrage de l'installation Web, cliquez sur "Next"
![Stacks Image 35886](files/stacks-image-7cda131.jpg)
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.
![Stacks Image 48593](files/stacks-image-7f9d2ab.png)
Validation des dépendances, cliquez sur "next".
![Stacks Image 35907](files/stacks-image-29545de.jpg)
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
![Stacks Image 35928](files/stacks-image-ab4f895.jpg)
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
![Stacks Image 35952](files/stacks-image-7562498.jpg)
Création du user "Administrateur", admin et son mot de passe. Saisir une adresse valide pour l’email. Cliquez sur Next.
![Stacks Image 35981](files/stacks-image-c8c3e90.jpg)
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.
![Stacks Image 35998](files/stacks-image-f5e3d33.jpg)
Cliquez sur Next
![Stacks Image 1118134](files/stacks-image-a7f124f.jpg)
Les widgets sont pré-installés, Cliquez sur Install
![Stacks Image 1118767](files/stacks-image-ce7cb0b.jpg)
Cliquez sur Next
![Stacks Image 36037](files/stacks-image-62f36bd.jpg)
Fin de l'installation, cliquez sur Finish
![Stacks Image 1117923](files/stacks-image-f6dff5d.jpg)
Vous devriez avoir cette vue avec la nouvelle interface temps réel.
![Stacks Image 1118089](files/stacks-image-c12ca5a.jpg)
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
![Stacks Image 1118667](files/stacks-image-fa0737e-48x46.png)
Modifiez le fichier /usr/share/perl5/gorgone/modules/centreon/nodes/class.pm comme indiqué sur le Github centreon-gorgone
![fix-nodes](files/fix-nodes.jpg)
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
![Stacks Image 1118676](files/stacks-image-4cf1214.jpg)
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
![Stacks Image 1118275](files/stacks-image-c72bbb4.jpg)
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.
![Stacks Image 1118317](files/stacks-image-cb898de.jpg)
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
![Stacks Image 1118467](files/stacks-image-85788d2.jpg)
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.
![Stacks Image 1118472](files/stacks-image-61b1c51.jpg)
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
![Stacks Image 1118170](files/stacks-image-dd9a71c.jpg)
Création des services en mode pending
![Stacks Image 1118343](files/stacks-image-2782cd4-40x38.png)
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.
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
Ensuite, vous devriez voir apparaître les hôtes et services dans la barre d'état en haut à droite.
![Stacks Image 6174](files/stacks-image-90aceba.jpg)
Hôte et services de la barre d'état
Votre supervision est en état de fonctionnement
![Stacks Image 6195](files/stacks-image-d14f88a.jpg)
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.
![Stacks Image 1118480](files/stacks-image-ae9dda3.jpg)
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
![Stacks Image 1118870](files/stacks-image-4b3a085.jpg)
Pour configurer la supervision du Central voir la page suivante la supervision croisée.