Aller au contenu principal

A partir des paquets

Centreon fournit des RPM pour ses produits au travers de la solution Centreon Open Sources disponible gratuitement sur notre dépôt.

Ces paquets ont été testés avec succès sur les environnements CentOS en version 7 et 8.

Cependant, suite au changement de stratégie effectué par Red Hat, nous pensons qu'il est préférable de ne pas utiliser CentOS 8 en production. Ces paquets pour CentOS 8 sont compatible avec RHEL et Oracle Linux en version 8.

Après avoir installé votre serveur, réalisez la mise à jour de votre système d'exploitation via la commande :

dnf update

Acceptez toutes les clés GPG proposées et pensez a redémarrer votre serveur si une mise à jour du noyau est proposée.

Étapes de pré-installation​

Désactiver SELinux​

SELinux doit être désactivé. Pour se faire, vous devez éditer le fichier /etc/selinux/config et remplacer enforcing par disabled, ou en exécutant la commande suivante :

sed -i s/^SELINUX=.*$/SELINUX=disabled/ /etc/selinux/config

Redémarrez votre système d'exploitation pour prendre en compte le changement.

Après le redémarrage, une vérification rapide permet de confirmer le statut de SELinux :

$ getenforce
Disabled

Configurer ou désactiver le pare-feu​

Paramétrer le pare-feu système ou désactiver ce dernier. Pour désactiver ce dernier exécuter les commandes suivantes :

systemctl stop firewalld
systemctl disable firewalld

Vous pouvez trouver des instructions ici pour configurer le pare-feu.

Installer le dépôts​

Dépôt Software collections de Red Hat​

Afin d'installer les logiciels Centreon, le dépôt Software Collections de Red Hat doit être activé.

Le dépôt Software Collections est nécessaire pour l'installation de PHP 7 et les librairies associées.

Exécutez la commande suivante :

yum install -y centos-release-scl

Dépôt Centreon​

Redhat CodeReady Builder repository​

To install Centreon you will need to enable the official CodeReady Builder repository supported by Redhat.

Enable the CodeReady Builder repository using these commands:

dnf -y install dnf-plugins-core https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms

Installation​

Ce chapitre décrit l'installation d'un serveur Centreon Remote Server.

Il est possible d'installer ce serveur avec une base de données locale au serveur, ou déportée sur un serveur dédié.

Avec base de données locale​

dnf install -y centreon centreon-database
systemctl daemon-reload
systemctl restart mariadb

Avec base de données déportée​

Dans le cas d'une installation avec un serveur dédié à la base de données, ce dernier doit aussi avoir les dépôts prérequis.

Exécutez la commande suivante sur le serveur Centreon Central :

dnf install -y centreon-base-config-centreon-engine centreon-widget\*

Puis exécutez les commandes suivantes sur le serveur dédié à la base de données :

dnf install -y centreon-database
systemctl daemon-reload
systemctl restart mariadb

Créez enfin un utilisateur avec privilèges root nécessaire à l'installation de Centreon :

CREATE USER 'centreon'@'<IP>' IDENTIFIED BY '<PASSWORD>';
GRANT ALL PRIVILEGES ON *.* TO 'centreon'@'<IP>' WITH GRANT OPTION;
FLUSH PRIVILEGES;

Remplacez <IP> par l'adresse IP avec laquelle le serveur Centreon Remote Server se connectera au serveur de base de données.

Remplacez <PASSWORD> par le mot de passe de l'utilisateur 'centreon'.

Une fois l'installation terminée vous pouvez supprimer cet utilisateur via la commande :

DROP USER 'centreon'@'<IP>';

Le paquet centreon-database installe une configuration MariaDB optimisée pour l'utilisation avec Centreon.

Si ce paquet n'est pas installé, il faut à minima adapter la limitation LimitNOFILE à 32000 via une configuration dédiée, exemple:

$ cat /etc/systemd/system/mariadb.service.d/centreon.conf
[Service]
LimitNOFILE=32000

De mĂŞme pour la directive MariaDB open_files_limit, exemple:

$ cat /etc/my.cnf.d/centreon.cnf
[server]
innodb_file_per_table=1
open_files_limit=32000

Pensez à redémarrer le service mariadb après chaque changement de configuration.

Configuration​

Fuseau horaire PHP​

La timezone par défaut de PHP doit être configurée. Exécuter la commande suivante :

echo "date.timezone = Europe/Paris" >> /etc/php.d/50-centreon.ini

Changez Europe/Paris par votre fuseau horaire. La liste des fuseaux horaires est disponible ici.

Après avoir réalisé la modification, redémarrez le service PHP-FPM :

systemctl restart php-fpm

Lancement des services au démarrage​

Pour activer le lancement automatique des services au démarrage, exécutez la commande suivante sur le serveur Central :

systemctl enable php-fpm httpd mariadb centreon cbd centengine gorgoned snmptrapd centreontrapd snmpd

Si la base de données est sur un serveur dédié, pensez à activer le lancement du service mariadb sur ce dernier.

Installation web​

Avant de démarrer l'installation web, démarrez le serveur Apache avec la commande suivante :

systemctl start httpd

Terminez l'installation en réalisant les étapes de l'installation web.

Pendant l'installation web, il n'est pas nécessaire d'installer le module Autodiscovery.

A l'Ă©tape d'Initialisation de la supervision, seules les actions 6 Ă  8 doivent ĂŞtre faites.

Enregistrer le Remote Server​

Pour l'enregistrer sur le serveur Centreon Central, exécutez la commande suivante :

/usr/share/centreon/bin/registerServerTopology.sh -u <API_ACCOUNT> \
-t remote -h <IP_TARGET_NODE> -n <REMOTE_SERVER_NAME>

Example:

/usr/share/centreon/bin/registerServerTopology.sh -u admin -t remote -h 192.168.0.1 -n remote-1

Remplacer <IP_TARGET_NODE> par l'adresse IP du serveur Centreon Central vue par votre collecteur.

Le compte <API_ACCOUNT> doit avoir accès à l'API de configuration. Vous pouvez utiliser le compte admin.

Vous pouvez changer le port et la méthode HTTP, le format de l'option -h est le suivant : HTTPS://<IP_TARGET_NODE>:PORT

Suivre ensuite les instructions

  1. Saisir le mot de passe :

    192.168.0.1: please enter your password
  2. Sélectionner l'adresse IP si plusieurs interfaces réseau existent:

    Which IP do you want to use as CURRENT NODE IP ?
    1) 192.168.0.2
    2) 192.168.0.3
    1
  3. Valider les informations:

    Summary of the informations that will be send:

    Api Connection:
    username: admin
    password: ******
    target server: 192.168.0.1

    Pending Registration Server:
    name: remote-1
    type: remote
    address: 192.168.0.2

    Do you want to register this server with those informations ? (y/n)y
  4. Ajouter les informations nécessaires pour permettre de futures communications entre votre Remote Server et son Central

    <CURRENT_NODE_ADDRESS> : Please enter your username:
    admin
    <CURRENT_NODE_ADDRESS> : Please enter your password:

    <CURRENT_NODE_ADDRESS> : Protocol [http]:
    <CURRENT_NODE_ADDRESS> : Port [80]:
    <CURRENT_NODE_ADDRESS> : centreon root folder [centreon]:
  5. Définir les accès au proxy du serveur Centreon du Central :

    Are you using a proxy ? (y/n)
    y
    enter your proxy Host:
    myproxy.example.com
    enter your proxy Port [3128]:
    Are you using a username/password ? (y/n)
    y
    enter your username:
    my_proxy_username
    enter your password:

Vous recevrez la validation du serveur Centreon Central :

2020-10-16T17:19:37+02:00 [INFO]: The CURRENT NODE 'remote: 'remote-1@192.168.0.2' has been converted and registered successfully.

Enfin, il est nécessaire d'ajouter des droits à l'utilisateur de base de données centreon pour qu'il puisse utiliser la commande LOAD DATA INFILE :

GRANT FILE on *.* to 'centreon'@'localhost';

Principaux messages d'erreur​

2020-10-20T10:23:15+02:00 [ERROR]: Invalid credentials

Vos informations d'identification sont incorrectes pour le compte <API_ACCOUNT>.

2020-10-20T10:24:59+02:00 [ERROR]: Access Denied.

L'utilisateur <API_ACCOUNT> n'a pas accès à l'API de configuration.

Failed connect to 192.168.0.1:444; Connection refused

Impossible d'accéder à l'API. Contrôler les valeurs <IP_TARGET_NODE>, méthode et port.

2020-10-20T10:39:30+02:00 [ERROR]: Can’t connect to the API using: https://192.168.0.1:443/centreon/api/latest/login

L'URL d'accès n'est pas complète ou invalide. Utilisez l'option -root pour définir le chemin de l'URL de l'API. Par exemple : --root monitoring.

2020-10-20T10:42:23+02:00 [ERROR]: No route found for “POST /centreon/api/latest/platform/topology”

La version Centreon du serveur distant est invalide. Elle doit être supérieur ou égale à 20.10.

Ajouter le Remote Server à la configuration​

Rendez-vous au chapitre Ajouter un Remote Server Ă  la configuration.

Sécurisez votre plateforme​

N'oubliez pas de sécuriser votre plateforme Centreon en suivant nos recommandations