4 Mise à niveau
Avant d’effectuer 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.
Aperçu
Des instructions de mise à niveau étape par étape sont disponibles pour ::
- Red Hat Enterprise Linux (à l'aide de paquets)
- Debian/Ubuntu (à l'aide de paquets)
- Mise à niveau à l'aide de containers
- Mise à niveau à l'aide des sources
- À l'aide de containers
Instructions associées :
- Pour les serveurs dans un cluster haute disponibilité (HA), voir Mise à niveau d'un cluster HA
- Pour la base de données TimescaleDB, voir Mise à niveau du schéma TimescaleDB
Composants à mettre à niveau
La mise à niveau des agents Zabbix est recommandée, mais n'est pas obligatoire.
La mise à niveau des proxys Zabbix est fortement recommandée. Zabbix server prend entièrement en charge les proxys de la même version majeure que le serveur. Zabbix server prend également en charge les proxys qui ne sont pas plus anciens que la version de la précédente publication LTS de Zabbix server, mais avec des fonctionnalités limitées (collecte de données, exécution de commandes distantes, vérifications immédiates des valeurs d'élément). La mise à jour de la configuration est également désactivée, et les proxys obsolètes ne fonctionneront qu'avec une ancienne configuration.
Les proxies plus anciens que la version de la précédente publication LTS de Zabbix server ou plus récents que la version majeure de Zabbix server ne sont pas pris en charge. Zabbix server ignorera les données provenant de proxies non pris en charge et toute communication avec Zabbix server échouera avec un avertissement. Pour plus d'informations, voir Compatibilité des versions.
Afin de minimiser les temps d'arrêt et les pertes de données pendant la mise à niveau, il est recommandé d'arrêter, de mettre à niveau, puis de démarrer Zabbix server, puis d'arrêter, de mettre à niveau et de démarrer les proxies Zabbix l'un après l'autre. Pendant l'arrêt de Zabbix server, les proxies en cours d'exécution continueront la collecte des données. Une fois le serveur démarré et opérationnel, les proxies obsolètes enverront les données au serveur plus récent (la configuration du proxy ne sera toutefois pas mise à jour) et resteront partiellement fonctionnels. Toutes les notifications concernant des problèmes survenus pendant l'arrêt de Zabbix server ne seront générées qu'après le démarrage du serveur mis à niveau.
Si Zabbix 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.
Notez que si Zabbix proxy 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 de Zabbix proxy est antérieure à la version du fichier de base de données, Zabbix consignera une erreur et s'arrêtera.
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 à partir des versions 2.0.x. Pour effectuer une mise à niveau depuis des versions antérieures, consultez la documentation Zabbix pour la version 2.0 et les versions précédentes.
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 | Changements les plus importants entre les versions |
|---|---|---|
| 7.4.x | Pour: Zabbix 8.0 |
Les versions minimales requises de la base de données ont été relevées. La version minimale requise de PHP a été relevée 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é abandonnée. |
| 7.0.x | Pour: Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
La prise en charge de la base de données Oracle a été abandonnée. |
| 6.4.x | Pour: Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
La version minimale requise de PHP a été relevée de 7.4.0 à 8.0.0. Interrogateurs asynchrones pour les vérifications agent, HTTP agent, SNMP walk[OID] et SNMP get[OID]. Table de base de données distincte pour les proxies. 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 (float) a été abandonné. |
| 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 a été relevée de 8.0.0 à 8.0.30. La bibliothèque 'libevent_pthreads' est requise pour le serveur/proxy Zabbix. Au premier lancement après une mise à niveau, le proxy Zabbix avec 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 a été relevée de 7.2.5 à 7.4.0. La supervision des services a été profondément 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 superutilisateur ou la définition du paramètre de variable/configuration log_bin_trust_function_creators = 1. Voir Scripts de création de base de données pour savoir comment définir la 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 de la base de données ont été relevées. Le serveur/proxy ne démarrera pas si la base de données est obsolète. Les enregistrements du journal d’audit sont 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 de la base 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 a été relevée de 7.2.0 à 7.2.5. L’algorithme de hachage des mots de passe est passé 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é abandonnée. La version minimale requise de PHP a été relevée de 5.4.0 à 7.2.0. Les versions minimales requises de la base 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 anciens proxies ne peuvent plus envoyer de données à un serveur mis à niveau. Les agents plus récents ne pourront plus fonctionner avec un ancien serveur Zabbix. |
| 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é abandonné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 passive du proxy 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 backend a été abandonnée pour le serveur/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 le drapeau 'nowait', ainsi que pour les scripts exécutés par le serveur Zabbix. Le 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 a été relevée de 5.3.0 à 5.4.0. Le paramètre 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 des 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 a été relevée 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 le classement utf8_bin sont requis pour que le serveur Zabbix fonctionne correctement avec la base de données MySQL. Voir scripts de création de base de données. L’extension PHP 'mysqli' est requise à la place de 'mysql'. |