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 conteneurs
- Mise à niveau à l’aide des sources
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 de mise à niveau complètes | Principaux changements entre les versions |
|---|---|---|
| 7.4.x | Pour : Zabbix 8.0 |
Versions minimales requises des bases de données relevées. Version minimale requise de PHP 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 d'Oracle DB a été abandonnée. |
| 6.4.x | Pour : Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Version minimale requise de PHP relevée de 7.4.0 à 8.0.0. Pollers asynchrones pour les vérifications agent, agent HTTP et SNMP walk[oid]. Table de base de données distincte pour les proxies. Emplacement par défaut du fichier de configuration de l'agent Windows modifié. Oracle DB obsolète. Ancien type de valeur numérique (float) supprimé. |
| 6.2.x | Pour : Zabbix 6.4 Zabbix 7.0 Zabbix 7.2 Zabbix 7.4 Zabbix 8.0 |
Version minimale requise de MySQL relevée 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, Zabbix proxy 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 |
Version minimale requise de PHP relevée de 7.2.5 à 7.4.0. La supervision des services a été considérablement remaniée. Des 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. Voir Database creation scripts 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 |
Versions minimales requises des bases de données relevées. Le serveur/proxy ne démarrera pas si la base de données est obsolète. Enregistrements du journal d'audit perdus en raison d'un changement de 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 |
Versions minimales requises des bases de données 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 |
Version minimale requise de PHP relevée de 7.2.0 à 7.2.5. L'algorithme de hachage des mots de passe a été remplacé de MD5 par 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. Version minimale requise de PHP relevée de 5.4.0 à 7.2.0. Versions minimales requises des bases de données relevées. Répertoire des fichiers PHP de Zabbix 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 proxies plus anciens ne peuvent plus signaler 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 de version antérieure à 1.4 ne sont plus pris en charge. Le paramètre Server dans la configuration du 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 backend a été abandonnée pour le serveur/frontend 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. Le Java gateway Zabbix doit être mis à niveau pour prendre en charge la nouvelle fonctionnalité. |
| 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 |
Version minimale requise de PHP relevée 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 |
Version minimale requise de PHP 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 une base de données MySQL. Voir database creation scripts. L'extension PHP 'mysqli' est requise à la place de 'mysql'. |