This is a translation of the original English documentation page. Help us make it better.

1 Red Hat Enterprise Linux

Overview

This section provides the steps required for a successful upgrade from Zabbix 6.0.x to Zabbix 6.2.x using official Zabbix packages for Red Hat Enterprise Linux.

Before the upgrade make sure to read the relevant upgrade notes!

You may also want to check the requirements for 6.2.

It may be handy to run two parallel SSH sessions during the upgrade, executing the upgrade steps in one and monitoring the server/proxy logs in another. For example, run tail -f zabbix_server.log or tail -f zabbix_proxy.log in the second SSH session showing you the latest log file entries and possible errors in real time. This can be critical for production instances.

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.

# systemctl stop zabbix-server

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

# systemctl start zabbix-server

Il n'est plus possible de démarrer le serveur mis à niveau et de faire en sorte que des proxys plus anciens, mais non mis à niveau, transmettent des données à un serveur plus récent. Cette approche, qui n'a jamais été recommandée ni prise en charge par Zabbix, est désormais officiellement désactivée, car le serveur ignorera les données des proxys non mis à niveau.

2 Sauvegarder 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 Sauvegarder les fichiers de configuration, les fichiers PHP et les binaires Zabbix

Faites une copie de sauvegarde des 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/httpd/conf.d/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 Update repository configuration package

To proceed with the upgrade your current repository package has to be updated.

# rpm -Uvh https://repo.zabbix.com/zabbix/6.2/rhel/8/x86_64/zabbix-release-6.2-1.el8.noarch.rpm
5 Mettre à niveau les composants Zabbix

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

# dnf upgrade 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 dans la commande.

Pour mettre à niveau correctement l'interface Web avec Apache sur RHEL 8, exécutez également :

# dnf install zabbix-apache-conf
6 Examen des paramètres de configuration des composants

Assurez-vous de consulter les Notes de mise à jour pour vérifier si des modifications des paramètres de configuration sont nécessaires.

7 Démarrer les processus Zabbix

Démarrez les composants Zabbix mis à jour.

# 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 du navigateur Web et le cache du navigateur Web pour que l'interface Web de Zabbix fonctionne correctement.

Upgrade between minor versions

It is possible to upgrade between minor versions of 6.2.x (for example, from 6.2.1 to 6.2.3). Upgrading between minor versions is easy.

To execute Zabbix minor version upgrade it is required to run:

$ sudo yum upgrade 'zabbix-*'

To execute Zabbix server minor version upgrade run:

$ sudo yum upgrade 'zabbix-server-*'

To execute Zabbix agent minor version upgrade run:

$ sudo yum upgrade 'zabbix-agent-*'

or, for Zabbix agent 2:

$ sudo yum upgrade 'zabbix-agent2-*'

Note that you may also use 'update' instead of 'upgrade' in these commands. While 'upgrade' will delete obsolete packages, 'update' will preserve them.