Migrer depuis un OS de type EL vers Debian
Prérequis
Cette procédure ne s'applique que dans les conditions suivantes :
- Vous souhaitez migrer d'un OS de type EL 64-bits vers Debian. Par exemple, vous souhaitez migrer d'un CentOS 7 à Debian 12.
- Votre version de Centreon est 18.10 ou plus récente, et vous souhaitez passer à la dernière version de Centreon. Si vous souhaitez migrer depuis une plus ancienne version, contactez l'équipe support Centreon.
Tous les serveurs de votre architecture (serveur central, serveurs distants et collecteurs) doivent avoir la même version majeure de Centreon. Il est également recommandé d'avoir la même version mineure.
En cas de migration d'une plateforme disposant du système de redondance Centreon, il est nécessaire de contacter le support Centreon.
Migrer une plateforme
Étape 1 : Installer le nouveau serveur central
-
Installez votre nouvel OS: voir la liste des OS supportés.
-
Installez un nouveau serveur central Centreon à partir des paquets jusqu'à terminer le processus d'installation en vous connectant à l'interface web.
Pendant le processus d'installation web, utilisez le même mot de passe pour l'utilisateur centreon que sur l'ancienne plateforme.
-
Réalisez les mises à jour logicielle et système :
apt update && apt upgrade
Étape 2 : Synchroniser les données
-
Connectez-vous à votre ancien serveur Centreon.
-
Générez une paire de clés ssh pour root :
ssh-keygen -t rsa
Par défaut, la paire de clés générée sera /root/.ssh/id_rsa.pub et /root/.ssh/id_rsa.
-
Copiez la clé publique de root (/root/.ssh/id_rsa.pub) dans le fichier /root/.ssh/authorized_keys du nouveau serveur. Si vous n'utilisez pas le compte root pour la synchronisation, assurez-vous que votre utilisateur dispose de droits d'écriture sur le dossier cible.
-
Depuis l'ancien serveur, synchronisez les répertoires suivants vers le nouveau serveur :
rsync -avz /etc/centreon root@\<IP_NOUVEAU_CENTREON\>:/etc
rsync -avz /etc/centreon-broker root@\<IP_NOUVEAU_CENTREON\>:/etc
rsync -avz /var/log/centreon-engine/archives/ root@\<IP_NOUVEAU_CENTREON\>:/var/log/centreon-engine
rsync -avz --exclude centcore/ --exclude log/ /var/lib/centreon root@\<IP_NOUVEAU_CENTREON\>:/var/lib
rsync -avz /usr/share/centreon/www/img/media root@<IP_NEW_CENTREON>:/usr/share/centreon/www/img
Si vous avez personnalisé le nom de votre fichier de clé privée, utilisez le format suivant (remplacez id_rsa_custom par le nom de votre fichier, et <commande>
par les commandes ci-dessus):
rsync -avz -e "ssh -i /root/.ssh/id_rsa_custom" <commande>
Remplacez <IP_NOUVEAU_CENTREON> par l'adresse IP de votre nouveau serveur Centreon.
-
Sur le nouveau serveur, changez les droits utilisateur suivants :
chown www-data: /etc/centreon-broker/*
chown www-data: /etc/centreon-engine/*
chown centreon: /etc/centreon/*
chown centreon: /var/lib/centreon/*
chown centreon-broker: /var/lib/centreon/metrics/*
chown centreon-broker: /var/lib/centreon/status/*
chown centreon-gorgone: /var/lib/centreon/nagios-perf/perfmon-* -R
chown centreon-engine: /var/lib/centreon/centplugins/*
Étape 3 : Récupérer les bases de données
-
Sur l'ancien serveur, faitez un dump des bases de données :
mysqldump -u root -p centreon > /tmp/centreon.sql
mysqldump -u root -p centreon_storage > /tmp/centreon_storage.sql -
Sur l'ancien serveur, arrêtez MariaDB :
systemctl stop mariadb
-
Depuis l'ancien serveur, exportez les dumps vers le nouveau serveur de base de données (assurez-vous d'avoir assez d'espace):
rsync -avz /tmp/centreon.sql root@\<IP_NOUVEAU_CENTREON\>:/tmp/
rsync -avz /tmp/centreon_storage.sql root@\<IP_NOUVEAU_CENTREON\>:/tmp/ -
Sur le nouveau serveur de base de données, supprimez les bases de données vierges et recréez-les :
mysql -u root -p
DROP DATABASE centreon;
DROP DATABASE centreon_storage;
CREATE DATABASE centreon;
CREATE DATABASE centreon_storage; -
Sur le nouveau serveur de bases de données, importez dans la base les dumps précédemment transférés :
mysql -u root centreon -p </tmp/centreon.sql
mysql -u root centreon_storage -p </tmp/centreon_storage.sql -
Exécutez l'upgrade des tables :
mysql_upgrade
Si votre base de données est protégée par mot de passe, entrez :
mysql_upgrade -u <utilisateur_admin_bdd> -p
Exemple : si votre utilisateur_admin_bdd est
root
, entrez:mysql_upgrade -u root -p
-
Démarrez le processus mariadb sur le nouveau serveur :
systemctl start mariadb
Remplacez <IP_NOUVEAU_CENTREON> par l'adresse IP de votre nouveau serveur Centreon.
Étape 4 : Synchroniser les plugins
Si vous n'utilisez que des plugins Centreon, réinstallez-les sur le nouveau serveur:
-
Installez le dépôt des connecteurs de supervision (vous trouverez son adresse sur le portail support Centreon).
-
Exécutez les commandes suivantes :
apt update
apt install centreon-pack*
apt install centreon-plugin-\*
Sous Debian, le répertoire des plugins Nagios (qui exécutent par exemple la commande check_icmp) est /usr/lib/nagios/plugins/. Allez à la page Configuration > Collecteurs > Ressources et vérifiez que le chemin de la macro $USER1$ est bien /usr/lib/nagios/plugins/. Idem pour le champ Répertoire des sondes à la page Administration > Paramètres > Supervision.
Si vous utilisez vos propres plugins personnalisés, synchronisez les répertoires qui contiennent ceux-ci, ainsi que toutes éventuelles dépendances.
Étape 5 : Montée de version de la solution Centreon
-
Sur le nouveau serveur, forcez la montée de version en déplacant le contenu du répertoire /var/lib/centreon/installs/install-24.10.x-YYYYMMDD_HHMMSS dans le répertoire /usr/share/centreon/www/install (x est le numéro de version cible pour votre machine migrée):
cd /var/lib/centreon/installs/
mv install-24.10.x-YYYYMMDD_HHMMSS/ /usr/share/centreon/www/install/ -
Si vous utilisez la meme adresse IP ou le même nom DNS entre l'ancien serveur web Centreon et le nouveau, videz complètement le cache de votre navigateur pour éviter des problemes de scripts JS.
-
Connectez-vous à l'URL
http://<IP_NEW_CENTREON>/centreon
et suivez les étapes de la mise à jour. -
Si vous avez modifié le mot de passe de l'utilisateur centreon lors de l'installation de votre nouveau serveur Centreon pour accéder aux bases de données, il sera nécessaire de réaliser les actions suivantes sur le nouveau serveur Centreon :
- Modifiez le fichier /etc/centreon/centreon.conf.php,
- Modifiez le fichier /etc/centreon/conf.pm,
- Éditez la configuration du Centreon Broker central, via l'interface web Centreon et modifiez le mot de passe pour l'output unfied-sql,
- Modifiez le fichier /etc/centreon/config.d/10-database.yaml.
-
Si l'adresse IP de votre serveur Centreon a changé :
- Éditez la configuration de l'ensemble des modules Broker de vos collecteurs et modifiez l'adresse IP de connexion au serveur Centreon central (output IPv4). Consultez le chapitre Configuration avancée pour plus d'information.
- L'empreinte de votre plateforme a également changé : contactez Centreon pour obtenir une nouvelle licence.
-
Les informations de connexion de l'utilisateur centreon-gorgone nouvellement créé doivent être les mêmes que celles de l'utilisateur centreon-gorgone sur l'ancien serveur. Éditez le fichier
etc/centreon-gorgone/config.d/31-centreon-api.yaml
et entrez les information de connexion de l'ancien utilisateur. Exemple :gorgone:
tpapi:
- name: centreonv2
base_url: "http://127.0.0.1/centreon/api/latest/"
username: "@GORGONE_USER@"
password: "@GORGONE_PASSWORD@"
- name: clapi
username: "@GORGONE_USER@"
password: "@GORGONE_PASSWORD@" -
Déployez la configuration de tous vos serveurs de supervision (y compris celle du central).
-
Redémarrez les processus suivants :
systemctl restart cbd centengine
systemctl restart gorgoned
systemctl start snmptrapd centreontrapd
systemctl start snmpd -
Si vous supervisiez votre ancienne machine Centreon, et que vous avez changé le nom d'utilisateur/mot de passe de la base pendant la migration, mettez à jour la configuration des ressources concernées (hôte, services dépendant de cet hôte).
-
Allez à la page Configuration > Gestionnaire de connecteurs de supervision, puis mettez à jour tous les connecteurs de supervision.
Étape 6 (anciennes versions uniquement): Migrer vers Gorgone
Si vous migrez depuis un Centreon 18.10, 19.04 ou 19.10, vous devez également migrer de Centcore à Gorgone.
Étape 7: Mettre à jour les modules
Pour finir la mise à jour des connecteurs de supervision, allez à la page Configuration > Gestionnaire de connecteurs de supervision, puis cliquez sur
Pour mettre à jour les modules, allez à la page Administration > Extensions > Gestionnaire et cliquez sur Update all. Si vous avez un serveur MAP ou MBI, suivez les procédures de migration correspondantes :
Étape 8: Migrer vos autres serveurs (architecture distribuée)
Migrer un serveur distant
Pour migrer un serveur distant :
- Suivez la même procédure que pour un serveur central.
- Rattachez le nouveau serveur distant à votre serveur central.
Migrer un collecteur
Pour migrer un collecteur :
- Installez un nouveau collecteur.
- Synchronisez les plugins, comme décrit à l'étape 4 de la procédure de migration pour un serveur central.
- Sur le serveur central, allez à la page Configuration > Collecteurs. Sélectionnez le collecteur migré et mettez à jour son adresse IP (si celle-ci a changé).
- Déployez la configuration.
- Si votre collecteur rencontre des problèmes suite à la migration (impossible de déployer la configuration, d'effectuer des actions de supervision...), mettez à jour l'empreinte du collecteur comme décrit dans cet article de base de connaissances.