Migrer depuis un OS de type EL vers un autre OS de type EL (depuis un Centreon 18.10 ou plus récent)

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 un autre OS de type EL 64-bits supporté. Par exemple, vous souhaitez migrer d'un CentOS 7 à un Alma 8.
• Votre version de Centreon est 18.10 ou plus récente.

En cas de migration d'une plateforme disposant du système de redondance Centreon, il est nécessaire de contacter le support Centreon.

Migrer un serveur central

Étape 1 : Installer le nouveau serveur

1. Installez votre nouvel OS en suivant les prérequis.

2. 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.

3. Réalisez les mises à jour logicielle et système :

dnf update

Étape 2 : Synchroniser les données

1. Connectez-vous à votre ancien serveur Centreon.

2. 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.

3. 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.

4. 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.

Étape 3 : Récupérer les bases de données

1. 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

2. Sur l'ancien serveur, arrêtez MariaDB :

   systemctl stop mariadb

3. 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/

4. 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;

5. 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

6. 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

7. 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:

yum install centreon-plugin-\*

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

1. Sur le nouveau serveur, forcez la montée de version en déplacant le contenu du répertoire /var/lib/centreon/installs/install-22.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-22.10.x-YYYYMMDD_HHMMSS/ /usr/share/centreon/www/install/

2. 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.

3. Connectez-vous à l'URL http://<IP_NEW_CENTREON>/centreon et suivez les étapes de la mise à jour.

4. 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 :

   1. Modifiez le fichier /etc/centreon/centreon.conf.php,
   2. Modifiez le fichier /etc/centreon/conf.pm,
   3. Éditez la configuration du Centreon Broker central, via l'interface web Centreon et modifiez le mot de passe pour l'output unfied-sql,
   4. Modifiez le fichier /etc/centreon/config.d/10-database.yaml.

5. 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.

6. Déployez la configuration de tous vos serveurs de supervision (y compris celle du central).

7. Redémarrez les processus suivants :

   systemctl restart cbd centengine
   systemctl restart gorgoned
   systemctl start snmptrapd centreontrapd
   systemctl start snmpd

8. 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).

9. Allez à la page Configuration > Packs de plugins, puis mettez à jour tous les plugin packs.

É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 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 :

• Procédure de migration pour MAP,
• Procédure de migration pour MBI.

Migrer un serveur distant

Pour migrer un serveur distant :

1. Suivez la même procédure que pour un serveur central.
2. Rattachez le nouveau serveur distant à votre serveur central.

Migrer un collecteur

Pour migrer un collecteur :

1. Effectuez les étapes 1 et 4 de la procédure de migration d'un serveur central (c'est-à-dire installer le nouveau serveur et synchronisez les plugins).
2. 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é).
3. Déployez la configuration.
4. 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.