Installation d'un central avec le mirroir centreon-deb
Cette procédure n'est valable que pour les utilisateurs du dépôt non officiel Centreon-deb. Pour installer un poller avec les sources Centreon ou l'ISO Centreon, lisez les articles suivants :
Installation distribuée avec les sources sur Debian
Je vous propose l’installation d’un central avec sa base de données autonome. Nous installerons aussi l’extension centreon-clapi pour utiliser les scripts de mon cru pour vous aider dans les premières configurations. Depuis le mois de décembre 2019, j'ai abandonné la version Jessie de Debian par contre vous pouvez installer la version Stretch de Debian en version 32bits et 64 bits et Raspbian Stretch pour Raspberry.
Vous pouvez installer les anciennes version de Centreon pour Jessie avec les archives. Vous trouverez les liens en bas de cette page.
Les scripts clapi insérés dans le package centreon-clapi ( à ne pas confondre avec les API Centreon qui sont fourni par défaut dans Centreon-Web) permettent :
- la configuration automatique de la timezone dans php.in,
- la première configuration de Centreon (base exemple),
- la création du service trap,
- la création automatique de poller,
- la création automatique du poller-display.
Vous pouvez installer les anciennes version de Centreon pour Jessie avec les archives. Vous trouverez les liens en bas de cette page.
Les scripts clapi insérés dans le package centreon-clapi ( à ne pas confondre avec les API Centreon qui sont fourni par défaut dans Centreon-Web) permettent :
- la configuration automatique de la timezone dans php.in,
- la première configuration de Centreon (base exemple),
- la création du service trap,
- la création automatique de poller,
- la création automatique du poller-display.
1 Installation du Central
1.1 version Stretch
Ajoutez le dépôt Debian, modifiez le fichier /etc/apt/source.list.
deb http://mirror.sugarbug.fr/centreon/ stretch main
Ajoutez la clé GnuPG
wget -O - http://mirror.sugarbug.fr/centreon/sugarbug.fr.gpg.key | apt-key add -
Installez le dépôt pour le PHP version 7.1
apt-get install apt-transport-https lsb-release ca-certificates -y
wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" >> /etc/apt/sources.list.d/php.list
Faites la mise à jour des dépôts sur votre machine.
apt-get update
Installer tous les paquets nécessaires pour l’installation d’un poller Central et le paquet contenant les scripts.
apt-get install centreon-central centreon-clapi
Si vous voulez installer un central sans base de données.
apt-get install centreon-central-without-database centreon-clapi
Avant de faire l’installation en mode web, utilisez le script contenu dans le paquet centreon-clapi.
/usr/share/centreon/examples/clapi/init_timezone.sh -t Europe/Paris -r
Autorisez la connexion à la base de données MariaDB. Attention, sécurisez ensuite votre base de données car l'accès root à la base se fait sans mot de passe.
/usr/share/centreon/examples/clapi/add_root_mariadb.sh
1.2 Anciennes version pour Jessie
Ajoutez le dépôt Debian, modifiez le fichier /etc/apt/source.list.
deb http://mirror.sugarbug.fr/centreon/ jessie main
Ajoutez la clé GnuPG
wget http://mirror.sugarbug.fr/centreon/sugarbug.gpg
apt-key add sugarbug.gpg
Faites la mise à jour des dépôts sur votre machine.
apt-get update
Installer tous les paquets nécessaires pour l’installation d’un poller Central et le paquet contenant les scripts.
apt-get install centreon-central centreon-clapi
Si vous voulez installer un central sans base de données.
apt-get install centreon-central-without-database centreon-clapi
Avant de faire l’installation en mode web, utilisez le script contenu dans le paquet centreon-clapi.
/usr/share/centreon/examples/clapi/init_timezone.sh -t Europe/Paris -r
2 Configuration du Central
Premier point, Paramétrez les fichier de configuration du protocole SNMP pour autoriser l’adresse IP du serveur. Editez le fichier /etc/snmp/snmpd.conf
agentAddress udp::161 rocommunity public <IP Sever Poller> iquerySecName internalUser trapsink <IP Sever Poller> public
Deuxème point, configurez les Traps SNMP pour ce poller. Editez le fichier /etc/default/snmptrapd
TRAPDRUN=yes # snmptrapd options (use syslog). TRAPDOPTS='-On -Lsd -p /var/run/snmptrapd.pid'
Ne pas oubliez de configurer la base de données des mibs, voir l’article suivant. Redémarrez les services
service snmpd restart service snmptrapd restart
2.1 Installation de Centreon en mode Web
Utilisez un navigateur internet récent et saisissez l’url suivante :
http:///centreon/
http://
cliquez sur Next
cliquez sur Next
cliquez sur Next
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
cliquez sur Next
Cliquez sur Finish on Finish
Vous devriez avoir cette vue. Vous pouvez vous connecter à l'interface d'administration.
Centreon est prêt
2.2 Application de la configuration initiale
Avant d'appliquer la première configuration, lancez les services associés à Centreon
systemctl start cbd systemctl start centcore
2.2.a Application par l’interface Web
Connectez-vous à l'IHM de Centreon. Sélectionnez le menu Configuration / Pollers. Cochez le serveur Central et cliquez sur le bouton Export.
Cochez sur le poller Central, cliquez sur Export configuration.
Cochez toutes les actions et choisir la méthode Restart pour l'application de la première configuration.
cochez les quatre premières options et cliquez sur Export
Vous devriez avoir cette fenêtre ci-dessous, en cliquant sur la croix de Central, vous indiquant le bon déroulement des opérations.
Exportation de la configuration
2.2.b Application par clapi
centreon -u admin -p password -a pollergenerate -v Central centreon -u admin -p password -a cfgmove -v Central centreon -u admin -p password -a pollerrestart -v Central service cbd reload
Voici le résultat à l'invite de commande
root@central-test8:/home/vmdebian# service cbd start root@central-test8:/home/vmdebian# centreon -u admin -p password -a pollergenerate -v Central Configuration files generated for poller 'Central' Return code end : 0 root@central-test8:/home/vmdebian# centreon -u admin -p password -a cfgmove -v Central OK: All configuration files copied with success. Return code end : 0 root@central-test8:/home/vmdebian# centreon -u admin -p password -a pollerrestart -v Central Return code end : 0 root@central-test8:/home/vmdebian# service cbd reload root@central-test8:
Au bout de quelques secondes, vous devriez avoir cette vue ci-dessous.
Vue Configuration des pollers
2.3 Application de la configuration exemple
Depuis la version 2.8x, il n'existe plus de configuration exemple par défaut dans Centreon. Avec la distribution Centreon, il faut utiliser IMP et ses plugins pack. Actuellement Centreon IMP n'est pas disponible en version Open Source. Je vous propose une configuration exemple avec l'aide des API Clapi. Avant tout, définissez les commandes de notifications pour l'admin.
2.3.a Configuration par l’interface Web
Sélectionnez Configuration / Users. cliquez sur admin pour ouvrir les propriétés.
Vue Notification pour l'admin
Choisissez Host-notify-by-email pour le paramètre Host Notification Options et service-notify-by-email pour le paramètre Service Notification Command. Validez.
2.3.b Configuration en ligne de commande
centreon -u admin -p password -o contact -a setparam -v "admin;hostnotifcmd;host-notify-by-email" centreon -u admin -p password -o contact -a setparam -v "admin;svcnotifcmd;service-notify-by-email"
2.3.c Application de la configuration exemple version Stretch
La configuration exemple utilise les plugins Centreon avec le plugin os::linux::local::plugin pour le serveur Central avec les best pratices de Centreon (commandes et templates unitaires, utilisation des templates d'hôtes et services). Ce plugin n'utilise pas le service SNMP. Une option -s est proposée pour superviser les systèmes de fichiers montés (détection automatique). une option -m vous permet de choisir le mode de redémarrage du moteur (par défaut mode rechargement). On utilise de plus le plugin database::mysql::plugin pour superviser la base mysql de centreon. On lancera la commande suivante :
/usr/share/centreon/examples/clapi/create_config_initialV3.sh -u=admin -p=password -d=centreon -w=pwcentreon -s=yes -m=restart
Vous devriez avoir ce résultat :
Create Command base Create Command local Create Command snmp Create Command mysql Create template service base Create template service local Create template service snmp Create template service local database Create template app centreon poller Create template app centreon central Create template host Create Central add storage Configuration OK !
En retournant dans la vue temps réel de Centreon, vous devriez avoir les services suivant.
Les services en fonctionnement
2.3.d Application de la configuration exemple version Jessie
La configuration exemple utilise les plugins Centreon avec le plugin os::linux::local::plugin pour le serveur Central avec les best pratices de Centreon (commandes et templates unitaires, utilisation des templates d'hôtes et services). Ce plugin n'utilise pas le service SNMP. Une option -s est proposée pour superviser les systèmes de fichiers montés (détection automatique). On utilise de plus le plugin database::mysql::plugin pour superviser la base mysql de centreon. On lancera la commande suivante :
/usr/share/centreon/examples/clapi/create_config_initialV2.sh -u=admin -p=password -d=centreon -w=pwcentreon -s=yes
Vous devriez avoir ce résultat :
Create Command Create template service Create template service local Create template service local disk Create template service local traffic Create template service local database Create template host Create Central add storage Configuration OK !
En retournant dans la vue temps réel de Centreon, vous devriez avoir les services en pending.
les services en mode pending dans la vue temps réels
Au bout de quelques minutes, vous devriez avoir cette vue.
les services actifs dans la vue temps réels
2.3.e Création des templates SNMP pour la version Jessie
A utiliser seulement pour la version Jessie. Vous avez la possibilité de créer des templates SNMP pour les hôtes distants. Vous aurez un exemple avec la configuration du poller. Lancez la commande suivante :
/usr/share/centreon/examples/clapi/create_template_snmp.sh -u=admin -p=password
Vous devriez avoir ce résultat :
Create Command Create template service Create template host
Voici les templates de service SNMP créés. Ils sont associés à quatre templates d'hôtes.
les templates de service SNMP
les templates d'hôtes SNMP
2.4 Création du service passif pour les Traps SNMP des serveurs Linux
Après avoir vérifié le fonctionnement de votre supervision et la configuration du SNMP. Nous avons utiliser le script create_trap.sh se trouvant dans /usr/share/centreon/examples/clapi. Il requière seullement le nom de l’administrateur centreon et son mot de passe. Depuis la version 1.01, il y a un contrôle des objets existants, si vous le lancez une deuxième fois, le script vérifie si les objets existent évitant une mauvaise configuration. Dans l’exemple ci-dessous, le nom de l’administrateur est admin et son mot de passe password.
/usr/share/centreon/examples/clapi/create_trap.sh -u=admin -p=passwordRésultat de la commande
create template generic-service-passif create template trap SNMP apply submit result Poller (id:1): Sqlite database successfully created Configuration files generated for poller '1' Return code end : 0 OK: All configuration files copied with success. Return code end : 0 Return code end : 0
Le script créé deux modèles de service passif generic-service-passif et Model_Trap_Linux, associe le modèle Model_Trap_Linux au modèle d’hôte Servers-Linux ainsi qu’aux traps génériques. Celui-ci applique le modèle d’hôte Servers-Linux à l’hôte Centreon-Server. Il configure les traps génériques pour accepter les commandes externes et configure la base de données pour le service centreontrapd. Enfin, il applique la nouvelle configuration. Vous devez obtenir deux services supplémentaires.
Vue des services avec la gestion des traps
Vérifiez que votre service centreontrapd est démarré, démarrez-le le cas échéant.
service centreontrapd start
Pour vérifier le fonctionnement des traps SNMP, il suffit de lancer la commande suivante :
snmptrap -v2c -c public localhost '' .1.3.6.1.6.3.1.1.5.3 .1.3.6.1.2.1.2.2.1.1 i 2 .1.3.6.1.2.1.2.2.1.7 i 1 .1.3.6.1.2.1.2.2.1.8 i 1
Vous obtiendrez l’alerte suivante :
Alerte d’un trap SNMP
Pour revenir à l'état OK, lancer cette commande :
snmptrap -v2c -c public localhost '' .1.3.6.1.6.3.1.1.5.4 .1.3.6.1.2.1.2.2.1.1 i 1 .1.3.6.1.2.1.2.2.1.7 i 1 .1.3.6.1.2.1.2.2.1.8 i 1
Pour réaliser une architecture distribuée, passez à cet article : installation d'un poller.
Dernière modification: 30/07/2023