Debian/Ubuntu

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 Debian/Ubuntu.

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 pour afficher en temps réel les dernières entrées du journal et les erreurs éventuelles. 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 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/apache2/conf-enabled/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, désinstallez votre paquet de dépôt Zabbix actuel :

rm -Rf /etc/apt/sources.list.d/zabbix.list

Il se peut également que vous deviez supprimer manuellement les anciens paquets Zabbix de votre répertoire de travail (par exemple, rm zabbix-release_latest+debian12_all.deb) avant de télécharger le nouveau, afin d’empêcher le gestionnaire de paquets de réutiliser une version obsolète pendant le processus de mise à niveau.

Ensuite, installez le dernier paquet de configuration du dépôt afin de garantir la compatibilité avec les paquets les plus récents et d’inclure les derniers correctifs de sécurité ou de bogues.

Sur Debian 12, exécutez :

wget https://repo.zabbix.com/zabbix/8.0/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
dpkg -i zabbix-release_latest+debian12_all.deb

Pour les anciennes versions de Debian, remplacez le lien ci-dessus par le lien correct 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 des paquets, vous devriez envisager de mettre à niveau votre OS. Pour obtenir la liste des composants inclus, consultez Paquets Zabbix.

Sur Ubuntu 24.04, exécutez :

wget https://repo.zabbix.com/zabbix/8.0/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb
dpkg -i zabbix-release_latest+ubuntu24.04_all.deb

Sur Ubuntu 22.04, exécutez :

wget https://repo.zabbix.com/zabbix/8.0/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb
dpkg -i zabbix-release_latest+ubuntu22.04_all.deb

Pour les anciennes versions d’Ubuntu, remplacez le lien ci-dessus par le lien correct 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 des paquets, vous devriez envisager de mettre à niveau votre OS. Pour obtenir la liste des composants inclus, consultez Paquets Zabbix.

Vous pouvez voir une invite concernant la configuration du dépôt Zabbix :

Configuration file '/etc/apt/sources.list.d/zabbix.list'
==> Supprimé (par vous ou par un script) depuis l'installation.
==> Le distributeur du paquet a fourni une version mise à jour.
Que souhaitez-vous faire à ce sujet ? Vos options sont :
Y or I  : installer la version du responsable du paquet
N or O  : conserver votre version actuellement installée
D       : afficher les différences entre les versions
Z       : démarrer un shell pour examiner la situation
L'action par défaut est de conserver votre version actuelle.
*** zabbix.list (Y/I/N/O/D/Z) [default=N] ?

Saisissez Y (ou I) pour installer la version du responsable du paquet pour la configuration du dépôt Zabbix.

Ensuite, mettez à jour les informations du dépôt :

apt update
5 Mettre à niveau les composants Zabbix

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

apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php 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 Zabbix agent 2, remplacez zabbix-agent par zabbix-agent2 zabbix-agent2-plugin-* dans la commande.

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

Vous pouvez voir une invite concernant la configuration du serveur Zabbix (ou du proxy) :

Configuration file '/etc/zabbix/zabbix_server.conf'
==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ?  Your options are:
Y or I  : install the package maintainer's version
N or O  : keep your currently-installed version
D       : show the differences between the versions
Z       : start a shell to examine the situation
The default action is to keep your current version.
*** zabbix_server.conf (Y/I/N/O/D/Z) [default=N] ?

Saisissez l’option qui correspond le mieux à votre situation. Par exemple, saisissez D pour comparer la configuration actuelle et la nouvelle, puis décidez si vous souhaitez installer la version du responsable du paquet (Y ou I).

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

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

Consultez les notes de mise à niveau correspondantes 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).

Tout d’abord, mettez à jour les informations du dépôt :

apt update

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

apt install --only-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.