Version: 23.04

Migration depuis une plateforme Centreon 3.4

Prérequis

Cette procédure ne s'applique que pour une plate-forme Centreon 3.4, installée sur une distribution GNU/Linux 64 bits et disposant des prérequis suivants :

Composants	Version
Centreon Web	2.8.x
Centreon Broker	3.0.x
Centreon Engine	1.8.x

Migration

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 plate-forme disposant du système de redondance Centreon, il est nécessaire de contacter votre support Centreon.

En cas de migration d'une plate-forme disposant du module Centreon Poller Display 1.6.x, référez-vous à la procédure de migration.

Installation du nouveau serveur central

Réalisez les actions suivantes :

Installez un nouveau serveur Centreon à partir des paquets jusqu'à terminer le processus d'installation en vous connectant à l'interface web.
Réalisez les mises à jour logicielle et système :

Alma / RHEL / Oracle Linux 8
Alma / RHEL / Oracle Linux 9
Debian 11

dnf update

dnf update

apt update

Il est préférable de saisir le même mot de passe pour l'utilisateur 'centreon' lors du processus d'installation web.

Synchronisation des données

Connectez-vous à votre ancien serveur Centreon et synchronisez les répertoires suivants :

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 /var/spool/centreon/.ssh root@<IP_NOUVEAU_CENTREON>:/var/spool/centreon
rsync -avz /usr/share/centreon/www/img/media root@<IP_NEW_CENTREON>:/usr/share/centreon/www/img

Remplacez <IP_NOUVEAU_CENTREON> par l'adresse IP de votre nouveau serveur Centreon.

Récupération des bases de données

Faire un dump des bases de données sources :

mysqldump -u root -p centreon > /tmp/centreon.sql
mysqldump -u root -p centreon_storage > /tmp/centreon_storage.sql

Arreter le serveur MariaDB source :
```
 service mysqld stop
```

Transférer les exports vers le nouveau serveur de base de données Centreon 23.04 :

```shell
rsync -avz /tmp/centreon.sql root@<IP_NOUVEAU_CENTREON>:/tmp/
rsync -avz /tmp/centreon_storage.sql root@<IP_NOUVEAU_CENTREON>:/tmp/
```

Sur le serveur de base de données Centreon 23.04, supprimer les bases de données vierges et les recréer :

```shell
mysql -u root -p
```

```SQL
DROP DATABASE centreon;
DROP DATABASE centreon_storage;
CREATE DATABASE centreon;
CREATE DATABASE centreon_storage;
```

Importer les dumps :

mysql -u root centreon -p </tmp/centreon.sql
mysql -u root centreon_storage -p </tmp/centreon_storage.sql

Executer 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émarrer le processus mariadb sur le nouveau serveur :
```
systemctl start mariadb
```

Remplacez <IP_NOUVEAU_CENTREON> par l'adresse IP de votre nouveau serveur Centreon.

Synchronisation des plugins

La synchronisation des sondes de supervision (plugins) est plus délicate et dépend de votre installation. Les principaux répertoires à synchroniser sont :

/usr/lib/nagios/plugins/
/usr/lib/centreon/plugins/

Il est important d'installer les dépendances nécessaires au fonctionnement des sondes de supervision.

Si vous avez des Pollers en Centreon Engine 1.8.1 que vous comptez migrer plus tard en 23.04, attention au dossier des plugins Nagios. La macro de ressource $USER1$ de Centreon 23.04 pointe sur /usr/lib64/nagios/plugins
A éxécuter sur vos collecteurs en Centreon Engine 1.8.1 :
mv /usr/lib64/nagios/plugins/* /usr/lib/nagios/plugins/
rmdir /usr/lib64/nagios/plugins/
ln -s -t /usr/lib64/nagios/ /usr/lib/nagios/plugins/
De cette façon un lien symbolique est créé :
$ ls -alt /usr/lib64/nagios/
lrwxrwxrwx   1 root root      24  1 nov.  17:59 plugins -> /usr/lib/nagios/plugins/
-rwxr-xr-x   1 root root 1711288  6 avril  2018 cbmod.so

Vous pouvez générer les configurations depuis Centreon 23.04 indifféremment vers un collecteur en 23.04 ou 1.8.1.

Montée de version de la solution Centreon

Forcez la montée de version du nouveau serveur en déplacant le contenu du répertoire /var/lib/centreon/installs/install-23.04.0-YYYYMMDD_HHMMSS dans le répertoire /usr/share/centreon/www/install :

cd /var/lib/centreon/installs/
mv install-23.04.0-YYYYMMDD_HHMMSS/ /usr/share/centreon/www/install/

Si vous utilisez la même adresse IP ou le même nom DNS entre l'ancien serveur web Centreon et le nouveau, videz completement le cache de votre navigateur pour éviter des problemes de scripts JS.

Se connecter à l'URL http://<IP_NEW_CENTREON>/centreon et suivre les étapes de 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,
Éditer la configuration du Centreon Broker central, via l'interface web Centreon et modifier le mot de passe pour les deux output broker Perfdata generator et Broker SQL database,
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.

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@"

Puis générez la configuration de l'ensemble de la plateforme et exportez là.

Mise à jour des modules

Référez-vous à la documentation des modules installés afin de connaître leur compatibilité avec Centreon 23.04, et pour mettre à jour ces derniers.

Migrer vos autres serveurs

Assurez-vous que tous les serveurs de votre architecture (serveur central, serveurs distants et collecteurs) ont la même version majeure de Centreon.

Prérequis​

Migration​

Installation du nouveau serveur central​

Synchronisation des données​

Récupération des bases de données​

Synchronisation des plugins​

Montée de version de la solution Centreon​

Mise à jour des modules​

Migrer vos autres serveurs​