Aller au contenu principal
Version: 23.04

Installer l'extension MAP de Centreon

Dans la mesure où MAP (Legacy) n'évoluera plus, nous vous suggérons de le remplacer par Centreon MAP. MAP présente des avantages considérables par rapport à MAP (Legacy), notamment :

  • L'éditeur web : créez et modifiez vos vues directement à partir de votre navigateur web.
  • Un nouveau serveur : un tout nouveau serveur et modèle de données offrant de meilleures performances.

Centreon MAP nécessite une clé de licence valide. Pour en acquérir une et récupérer les dépôts nécessaires, contactez Centreon.

Ce chapitre décrit comment installer Centreon MAP. Le serveur doit être installé sur une machine dédiée pour permettre à Centreon MAP de fonctionner avec sa propre base de données et éviter tout conflit potentiel avec le serveur central Centreon.

Avant de procéder à l'installation, veillez à consulter le chapitre sur les prérequis pour connaître la configuration requise (CPU et mémoire). N'oubliez pas de choisir le meilleur type d'architecture pour répondre à vos besoins.

Architecture

Centreon MAP se compose de trois éléments :

  • Le serveur Centreon MAP, développé en Java, utilisant SpringBoot, Hibernate et CXF.
  • L'interface web de Centreon MAP, développée en Javascript et basée sur Backbone.js.
  • Le client lourd Centreon MAP, développé en Java, basé sur Eclipse RCP 4.

Le schéma ci-dessous résume l'architecture :

image

Tableau des flux du réseau

ApplicationSourceDestinationPortProtocoleObjet
MAP ServerMAP serverCentreon central broker5758TCPObtenez des mises à jour du statut en temps réel
MAP ServerMAP serverCentreon MariaDB database3306TCPRécupérer la configuration et d'autres données de Centreon
MAP ServerMAP serverMAP server database3306TCPStocker toutes les vues et données relatives à Centreon MAP
Web + DesktopMAP serverCentreon central80/443HTTP/HTTPSAuthentification et récupération des données
Web interfaceUserMAP server8080/8443HTTP/HTTPSRécupérer les vues et le contenu
Web interfaceUserInternet* (Mapbox)443HTTPSRécupérer les données Mapbox
Desktop clientUserMAP server8080/8443HTTP/HTTPSRécupérer et créer des vues et du contenu
Desktop clientUserInternet* (Mapbox)443HTTPSRécupérer les données Mapbox
Desktop clientUserInternet* (p2 repo)80HTTPRécupérer la mise à jour automatique du client lourd

* Avec ou sans proxy.

Prérequis

Centreon

Le serveur central et Centreon MAP doivent être installés dans les mêmes versions majeures (c'est-à-dire tous deux en 23.04.x).

Serveur MAP Centreon

Licence

Le serveur nécessite que la licence soit disponible et valide sur le serveur central de Centreon. Pour ce faire, vous devez contacter le support Centreon pour obtenir et installer votre clé de licence.

Matériel

La configuration matérielle requise pour votre serveur dédié Centreon MAP est la suivante :

Services supervisés< 10 000< 20 000< 40 000> 40 000
CPU2 vCPU ( 3Ghz ) minimum4 CPU (3GHz) Minimum4 CPU (3GHz) MinimumDemandez à l'équipe commerciale Centreon
Mémoire dédiée2GB4GB8GBDemandez à l'équipe commerciale Centreon
Partition de données MariaDB2GB5GB10GBDemandez à l'équipe commerciale Centreon

Pour implémenter correctement la mémoire dédiée, vous devez modifier le paramètre JAVA_OPTS dans le fichier de configuration Centreon MAP /etc/centreon-studio/centreon-map.conf et redémarrer le service :

JAVA_OPTS="-Xms512m -Xmx4G"

La valeur Xmx dépend de la quantité de mémoire indiquée dans le tableau ci-dessus.

Redémarrez ensuite le service :

systemctl restart centreon-map

L'espace utilisé par le serveur Centreon MAP est directement déterminé par le nombre d'éléments que vous ajoutez dans vos vues. Un élément est tout objet graphique dans Centreon MAP. La plupart des éléments (comme les hôtes, les groupes, etc.) ont des enfants qui doivent être inclus dans le comptage.

Ces valeurs sont appliquées après l'optimisation des tables Centreon MAP.

Logiciel

Voir les prérequis logiciels.

Informations requises lors de la configuration

  • Connexion à Centreon Web avec des droits d'administrateur.

Même avec un serveur correctement dimensionné, vous devez garder à l'esprit les meilleures pratiques et recommandations lors de la création de vues afin de ne pas rencontrer de problèmes de performance.

Si le serveur central est configuré en HTTPS, vous devez appliquer la configuration SSL sur le serveur MAP. Suivez cette procédure pour sécuriser votre serveur MAP.

Interface Web de Centreon MAP

Licence

L'interface web nécessite que la licence soit disponible et valide sur le serveur central de Centreon. Pour ce faire, vous devez contacter le support Centreon pour obtenir et installer votre clé de licence.

Compatibilité

L'interface web MAP de Centreon est compatible avec les navigateurs web suivants :

  • Google Chrome (dernière version au moment de la sortie du logiciel Centreon et supérieure). Veuillez consulter la FAQ Google Chrome pour une description de la politique de support de Chrome.
  • Mozilla Firefox (dernière version au moment de la sortie du logiciel Centreon et supérieure). Veuillez consulter la FAQ Mozilla pour obtenir une description de la politique d'assistance de Firefox.
  • Apple Safari (dernière version au moment de la sortie du logiciel Centreon et supérieure).
  • Microsoft Edge Chromium (dernière version au moment de la sortie du logiciel Centreon et supérieure).

Si une mise à jour de ces navigateurs pris en charge devait entraîner une incompatibilité, Centreon travaillerait sur un correctif dans les plus brefs délais (pour les versions de Centreon supportées). Bien que d'autres navigateurs puissent fonctionner, Centreon ne tentera pas de résoudre les problèmes liés aux navigateurs autres que ceux énumérés ci-dessus.

La résolution de votre écran doit être d'au moins 1280 x 768.

Centreon MAP Desktop Client

  • 4 GB de RAM minimum, 8 GB conseillés (obligatoire pour 10 000 services ou plus)
  • Java 64 bits version 8
  • La résolution doit être d'au moins 1280 x 768.
  • Debian 7, 8 ou 9

Le client lourd n'est pas compatible avec Microsoft Windows Server. Si une version de Java autre que 8 est installée, installez Java 8 et modifiez le fichier Centreon-Map4.ini pour ajouter la ligne suivante : -vm $path_to_java8$ AVANT -vmwargs.

Pour optimiser le client lourd, vous devez lui allouer plus de mémoire que la valeur par défaut. Modifiez le fichier suivant :

C:\Users\<YOUR_USERNAME>\AppData\Local\Centreon-Map4\Centreon-Map4.ini

Et ajoutez les lignes suivantes à la fin du fichier, sur une nouvelle ligne :

-Xms512m
-Xmx4g

Configuration réseau

Le serveur Centreon MAP doit accéder :

  • au Broker du serveur central, généralement sur la machine Centreon central, en utilisant le port TCP 5758
  • à la base de données Centreon, généralement sur la machine Centreon central, en utilisant le port TCP 3306.
  • à la base de données MAP Centreon, généralement sur l'hôte local, en utilisant le port TCP 3306.

Tous les ports ci-dessus sont des valeurs par défaut et peuvent être modifiés si nécessaire.

  • Centreon Web Central, en utilisant le port HTTP 80 ou le port HTTPS 443

Les machines clientes Centreon MAP Desktop doivent accéder :

  • au serveur Centreon MAP, en utilisant le port HTTP 8080 ou 8443 lorsque HTTPS/TLS est activé.
  • à internet avec ou sans proxy.

Les ports 8080 et 8443 sont des valeurs par défaut recommandées, mais d'autres configurations sont possibles.

Installation du serveur

Interface web de Centreon

Vous devez fournir au serveur Centreon MAP un utilisateur dédié qui a accès à toutes les ressources par le biais des groupes de listes d'accès. Étant donné que le mot de passe sera stocké sous une forme lisible par l'homme dans un fichier de configuration, vous ne devez pas utiliser un compte utilisateur Centreon admin.

  • Allez dans Configuration > Utilisateurs > Contacts/Utilisateurs. Puis cliquez sur l'onglet Authentification Centreon.
  • Définir le paramètre Accès à l'API de temps réel sur Oui.

image

Excluez l'utilisateur de la politique d'expiration du mot de passe sur la page Administration > Authentification : son mot de passe n'expirera jamais.

image

Serveur central Centreon

Créez un utilisateur dans l'instance mysql hébergeant les bases de données 'centreon' et 'centreon_storage' :

CREATE USER 'centreon_map'@'<IP_SERVER_MAP>' IDENTIFIED BY 'centreon_map';
GRANT SELECT ON centreon_storage.* TO 'centreon_map'@'<IP_SERVER_MAP>';
GRANT SELECT, INSERT ON centreon.* TO 'centreon_map'@'<IP_SERVER_MAP>';

Le privilège INSERT ne sera utilisé que pendant le processus d'installation afin de créer une nouvelle sortie Centreon Broker. Il sera révoqué ultérieurement.

Serveur MAP Centreon

Prérequis de la version Java

Assurez-vous qu'une version de Java 17 (ou 18) est installée avant de commencer la procédure.

  • Pour vérifier quelle version de Java est installée, entrez la commande suivante :

    java -version
  • Pour une mise à jour de Java en version 17 (ou 18), allez sur la page officielle de téléchargement d'Oracle.

  • Si plusieurs versions de Java sont installées, vous devez activer la bonne version. Affichez les versions installées avec la commande suivante puis sélectionnez la version 17 (ou 18) :

    sudo update-alternatives --config java
  • Si vous souhaitez configurer votre plateforme en HTTPS, vous aurez besoin de générer un fichier keystore pour la version 17 de Java (ou 18) (voir procédure).

Procédure

Si vous avez installé votre serveur Centreon MAP à partir d'une "installation fraîche", vous devez installer le dépôt Centreon :

Vous devez d'abord installer le dépôt EPEL :

dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

La commande doit retourner des résultats comme suit :

Installed:
epel-release-8-17.el8.noarch

Complete!

Ensuite installez le dépôt Centreon :

dnf install -y dnf-plugins-core
dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/23.04/el8/centreon-23.04.repo

Si l'URL ne fonctionne pas, vous pouvez trouver manuellement ce paquet dans le dossier.

Installez le dépôt Centreon Business, vous pouvez le trouver sur le portail du support.

Installez ensuite le serveur Centreon MAP à l'aide de la commande suivante :

dnf install centreon-map-server

Lors de l'installation du serveur Centreon MAP, java (OpenJDK 11) sera automatiquement installé, si nécessaire.

Vous devez disposer d'une base de données MariaDB pour stocker les données de Centreon MAP, qu'elle soit sur localhost ou ailleurs.

Pour installer MariaDB, exécutez la commande suivante :

Vous devez d'abord ajouter le dépôt MariaDB :

curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | sudo bash -s -- --os-type=rhel --os-version=8 --mariadb-server-version="mariadb-10.5"

Puis installez MariaDB :

dnf install MariaDB-client MariaDB-server

Configuration

Assurez-vous que la base de données qui stocke les données MAP de Centreon est optimisée (automatiquement ajoutée par le RPM dans /etc/my.cnf.d/map.cnf) :

max_allowed_packet = 20M
innodb_log_file_size = 200M

Ensuite, redémarrez MariaDB :

systemctl restart mariadb

Sécuriser la base de données

Depuis MariaDB 10.5, il est obligatoire de sécuriser l'accès root de la base de données avant d'installer Centreon. Si vous utilisez une base de données locale, exécutez la commande suivante sur le serveur central :

mysql_secure_installation
  • Répondez oui à toutes les questions, sauf à "Disallow root login remotely ?
  • Il est obligatoire de définir un mot de passe pour l'utilisateur root de la base de données. Vous aurez besoin de ce mot de passe pendant l'installation web.

Pour plus d'informations, veuillez consulter la documentation officielle de MariaDB.

Script Configure.sh

Exécutez le script de configuration du serveur MAP de Centreon. Deux modes sont disponibles : interactif ou automatique.

  • interactif (aucune option/mode par défaut) : Plusieurs questions seront posées pour remplir de manière interactive les variables d'installation.
  • automatique (--automatic ou -a) : L'installation se fera automatiquement à partir des valeurs définies dans le fichier /etc/centreon-studio/vars.sh.

Si c'est votre première installation, nous vous conseillons d'utiliser le mode standard (interactif) et de choisir Non lorsqu'on vous demande le mode d'installation avancé :

/etc/centreon-studio/configure.sh

Voici ce que vous devez voir en sortie :

Configuration completed, enjoy !

Ce script crée le fichier studio-config.properties.

URI personnalisée

Si vous avez personnalisé une URI de connexion pour votre plateforme Centreon, vous devez éditer le fichier studio-config.properties en ajoutant la commande suivante et en utilisant l'URI personnalisée déjà définie ici :

centreon.path=/your-custom-uri

Puis redémarrez le service centreon-map :

systemctl restart centreon-map

Serveur central

Avant de redémarrer Broker, vous devez exporter la configuration à partir de l'interface web de Centreon.

Redémarrez Centreon Broker sur le serveur central :

systemctl restart cbd

Supprimer le privilège INSERT de l'utilisateur centreon_map :

REVOKE INSERT ON centreon.* FROM 'centreon_map'@'<IP_SERVER_MAP>';

Serveur Centreon MAP

Vérifiez votre configuration :

/etc/centreon-studio/diagnostic.sh

Si la configuration est correcte, le service centreon-map peut être lancé à partir du serveur Centreon MAP :

systemctl restart centreon-map

Permettez au service de démarrer automatiquement au démarrage du serveur :

systemctl enable centreon-map

Le serveur Centreon MAP est maintenant démarré et activé : installons la partie interface de l'extension.

Installation de l'interface web

Serveur central

Installez le dépôt Centreon Business : vous pouvez le trouver sur le portail du support.

Ensuite, exécutez la commande suivante :

dnf install centreon-map-web-client

Web

Allez dans Centreon > Administration > Extensions et cliquez sur le bouton d'installation :

  • License Manager (si pas encore installé)
  • Client Web MAP

Téléchargez la licence map.license donnée par l'équipe de support. Rafraîchissez la page : la bannière doit être verte et afficher la date de validité de la licence.

image

Cliquez sur Back pour revenir à la page Extensions. Maintenant que le module est installé, nous allons le configurer.

Configuration

Allez à la page Administration > Extensions > Options, et dans le menu Centreon MAP mettez à jour le champ Adresse du serveur MAP :

Utilisez l'adresse IP/le nom d'hôte réels de votre serveur Centreon MAP.

image

Utilisation du client

L'interface Web Centreon MAP est désormais disponible dans Monitoring > MAP.

image

Si le contenu ne s'affiche pas, vous pouvez vider le cache de votre navigateur.

Vous pouvez voir à quelle IP le client est connecté.

image

Widget MAP de Centreon

En installant l'interface Web, vous ajoutez automatiquement le Widget Centreon MAP, mais vous devez effectuer une dernière tâche. Allez dans Administration > Extensions et cliquez sur le bouton Installer du widget. Voici le résultat après installation :

image

Desktop Client

Exécutables

Le client lourd est actuellement disponible uniquement pour les plateformes 64-bit Windows, Mac et Linux (Debian et Ubuntu).

Vous pouvez trouver les installateurs dans Supervision > Map > Desktop Client ou ici.

Pour des raisons de performance, nous recommandons fortement d'avoir moins de 5 à 10 utilisateurs maximum connectés en même temps pour manipuler les vues.

Installation

Sur l'ordinateur de l'utilisateur

Le client lourd nécessite Java 8. Vous pouvez télécharger et installer la dernière version de Java depuis ici.

Veillez à télécharger la version 64 bits. Les navigateurs sont généralement 32 bits et le site Web d'Oracle propose généralement Java 32 bits au lieu de la version 64 bits. Si Java est déjà installé, utilisez la commande java -version pour vérifier l'architecture. Si le 64 bits n'apparaît pas, la version est 32 bits.

Sur une plate-forme Mac, notez que vous devez installer Oracle JDK au lieu du JRE habituellement requis.

Pour vérifier la version de Java, exécutez la commande :

java -version

Exécutez centreon-map4-desktop-client-xxxx.exe :

Vous n'avez pas besoin d'être l'administrateur de votre ordinateur pour effectuer l'installation. Tous les fichiers seront installés dans vos dossiers personnels.

Le dossier d'installation par défaut est C:\Users\$user$\AppData\LocalCentreon-Map4.

Vous pouvez installer le logiciel à cet emplacement sans droits d'administrateur, mais vous pouvez changer la destination en Program files si vous avez les droits suffisants.

Utilisez le programme d'installation pour installer correctement le logiciel et l'intégrer dans l'environnement Windows. Le programme d'installation peut également être utilisé pour le désinstaller à partir de la page de configuration dédiée de Windows.

image

Mises à jour

Une fois installé, le client lourd est automatiquement maintenu à jour grâce à un système de mise à jour en ligne. Lorsqu'il se connecte à un serveur Centreon MAP, il télécharge et installe automatiquement la dernière version compatible avec le serveur. La mise à jour automatique nécessite que votre ordinateur ait un accès à internet.

Sécurisez votre plateforme

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