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 :
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
dnf update
yum 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 les dĂ©pĂŽtsâ
- RHEL 8
- CentOS 8
- Oracle Linux 8
- CentOS 7
DĂ©pĂŽt remi et CodeReady Builderâ
Afin d'installer les logiciels Centreon, les dĂ©pĂŽts remi et CodeReady Builder doivent ĂȘtre installĂ©s.
Exécutez les commandes suivantes :
dnf install -y dnf-plugins-core
dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
dnf install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm
subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms
Activez PHP 8.0 en utilisant les commandes suivantes :
dnf module reset php
dnf module install php:remi-8.0
DĂ©pĂŽt remiâ
Afin d'installer les logiciels Centreon, le dĂ©pĂŽt remi doit ĂȘtre installĂ©.
Exécutez les commandes suivantes :
dnf install -y dnf-plugins-core
dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
dnf install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm
dnf config-manager --set-enabled 'powertools'
Activez PHP 8.0 en utilisant les commandes suivantes :
dnf module reset php
dnf module install php:remi-8.0
DĂ©pĂŽt remi et CodeReady Builderâ
Afin d'installer les logiciels Centreon, les dĂ©pĂŽts remi et CodeReady Builder doivent ĂȘtre installĂ©s.
Exécutez les commandes suivantes :
dnf install -y dnf-plugins-core
dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
dnf install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm
dnf config-manager --set-enabled ol8_codeready_builder
Activez PHP 8.0 en utilisant les commandes suivantes :
dnf module reset php
dnf module install php:remi-8.0
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Ă©. Celui-ci est nĂ©cessaire pour l'installation de apache 2.4.
Exécutez la commande suivante :
yum install -y centos-release-scl
DĂ©pĂŽt remiâ
Afin d'installer les logiciels Centreon, le dĂ©pĂŽt remi doit ĂȘtre installĂ©.
Exécutez les commandes suivantes :
yum install -y yum-utils
yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm
yum-config-manager --enable remi-php80
DĂ©pĂŽt Centreonâ
Afin d'installer les logiciels Centreon à partir des dépÎts, vous devez au préalable installer le fichier lié au dépÎt.
Exécutez la commande suivante :
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
dnf install -y https://yum.centreon.com/standard/21.10/el8/stable/noarch/RPMS/centreon-release-21.10-5.el8.noarch.rpm
yum install -y https://yum.centreon.com/standard/21.10/el7/stable/noarch/RPMS/centreon-release-21.10-5.el7.centos.noarch.rpm
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â
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
dnf install -y centreon centreon-database
systemctl daemon-reload
systemctl restart mariadb
yum install -y centreon centreon-database
systemctl daemon-reload
systemctl restart mariadb
Vous pouvez maintenant passer à l'étape suivante.
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 :
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
dnf install -y centreon-base-config-centreon-engine centreon-widget\*
yum 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 :
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
dnf install -y centreon-database
systemctl daemon-reload
systemctl restart mariadb
yum install -y centreon-database
systemctl daemon-reload
systemctl restart mariadb
Sécurisez votre installation MariaDB en exécutant la commande suivante :
mysql_secure_installation
Créez enfin un utilisateur avec privilÚges root nécessaire à l'installation de Centreon :
CREATE USER '<USER>'@'<IP>' IDENTIFIED BY '<PASSWORD>';
GRANT ALL PRIVILEGES ON *.* TO '<USER>'@'<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 <USER> et <PASSWORD> par les identifiants de l'utilisateur.
Une fois l'installation terminée vous pouvez supprimer cet utilisateur via la commande :
DROP USER '<USER>'@'<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=32000De 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=32000Pensez à redémarrer le service mariadb aprÚs chaque changement de configuration.
Configurationâ
Nom du serveurâ
Si vous le souhaitez, vous pouvez changer le nom du serveur Ă l'aide de la commande suivante:
hostnamectl set-hostname new-server-name
Remplacez new-server-name par le nom de votre choix. Exemple :
hostnamectl set-hostname remote1
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
Remplacez 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 :
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
systemctl enable php-fpm httpd mariadb centreon cbd centengine gorgoned snmptrapd centreontrapd snmpd
systemctl enable php-fpm httpd24-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.
SĂ©curiser la base de donnĂ©esâ
Depuis MariaDB 10.5, il est obligatoire de sécuriser l'accÚs root à la base avant d'installer Centreon. Exécutez la commande suivante :
mysql_secure_installation
- Répondez oui à toute question sauf à "Disallow root login remotely?".
- Vous devez obligatoirement définir un mot de passe pour l'utilisateur root de la base de données. Ce mot de passe vous sera demandé lors de l'installation web.
Pour plus d'informations, veuillez consulter la documentation officielle MariaDB.
Installation webâ
Avant de démarrer l'installation web, démarrez le serveur Apache avec la commande suivante :
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
systemctl start httpd
systemctl start httpd24-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 transformer le serveur en serveur distant et l'enregistrer sur le serveur Central, exécutez la commande suivante sur le futur serveur distant :
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
/usr/share/centreon/bin/registerServerTopology.sh -u <API_ACCOUNT> \
-t remote -h <IP_TARGET_NODE> -n <REMOTE_SERVER_NAME>
Exemple:
/usr/share/centreon/bin/registerServerTopology.sh -u admin -t remote -h 192.168.0.1 -n remote-1
/usr/share/centreon/bin/registerServerTopology.sh -u <API_ACCOUNT> \
-t remote -h <IP_TARGET_NODE> -n <REMOTE_SERVER_NAME>
Exemple:
/usr/share/centreon/bin/registerServerTopology.sh -u admin -t remote -h 192.168.0.1 -n remote-1
Remplacez <IP_TARGET_NODE> par l'adresse IP du serveur Central auquel vous voulez rattacher le serveur distant (adresse IP vue par le serveur distant).
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
Saisir le mot de passe :
192.168.0.1: please enter your password
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
1Valider 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)yAjouter 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]: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Ă©rieure ou Ă©gale Ă 21.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