Migration vers un autre système

Il peut y avoir de nombreuses raisons de migrer un serveur PFMS spécifique et sa console Web, qui se trouvent généralement sur la même machine physique ou virtuelle (Environnement monolithe Pandora FMS).

Cas possibles :

  • Une nouvelle version de Pandora FMS peut nécessiter un système d'exploitation différent, par exemple, migrer de Rocky Linux 8 vers RedHat Enterprise (RHEL) 8.
  • Il peut également s'agir de migrer d'un fournisseur de services Web à un autre : Pandora FMS utilise moins de données que le fait de réaliser une image du système d'exploitation complet.
  • Dans le cas d'audits ou pour tester de nouvelles fonctionnalités, il est nécessaire d'avoir une copie du serveur principal.

Procédure

Généralement, le chemin complet vers la console Web PFMS est :

/var/www/html/pandora_console

et dans les instructions suivantes, il est abrégé en $CONSOLE_PATH.

Exportation de données

1.- Effectuer une sauvegarde de la base de données de l'ancien système. Il y a plusieurs étapes, ouvrir une fenêtre de terminal avec les droits d'administrateur (utilisateur root).

  • Faire une copie logique de la base de données avec la commande suivante :
mysqldump \
  --single-transaction \
  --max_allowed_packet=512M \
  -u root -p pandora \
  > backup_pandora_X.Y.sql
  • Le fichier résultant ci-dessus (backup_pandora_X.Y.sql) doit être compressé avec les données des points suivants afin d'avoir un seul fichier pour le déménagement.
  • backup_pandora_X.Y.tar.gz est un format compressé qui conserve les valeurs intrinsèques de chaque fichier.
  • Compresser tous les fichiers de configuration existants dans le répertoire /etc/pandora/*.conf.
  • Compresser l'ensemble du répertoire et des sous-répertoires de $CONSOLE_PATH/attachment/.
  • Les images et icônes personnalisées dans $CONSOLE_PATH/images/, s'il y en a.
  • Compresser tout le répertoire /var/spool/pandora/data_in/.

    Si vous migrez d'un serveur Ubuntu vers RHEL (ou vice versa) vous devrez ajuster les permissions des tokens user et group.

  • Compresser tous les plugins de serveur situés dans /usr/share/pandora_server/util/plugin/. Si vous avez un ou plusieurs plugins de serveur situés dans un autre répertoire ils doivent également être compressés.
  • Compresser toutes les dépendances installées sur le serveur source qui sont nécessaires au bon fonctionnement des scripts et/ou plugins installés sur le serveur source et qui ne se trouvent pas sur le serveur de destination. Les systèmes avancés devront installer complètement les environnements de développement intégrés ou environnement de développement interactif (en anglais Integrated Development Environment ou IDE).
  • Compresser tous les certificats SSL et la configuration personnalisée du serveur web Apache situés dans /etc/httpd/, au cas où un ou plusieurs de ces types de fichiers existeraient.

Vous êtes le seul responsable de la sauvegarde de vos données. Notez avec un stylo et du papier la procédure que vous choisirez pour le déplacement des données. Soyez prudent, utilisez la redondance concernant les sauvegardes et les procédures avec plusieurs personnes pour vous aider dans le processus.

Importation de données

2.- Installer le nouveau système Pandora FMS à partir de zéro, l'outil d'installation en ligne est recommandé.

3.- Fermer tous les processus en cours d'exécution sur le nouveau système, à l'exception de MySQL ; commencer par Pandora FMS (à partir de la version NG 754, il dispose d'options supplémentaires pour le démarrage et l'arrêt manuels des environnements de haute disponibilité HA) :

systemctl stop pandora_server
systemctl stop pandora_agent_daemon
systemctl stop tentacle_serverd

4.- L'arrêt du serveur Apache dépendra de la distribution utilisée :

systemctl stop apache2
systemctl stop httpd.service

5.- Ensuite, envoyer ou copier, de la manière la plus simple, le fichier backup_pandora_X.Y.tar.gz de l'ancien système vers le nouveau. Décompresser les fichiers dans leurs emplacements correspondants.

6.- Entrer dans MySQL avec l'utilisateur root. Accéder à la base de données Pandora FMS sur le nouveau système, par défaut pandora, et importer la base de données :

mysql -u root -p
USE pandora;
SOURCE ~/backup_pandora_X.Y.sql;

Ce chemin variera en fonction du répertoire où vous avez la sauvegarde de l'ancien système, ici on suppose que vous l'avez dans votre répertoire utilisateur ($HOME).

7.- Dans le cas d'une migration vers une version majeure, où la structure de la base de données change, ce serait le moment d'exécuter les scripts de migration comme indiqué dans la procédure de mise à niveau de version majeure.

8.- Si vous avez effectué un changement de distribution, gardez à l'esprit que le chemin ou PATH de la console Web a été modifié et, dans ce cas, certains champs de la base de données ont également été modifiés, tels que la table tconfig et ses champs attachment_store et fontpath. Pour modifier ces champs, vous devez entrer ces instructions (query). L'exemple concerne une migration vers Rocky Linux 8 ; dans d'autres distributions, modifiez le path du répertoire Apache.

mysql -u root -p> use pandora;
UPDATE tconfig 
  SET VALUE = '/var/www/html/pandora_console/attachment'
  WHERE token LIKE 'attachment_store';
UPDATE tconfig 
  SET VALUE = '/var/www/html/pandora_console/include/fonts/smallfont.ttf'
  WHERE token LIKE 'fontpath';

Ces PATH doivent également être pris en compte dans les fichiers de configuration du serveur et de la console (fichiers config.php et pandora_server.conf).

9.- Une fois la base de données migrée, vous devez vérifier si les fichiers …/pandora_console/include/config.php et /etc/pandora/pandora_server.conf précédents et nouveaux contiennent les mêmes données dans les champs dbname, dbuser et dbpass.

  • S'ils sont identiques, allez à l'étape numéro 10.
  • S'ils sont différents choisissez une seule des options suivantes :
  1. Option ( a ) : Remplacer les nouveaux fichiers par les anciens.
  2. Option ( b ) : Copier les données (dbname, dbuser et dbpass) des anciens fichiers vers les nouveaux.
  3. Option ( c ) : Accorder des permissions à la base de données avec les données de la nouvelle installation. En supposant que la nouvelle installation possède ces données : dbname=pandora, dbuser=pandora1 et dbpass=pandora2 :
mysql -u root -p
GRANT ALL privileges 
  ON pandora.* TO 'pandora1'@'localhost' 
  IDENTIFIED BY 'pandora2';
FLUSH privileges;

10.- Après cela, démarrer à nouveau tous les daemons et vous pourrez accéder à la console Web de Pandora FMS, avec tous les agents, modules, alertes, etc.

11.- Si l'adresse IP ou l'URL a changé sur le nouvel hôte, tous les agents locaux feront un rapport à ce nouveau système.
Pour les EndPoints, le paramètre server_ip doit être modifié dans chacun d'eux.

12.- Utiliser Opérations massives, édition d'agents, pour finaliser tout détail en attente.

←Retour à l'index de la documentation de Pandora FMS