2 Debian/Ubuntu

Aperçu

Cette section fournit les étapes requises pour une mise à niveau réussie de Zabbix 5.4.x vers Zabbix 6.0.x en utilisant les packages Zabbix officiels pour Debian/Ubuntu.

Bien que la mise à niveau des agents Zabbix ne soit pas obligatoire (mais recommandée), le serveur Zabbix et les proxys doivent être de la même version majeure. Par conséquent, dans une configuration serveur-proxy, le serveur Zabbix et tous les proxys doivent être arrêtés et mis à niveau. Garder les proxys en cours d'exécution pendant la mise à niveau du serveur n'apportera plus aucun avantage car lors de la mise à niveau du proxy, leurs anciennes données seront supprimées et aucune nouvelle donnée ne sera collectée jusqu'à ce que la configuration du proxy soit synchronisée avec le serveur.

Notez qu'avec la base de données SQLite sur les proxys, les données d'historique des proxys avant la mise à niveau seront perdues, car la mise à niveau de la base de données SQLite n'est pas prise en charge et le fichier de base de données SQLite doit être supprimé manuellement. Lorsque le proxy est démarré pour la première fois et que le fichier de base de données SQLite est manquant, le proxy le crée automatiquement.

Selon la taille de la base de données, la mise à niveau de la base de données vers la version 6.0 peut prendre un certain temps.

Les notes de mise à niveau suivantes sont disponibles :

Vous pouvez également vérifier les exigences pour 6.0.

Procédure de mise à niveau

1 Arrêt des 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.

# service zabbix-server stop

Si vous mettez à niveau le proxy Zabbix, arrêtez également le proxy.

# service zabbix-proxy stop

2 Sauvegarde de la base de données Zabbix existante

Ceci est une étape très importante. Assurez-vous d'avoir une sauvegarde de votre base de données. Cela aidera si la procédure de mise à niveau échoue (manque d'espace disque, mise hors tension, tout problème inattendu).

3 Sauvegarde des fichiers de configuration, des fichiers PHP et des binaires Zabbix

Faites une copie de sauvegarde des fichiers binaires Zabbix, des fichiers de configuration et du répertoire de fichiers PHP.

Fichiers de configuration :

# mkdir /opt/zabbix-backup/
       # cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
       # cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/

Fichiers PHP et binaires Zabbix :

# cp -R /usr/share/zabbix/ /opt/zabbix-backup/
       # cp -R /usr/share/zabbix-* /opt/zabbix-backup/

4 Mise à jour du package de configuration du dépôt

Pour poursuivre la mise à jour, votre package de dépôt actuel doit être désinstallé.

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

Installez ensuite le nouveau package de configuration du dépôt.

Sur Debian 11 exécutez :

# wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian11_all.deb
       # dpkg -i zabbix-release_6.0-1+debian11_all.deb

Sur Debian 10 exécutez :

# wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian10_all.deb
       # dpkg -i zabbix-release_6.0-1+debian10_all.deb

Sur Debian 9 exécutez :

# wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian9_all.deb
       # dpkg -i zabbix-release_6.0-1+debian9_all.deb

Sur Ubuntu 20.04 exécutez :

# wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu20.04_all.deb
       # dpkg -i zabbix-release_6.0-1+ubuntu20.04_all.deb

Sur Ubuntu 18.04 exécutez :

# wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu18.04_all.deb
       # dpkg -i zabbix-release_6.0-1+ubuntu18.04_all.deb

Sur Ubuntu 16.04 exécutez :

# wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu16.04_all.deb
       # dpkg -i zabbix-release_6.0-1+ubuntu16.04_all.deb

Sur Ubuntu 14.04 exécutez :

# wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu14.04_all.deb
       # dpkg -i zabbix-release_6.0-1+ubuntu14.04_all.deb

Mettez à jour les informations du dépôt.

# apt-get update

5 Mise à niveau des composants Zabbix

Pour mettre à niveau les composants Zabbix, vous pouvez exécuter quelque chose comme :

# apt-get 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 l'agent Zabbix 2, remplacez zabbix-agent par zabbix-agent2dans la commande.

Ensuite, pour mettre à jour correctement l'interface Web avec Apache, exécutez également :

# apt-get install zabbix-apache-conf

Les distributions avant Debian 10 (buster) / Ubuntu 18.04 (bionic) / Raspbian 10 (buster) ne fournissent pas PHP 7.2 ou plus récent, qui est requis pour l'interface Zabbix 5.0. Voir les informations sur l'installation de l'interface Zabbix sur les anciennes distributions.

6 Exam des paramètres de configuration des composants

Consultez les notes de mise à niveau pour plus de détails sur les modifications obligatoires (le cas échéant).

Pour les nouveaux paramètres facultatifs, consultez la section Quoi de neuf.

7 Démarrage des processus Zabbix

Démarrez les composants Zabbix mis à jour.

# service zabbix-server start
       # service zabbix-proxy start
       # service zabbix-agent start
       # service zabbix-agent2 start

8 Suppression des cookies et du cache du navigateur Web

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

Mise à niveau entre les versions mineures

Il est possible de mettre à jour les versions mineures de 6.0.x (par exemple, de 6.0.1 à 6.0.3). C'est facile.

Pour mettre à jour la version mineure de Zabbix, exécutez :

$ sudo apt install --only-upgrade 'zabbix.*'

Pour mettre à niveau la version mineure du serveur Zabbix, veuillez exécuter :

$ sudo apt install --only-upgrade 'zabbix-server.*'

Pour mettre à niveau la version mineure de l'agent Zabbix, exécutez :

$ sudo apt install --only-upgrade 'zabbix-agent.*'

ou, pour l'agent Zabbix 2 :

$ sudo apt install --only-upgrade 'zabbix-agent2.*'