Mise à niveau

Avant de procéder à la mise à niveau, il est fortement recommandé de consulter toutes les notes de mise à niveau pertinentes.

Il sera également utile de savoir quels composants vous devez mettre à niveau.

Vue d’ensemble

Des instructions de mise à niveau détaillées sont disponibles pour :

Instructions associées :

Composants à mettre à niveau

La mise à niveau des agents Zabbix est recommandée, mais pas obligatoire.

La mise à niveau des proxies Zabbix est fortement recommandée. Le serveur Zabbix prend entièrement en charge les proxies qui utilisent la même version majeure que le serveur. Le serveur Zabbix prend également en charge les proxies qui ne sont pas antérieurs à la version LTS précédente du serveur Zabbix, mais avec des fonctionnalités limitées (collecte de données, exécution de commandes à distance, vérifications immédiates de la valeur des éléments). La mise à jour de la configuration est également désactivée, et les proxies obsolètes ne fonctionneront qu'avec l'ancienne configuration.

Les proxy dont la version est antérieure à celle de la précédente version LTS du serveur Zabbix ou ultérieure à la version majeure du serveur Zabbix ne sont pas pris en charge. Le serveur Zabbix ignorera les données provenant des proxy non pris en charge et toute communication avec le serveur Zabbix échouera avec un avertissement. Pour plus d’informations, consultez Compatibilité des versions.

Pour réduire au minimum les temps d’arrêt et les pertes de données pendant la mise à niveau, il est recommandé d’arrêter, de mettre à niveau et de démarrer le serveur Zabbix, puis d’arrêter, de mettre à niveau et de démarrer les proxy l’un après l’autre. Pendant l’arrêt du serveur, les proxy en fonctionnement continueront à collecter les données. Une fois le serveur opérationnel, les proxy obsolètes enverront les données au serveur plus récent (la configuration des proxy ne sera toutefois pas mise à jour) et resteront partiellement fonctionnels. Les notifications relatives aux problèmes survenus pendant l’arrêt du serveur Zabbix seront générées uniquement après le démarrage du serveur mis à niveau.

Si le proxy Zabbix est démarré pour la première fois et que le fichier de base de données SQLite est absent, le proxy le crée automatiquement.

Notez que si le proxy Zabbix utilise SQLite3 et détecte au démarrage que la version du fichier de base de données existant est antérieure à celle requise, il supprimera automatiquement le fichier de base de données et en créera un nouveau. Par conséquent, les données d’historique stockées dans le fichier de base de données SQLite seront perdues. Si la version du proxy Zabbix est antérieure à celle du fichier de base de données, Zabbix consignera une erreur et quittera.

Selon la taille de la base de données, la mise à niveau de la base de données vers la version 8.0 peut prendre beaucoup de temps.

Notes de mise à niveau

La mise à niveau directe vers Zabbix 8.0.x est prise en charge depuis les versions 2.0.x. Pour effectuer une mise à niveau depuis des versions antérieures, consultez la documentation Zabbix relative à la version 2.0 et aux versions antérieures.

Veuillez noter qu'après la mise à niveau, certaines intégrations de logiciels tiers dans Zabbix peuvent être affectées si le logiciel externe n'est pas compatible avec la version mise à niveau de Zabbix.

Les notes de mise à niveau suivantes sont disponibles :

Mise à niveau depuis Lire les notes complètes de mise à niveau Modifications les plus importantes entre les versions
7.4.x Pour :
Zabbix 8.0		 Les agents Zabbix antérieurs à la version 1.6 ne sont plus pris en charge.
Les versions minimales requises des bases de données ont été relevées.
La version minimale requise de PHP passe de 8.0.0 à 8.2.0.
Le caractère % a été ajouté à la liste UnsafeUserParameters pour Zabbix agent et Zabbix agent 2.
7.2.x Pour :
Zabbix 7.4
Zabbix 8.0		 La prise en charge de la bibliothèque PCRE a été supprimée.
7.0.x Pour :
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0		 La prise en charge d’Oracle DB a été supprimée.
6.4.x Pour :
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0		 La version minimale requise de PHP passe de 7.4.0 à 8.0.0.
Interrogateurs asynchrones pour les vérifications agent, agent HTTP, SNMP walk[OID] et SNMP get[OID].
Table de base de données distincte pour les proxy.
L’emplacement par défaut du fichier de configuration de l’agent Windows a été modifié.
Oracle DB est obsolète.
L’ancien type de valeur numérique (flottante) a été supprimé.
6.2.x Pour :
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0		 La version minimale requise de MySQL passe de 8.0.0 à 8.0.30.
La bibliothèque 'libevent_pthreads' est requise pour le serveur/proxy Zabbix.
Lors du premier démarrage après une mise à niveau, le proxy Zabbix utilisant SQLite3 supprime automatiquement l’ancienne version de la base de données (avec tout l’historique) et en crée une nouvelle.
6.0.x LTS Pour :
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0		 La version minimale requise de PHP passe de 7.2.5 à 7.4.0.
La supervision des services a été considérablement remaniée.
Les déclencheurs déterministes doivent être créés pendant la mise à niveau. Si la journalisation binaire est activée pour MySQL/MariaDB, cela nécessite des privilèges de superutilisateur ou la définition de la variable/du paramètre de configuration log_bin_trust_function_creators = 1. Consultez Scripts de création de la base de données pour savoir comment définir cette variable.
5.4.x Pour :
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0		 Les versions minimales requises des bases de données ont été relevées.
Le serveur/proxy ne démarre pas si la base de données est obsolète.
Des enregistrements du journal d’audit ont été perdus en raison d’une modification de la structure de la base de données.
5.2.x Pour :
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0		 Les versions minimales requises des bases de données ont été relevées.
Les éléments agrégés ont été supprimés en tant que type distinct.
5.0.x LTS Pour :
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0		 La version minimale requise de PHP passe de 7.2.0 à 7.2.5.
L’algorithme de hachage des mots de passe passe de MD5 à bcrypt.
4.4.x Pour :
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0		 La prise en charge d’IBM DB2 a été supprimée.
La version minimale requise de PHP passe de 5.4.0 à 7.2.0.
Les versions minimales requises des bases de données ont été relevées.
Le répertoire des fichiers PHP de Zabbix a été modifié.
4.2.x Pour :
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0		 Les types de média Jabber et Ez Texting ont été supprimés.
4.0.x LTS Pour :
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0		 Les proxy plus anciens ne peuvent plus transmettre de données à un serveur mis à niveau.
Les agents plus récents ne peuvent plus fonctionner avec un serveur Zabbix plus ancien.
3.4.x Pour :
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0		 Les bibliothèques 'libpthread' et 'zlib' sont désormais obligatoires.
La prise en charge du protocole en texte brut a été supprimée et l’en-tête est obligatoire.
Les agents Zabbix antérieurs à la version 1.4 ne sont plus pris en charge.
Le paramètre Server dans la configuration d’un proxy passif est désormais obligatoire.
3.2.x Pour :
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0		 La prise en charge de SQLite comme base de données principale a été supprimée pour le serveur/l’interface Zabbix.
Les expressions régulières compatibles Perl (PCRE) sont prises en charge à la place des expressions étendues POSIX.
Les bibliothèques 'libpcre' et 'libevent' sont obligatoires pour le serveur Zabbix.
Des vérifications du code de sortie ont été ajoutées pour les paramètres utilisateur, les commandes distantes et les éléments system.run[] sans l’indicateur 'nowait', ainsi que pour les scripts exécutés par le serveur Zabbix.
Java gateway Zabbix doit être mis à niveau pour prendre en charge les nouvelles fonctionnalités.
3.0.x LTS Pour :
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0		 La mise à niveau de la base de données peut être lente, selon la taille de la table d’historique.
2.4.x Pour :
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0		 La version minimale requise de PHP passe de 5.3.0 à 5.4.0.
Le paramètre d’agent LogFile doit être spécifié.
2.2.x LTS Pour :
Zabbix 2.4
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0		 La supervision distribuée basée sur les nœuds a été supprimée.
2.0.x Pour :
Zabbix 2.2
Zabbix 2.4
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0		 La version minimale requise de PHP passe de 5.1.6 à 5.3.0.
Une base de données MySQL sensible à la casse est requise pour le bon fonctionnement du serveur ; le jeu de caractères utf8 et la collation utf8_bin sont requis pour que le serveur Zabbix fonctionne correctement avec une base de données MySQL. Consultez les scripts de création de la base de données.
L’extension PHP 'mysqli' est requise à la place de 'mysql'.