Red Hat Enterprise Linux

Aperçu

Cette section fournit des instructions pour effectuer la mise à niveau de Zabbix 7.4.x vers la dernière version de Zabbix 8.0.x à l’aide des paquets officiels Zabbix pour Red Hat Enterprise Linux ou ses dérivés - AlmaLinux, CentOS Stream, Oracle Linux et Rocky Linux.

Avant la mise à niveau, veuillez consulter les notes de mise à niveau correspondantes et vous assurer que votre système répond aux exigences de Zabbix 8.0.

Envisagez d’exécuter deux sessions SSH parallèles pendant la mise à niveau : l’une pour exécuter les étapes de mise à niveau et l’autre pour surveiller les journaux du serveur/proxy. Par exemple, exécutez tail -f zabbix_server.log ou tail -f zabbix_proxy.log dans la seconde session afin d’afficher les dernières entrées du journal et les erreurs éventuelles en temps réel. Cela peut être essentiel pour les instances de production.

Pour obtenir des instructions sur la mise à niveau entre les versions mineures de Zabbix 8.0.x (par exemple, de 8.0.1 à 8.0.3), consultez Mise à niveau entre versions mineures.

Procédure de mise à niveau

1 Arrêter les processus Zabbix

Arrêtez le serveur Zabbix pour vous assurer qu’aucune nouvelle donnée n’est insérée dans la base de données :

systemctl stop zabbix-server

Si vous mettez à niveau Zabbix proxy, l’agent ou agent 2, arrêtez également ces composants :

systemctl stop zabbix-proxy
systemctl stop zabbix-agent
systemctl stop zabbix-agent2
2 Sauvegarder la base de données Zabbix

Sauvegardez votre base de données Zabbix existante afin de vous prémunir contre les échecs de mise à niveau (par exemple, des problèmes d’espace disque, une panne de courant ou des problèmes inattendus).

3 Sauvegarder les fichiers de configuration de Zabbix, les fichiers PHP et les binaires Zabbix

Sauvegardez les fichiers de configuration Zabbix existants, les fichiers PHP et les binaires Zabbix.

Pour les fichiers de configuration, exécutez :

mkdir /opt/zabbix-backup/
cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
cp /etc/httpd/conf.d/zabbix.conf  /opt/zabbix-backup/

Pour les fichiers PHP et les binaires Zabbix, exécutez :

cp -R /usr/share/zabbix/ /opt/zabbix-backup/
cp -R /usr/share/zabbix-* /opt/zabbix-backup/
4 Mettre à jour le paquet de configuration du dépôt

Avant de procéder à la mise à niveau, mettez à jour votre paquet de dépôt actuel vers la dernière version afin d’assurer la compatibilité avec les paquets les plus récents et d’inclure les derniers correctifs de sécurité ou de bogues.

Sur RHEL 10, exécutez :

rpm -Uvh https://repo.zabbix.com/zabbix/8.0/release/rhel/10/noarch/zabbix-release-latest.el10.noarch.rpm

Sur RHEL 9, exécutez :

rpm -Uvh https://repo.zabbix.com/zabbix/8.0/release/rhel/9/noarch/zabbix-release-latest.el9.noarch.rpm

Pour les anciennes versions de RHEL ou ses dérivés, remplacez le lien ci-dessus par le lien approprié depuis le dépôt Zabbix. Notez toutefois que les paquets pour ces versions peuvent ne pas inclure tous les composants Zabbix et que, pour mettre à niveau ces composants à partir de paquets, il convient d’envisager une mise à niveau de votre système d’exploitation. Pour obtenir la liste des composants inclus, consultez Paquets Zabbix.

Ensuite, nettoyez le cache du gestionnaire de paquets dnf (y compris les en-têtes, les métadonnées et les fichiers de paquets téléchargés lors des installations ou mises à jour précédentes) :

dnf clean all

Lors de la prochaine opération dnf, dnf téléchargera de nouvelles métadonnées depuis les dépôts, puisque les anciennes métadonnées auront été supprimées.

Voir aussi : Problèmes connus pour la mise à jour du paquet de configuration du dépôt sur RHEL.

5 Mettre à niveau les composants Zabbix

Pour mettre à niveau les composants Zabbix, exécutez :

dnf install zabbix-server-mysql zabbix-web-mysql zabbix-agent
  • Si vous utilisez PostgreSQL, remplacez mysql par pgsql dans la commande.
  • Si vous mettez à niveau le proxy, remplacez server par proxy dans la commande.
  • Si vous mettez à niveau l’agent 2, remplacez zabbix-agent par zabbix-agent2 zabbix-agent2-plugin-* dans la commande.

La mise à niveau de Zabbix agent 2 avec la commande dnf install zabbix-agent2 peut entraîner une erreur. Pour plus d’informations, consultez Problèmes connus.

Ensuite, pour mettre à niveau le frontend Zabbix avec Apache et redémarrer Apache, exécutez :

dnf install zabbix-apache-conf
systemctl restart httpd
6 Vérifier les paramètres de configuration des composants

Consultez les notes de mise à niveau pertinentes pour vérifier si des modifications des paramètres de configuration sont nécessaires.

Pour les nouveaux paramètres facultatifs, consultez la page Nouveautés.

7 Démarrer les processus Zabbix

Démarrez les composants Zabbix mis à niveau :

systemctl start zabbix-server
systemctl start zabbix-proxy
systemctl start zabbix-agent
systemctl start zabbix-agent2
8 Effacer les cookies et le cache du navigateur web

Après la mise à niveau, vous devrez peut-être effacer les cookies et le cache du navigateur web pour que l’interface web de Zabbix fonctionne correctement.

Mise à niveau entre versions mineures

Il est possible d’effectuer une mise à niveau entre les versions mineures 8.0.x de Zabbix (par exemple, de 8.0.1 à 8.0.3).

Pour mettre à niveau tous les composants Zabbix, exécutez :

dnf upgrade 'zabbix-*'
  • Pour mettre à niveau uniquement le serveur Zabbix, remplacez 'zabbix-*' par 'zabbix-server-*' dans la commande.
  • Pour mettre à niveau uniquement le proxy Zabbix, remplacez 'zabbix-*' par 'zabbix-proxy-*' dans la commande.
  • Pour mettre à niveau uniquement l’agent Zabbix, remplacez 'zabbix-*' par 'zabbix-agent-*' dans la commande.
  • Pour mettre à niveau uniquement l’agent Zabbix 2, remplacez 'zabbix-*' par 'zabbix-agent2-*' dans la commande.