Actualisation

Introduction

Lors de la mise à jour de Pandora FMS, il y a deux façons principales de mettre à jour l'environnement:

  • Warp Update.
  • Manuellement.

Warp Update est chargé de mettre à jour la console, le serveur et la base de données de Pandora FMS de manière automatique au moyen d'assistants. C'est l'option recommandée pour mettre à jour Pandora FMS.

Si vous devez mettre à jour Pandora FMS manuellement, vous pouvez appliquer les mises à jour manuellement, en suivant une procédure plus détaillée et plus laborieuse, mais tout aussi valable.

Warp Update

Les mises à jour via Warp Update sont divisées en deux assistants:

  • Warp Update Online: Il est responsable du téléchargement et de la mise à jour automatique du serveur, de la console et de la base de données de Pandora FMS. Il nécessite une connexion internet aux dépôts de Pandora FMS.
  • Warp Update Offline: Il est responsable de la mise à jour automatique du serveur, de la console et de la base de données de Pandora FMS. Les paquets du serveur Pandora FMS et de la console doivent être saisis manuellement dans l'assistant de la console pour effectuer la mise à jour. C'est la meilleure option pour mettre à jour dans des environnements avec des connexions restreintes et/ou limitées avec les dépôts de Pandora FMS.

Cette section ne sera visible que si vous avez activé la fonction Enable Warp Update dans le menu Management → Settings → System Settings → Advanced → Enable update manager.

Warp Update Online

Pour utiliser le Warp Update Online, accédez au menu Management → Warp Update → Update Online. Pour que cela fonctionne, la console Pandora FMS doit avoir accès aux dépôts en ligne officiels de Pandora FMS.

Pour effectuer une mise à jour via Warp Update Online, vous devez être enregistré avec une adresse e-mail.

Pour répondre aux exigences précédentes, il indiquera la version actuelle de Pandora FMS qui est installée et les nouvelles versions vers lesquelles il est possible de se mettre à niveau:

Les notes de mise à jour pour chacune des versions disponibles pour la mise à niveau seront également disponibles sur le bouton Show details.

Seules les versions LTS et/ou les versions consécutives seront affichées en fonction de la configuration warp.

Une fois que vous avez sélectionné la version à mettre à niveau, l'assistant commence à télécharger et à installer automatiquement.

Warp Update Offline

Pour utiliser la fonction Warp Offline, accédez au menu Management → Warp Update → Update Offline. Le Warp Offline ne nécessite pas de connexion internet pour effectuer les mises à jour. L'administrateur doit télécharger manuellement les paquets et les envoyer à l'assistant pour effectuer la mise à jour.

Lorsque vous accédez à cette section, vous êtes invité à saisir une adresse électronique et un code d'accès unique lié à la licence demandée s'affiche. Il doit être copié en cliquant sur le bouton . Accédez au lien indiqué pour l'ouvrir dans un nouvel onglet du navigateur web et entrez dans le référentiel. Le collage du code vous permettra de vous connecter pour télécharger les fichiers nécessaires.

Après s'être connecté, il indiquera la version de Pandora FMS installée, la prochaine version disponible et la dernière version disponible.

Lorsque vous sélectionnez la version souhaitée, une boîte de dialogue s'ouvre pour télécharger les fichiers nécessaires à la mise à niveau.

  • Fichier package_XXX_XXX.fms : Il est responsable de la mise à jour de la console et du schéma de la base de données.
  • Fichier pandorafms_server-XXXXX.tar.gz : Il est responsable de la mise à jour du serveur.
  • Fichier .sig : Signature des fichiers ci-dessus utilisée pour corroborer que le paquet n'a pas été modifié.

Une fois que les fichiers ont été téléchargés, retournez au menu Warp Update Offline et cliquez sur le bouton Browse it pour sélectionner un fichier après l'autre. Vérifiez les informations affichées à l'écran et si elles se correspondent aux mises à jour ou corrections. Pour lancer le traitement, cliquez sur l'icône verte situé dans le coin inférieur droit, attendez l'affichement des résultats de chaque traitement dans la Console Web.

La taille de chaque fichier doit être inférieure à celle spécifiée dans les paramètres token post_max_size et upload_max_filesize du fichier /etc/php.ini.

Il est recommandé de mettre à jour d'abord la console et le schéma de la base de données de Pandora FMS, puis le server. Pour terminer, vérifiez la mise à jour.

Warp Update Journal

Pour accéder au Warp Update Journal, allez dans le menu sous Management → Warp Update → Warp journal.

Il affichera un journal des mises à jour effectuées par Warp Update là où c'est indiqué:

  • Version mise à jour.
  • Type de mise à jour (serveur ou console).
  • Origine (online ou offline).
  • Utilisateur qui a effectué la mise à jour.
  • Horodatage de la mise à jour.

Warp Setup (Options)

Pour accéder à l'option Warp Setup, accédez au menu de Management → Warp Update → Options.

Différentes configurations sont disponibles pour Warp Update:

  • Limit to LTS updates (offline et online): Cela permet de mettre à jour uniquement les versions LTS (Long Term Support), qui sont des versions bénéficiant d'un support prolongé et plus stables.
  • Allow no-consecutive patches (uniquement offline) : Compte tenu du token précédent, cette option permet d'installer des mises à jour de versions non consécutives. Elle est désactivée par défaut et constitue l'option recommandée.

Il est recommandé de contacter le service d'assistance avant de modifier l'un des champs suivants:

  • Warp Update URL.
  • Use secured Warp Update.
  • Proxy server.
  • Proxy port.
  • Proxy user.
  • Proxy password.

Mise à jour du manuel

Si vous choisissez de mettre à jour Pandora FMS sans Warp Update, vous devrez effectuer une mise à jour manuelle, en intervenant dans chaque composant du système. Cette approche permet de superviser chaque étape du processus, en exécutant les étapes nécessaires individuellement. Il s'agit d'un processus qui exige toute l'attention et le contrôle de l'utilisateur.

Lors de la mise à jour manuelle de Pandora FMS, il est important de tenir compte de l'ordre correct de mise à jour de Pandora FMS :

  • Console Web.
  • Schéma de la base de données.
  • Serveur.

Pour effectuer la mise à jour de ces composants, vous devez disposer du paquet .tar.gz du serveur et .fms de la Console, de la version souhaitée de Pandora FMS à mettre à jour.

Pour télécharger ces paquets, voir Warp Update Offline, qui explique comment télécharger ces paquets.

Il est fortement recommandé d'effectuer un snapshot ou backup de la machine Pandora FMS complète, ou à défaut une sauvegarde de tous les composants de PFMS avant d'effectuer toute intervention, afin qu'en cas de défaillance, l'application puisse être restaurée de manière simple.

Pour effectuer la mise à jour complète de Pandora FMS, connectez-vous au terminal du serveur Pandora FMS avec l'utilisateur root. Cette procédure est compatible avec les systèmes EL 7, EL 8, EL 9 et Ubuntu 22.04 LTS.

Mise à jour de la console

Le fichier package_XXX.XXX.fms est déplacé vers le chemin de la Console:

mv package_XXX.XXX.fms /var/www/html/pandora_console/

Nous modifions le répertoire de travail:

cd /var/www/html/pandora_console/

Décompressez le fichier package_XXX.XXX.fms:

unzip package_XXX.XXX.fms

Lorsque vous l'exécutez, il vous sera demandé quelle action effectuer pour les fichiers à remplacer, dans ce cas vous devez sélectionner A:

replace .gitignore? [y]es, [n]o, [A]ll, [N]one, [r]ename: A

La version de la console dans la base de données est mise à jour, en remplaçant par XXX la version de Pandora FMS vers laquelle elle a été mise à jour:

mysql -u root -p -D pandora -e "UPDATE tconfig SET value=XXX WHERE token='current_package'"

Mise à jour du schéma de la base de données

Pour mettre à jour le schéma de la base de données de Pandora FMS, exécutez manuellement le script pour mettre à jour le MR:

/usr/bin/php /var/www/html/pandora_console/godmode/um_client/updateMR.php

Mise à jour du serveur

Décompressez le tar.gz du serveur Pandora FMS pandorafms_server-XXXXX.tar.gz:

tar -xzvf pandorafms_server-XXXXX.tar.gz

Le dossier décompressé est accessible:

cd pandora_server/

Le programme d'installation est exécuté:

./pandora_server_installer --install

Le serveur Pandora FMS est redémarré:

systemctl restart pandora_server

Vérification de la mise à jour

Accédez à la section Management → About de la console Pandora FMS. Vous pourrez y visualiser correctement la version de la console dans Information → Current Package et du schéma de la base de données dans MR:

Accédez à la section Management → Servers → Manage Server à partir de la console Pandora FMS. Affichez la version correcte du serveur dans la colonne Version de tous les serveurs.

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