Version: ⭐ 24.10

Migrer depuis Debian 11 vers Debian 12

Prérequis

Cette procédure ne s'applique que si vous souhaitez migrer de Debian 11 vers Debian 12, sur des serveurs différents. (Si vous souhaitez simplement monter de version l'OS de votre machine hôte, consultez How to migrate from Debian 11 to Debian 12).

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

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

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

Prérequis​

Migrer une plateforme​

Étape 1 : Installer le nouveau serveur central​

Étape 2 : Synchroniser les données​

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

Étape 4 : Synchroniser les plugins​

Étape 5 : Montée de version de la solution Centreon​

Étape 6: Mettre à jour les modules​

Étape 7: Migrer vos autres serveurs (architecture distribuée)​

Migrer un serveur distant​

Migrer un collecteur​