Documentation
Table of Contents
- Mise à jour depuis les sources
- Aperçu
- Procédure de mise à jour du serveur
- 1 Arrêt du serveur Zabbix
- 2 Sauvegarde de la base de données Zabbix existante
- 3 Sauvegarde des fichiers de configuration, des fichiers PHP et des binaires Zabbix
- 4 Installation des nouveaux binaires du serveur
- 5 Exam des paramètres de configuration du serveur
- 6 Démarrer les nouveaux binaires Zabbix
- 7 Installation de la nouvelle interface Web Zabbix
- 8 Effacer les cookies et le cache du navigateur
- Procédure de mise à jour du Proxy
- Processus de mise à niveau de l'agent
- Mise à niveau entre les versions mineures
Mise à jour depuis les sources
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 sources Zabbix officielles.
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.
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.
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. ::: notewarning Avant la mise à niveau, assurez-vous de lire les notes de mise à niveau pertinentes ! :::
Les notes de mise à niveau suivantes sont disponibles :
| Mise à niveau depuis | Lire les notes de mise à niveau complètes | Modifications les plus importantes entre les versions |
|---|---|---|
| 5.4.x | Pour : Zabbix 6.0 |
Versions minimales requises de la base de données augmentées ; Le serveur/proxy ne démarre 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 |
Versions de base de données minimales requises augmentées ; Éléments agrégés supprimés en tant que type distinct. |
| 5.0.x LTS | Pour : Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
La version PHP minimale requise est passée de 7.2.0 à 7.2.5. |
| 4.4.x | Pour : Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
La prise en charge d'IBM DB2 a été abandonnée ; La version PHP minimale requise est passée de 5.4.0 à 7.2.0 ; Les versions de base de données minimales requises ont été augmentées ; Le répertoire de 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 |
Suppression des types de médias Jabber, Ez Texting. |
| 4.0.x LTS | Pour : Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Les anciens proxys ne peuvent plus transmettre de données à un serveur mis à niveau ; Les nouveaux agents ne pourront plus travailler 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 |
Les bibliothèques 'libpthread' et 'zlib' sont désormais obligatoires ; La prise en charge du protocole de texte brut a été abandonnée et l'en-tête est obligatoire ; Les agents Zabbix de la 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 |
Prise en charge de SQLite en tant que base de données principale abandonnée pour le serveur/frontend Zabbix ; Expressions régulières compatibles Perl (PCRE) prises en charge au lieu de POSIX étendu ; Bibliothèques 'libpcre' et 'libevent' obligatoires pour le serveur Zabbix ; Vérifications du code de sortie ajouté pour les paramètres utilisateur, les commandes à distance et les éléments system.run[] sans le drapeau 'nowait' ainsi que les scripts exécutés par le serveur Zabbix ; La passerelle Java Zabbix doit être mise à 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 |
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 |
Version PHP minimale requise passée de 5.3.0 à 5.4.0 ; Le paramètre de l'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 |
Suppression de la surveillance distribuée basée sur les nœuds. |
| 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 |
Version PHP minimale requise passée de 5.1.6 à 5.3.0 ; Base de données MySQL sensible à la casse 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 les scripts de création de base de données ; Extension PHP 'mysqli' requise au lieu de 'mysql'. |
Vous pouvez également vérifier les exigences pour 6.0.
Il peut être pratique d'exécuter deux sessions SSH parallèles pendant la mise à niveau, en exécutant les étapes de mise à niveau dans une et en surveillant les journaux du serveur/proxy dans une autre. Par exemple, exécutez tail -f zabbix_server.log ou tail -f zabbix_proxy.log dans la deuxième session SSH pour afficher les dernières entrées du fichier journal et les erreurs possibles en temps réel. Cela peut être critique pour les instances de production.
Procédure de mise à jour du serveur
1 Arrêt du serveur Zabbix
Arrêter le serveur Zabbix pour être sûr qu’aucune nouvelle donnée ne soit insérée en base de données.
2 Sauvegarde de la base de données Zabbix existante
Il s’agit d’une étape très importante. Vérifiez que vous disposez d’une sauvegarde de votre base de données. Cela aidera si la procédure de mise à jour échoue (manque d’espace disque, arrêt inopiné ou tout autre problème imprévu).
3 Sauvegarde des fichiers de configuration, des fichiers PHP et des binaires Zabbix
Faites une copie de sauvegarde des binaires Zabbix, des fichiers de configuration et du répertoire des fichiers PHP.
4 Installation des nouveaux binaires du serveur
Utilisez les instructions pour compiler le serveur Zabbix depuis les sources.
5 Exam des paramètres de configuration du serveur
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.
6 Démarrer les nouveaux binaires Zabbix
Démarrez les nouveaux binaires. Vérifiez les fichiers de logs pour voir si les fichiers binaires ont démarré avec succès.
Le serveur Zabbix mettra automatiquement à jour la base de données. Au démarrage, le serveur Zabbix signale les versions de base de données actuelles (obligatoires et facultatives) et requises. Si la version actuelle est antérieure à la version requise, le serveur Zabbix exécute automatiquement les correctifs requis de mise à jour de base de données. La progression (en pourcentage) de la mise à jour de la base de données est écrite dans le fichier de logs du serveur Zabbix. Lorsque la mise à jour est terminée, un message "Mise à jour de la base de données entièrement terminée" est écrit dans le fichier de logs. Si l'un des correctifs de mise à jour échoue, le serveur Zabbix ne démarre pas. Le serveur Zabbix ne démarrera pas non plus si la version de base de données actuelle est plus récente que celle requise. Le serveur Zabbix démarre uniquement si la version de base de données obligatoire actuelle correspond à la version obligatoire requise.
8673:20161117:104750.259 current database version (mandatory/optional): 03040000/03040000 8673:20161117:104750.259 required mandatory version: 03040000
Avant de démarrer le serveur :
- Assurez-vous que l'utilisateur de la base de données dispose des autorisations nécessaires (créer une table, supprimer une table, créer un index, supprimer un index) ;
- Assurez-vous d'avoir suffisamment d'espace disque libre.
7 Installation de la nouvelle interface Web Zabbix
La version PHP minimale requise est 7.2.5. Mettez à jour si nécessaire et suivez les instructions d'installation.
8 Effacer les cookies et le cache du navigateur
Après la mise à jour, vous devrez peut-être effacer les cookies et le cache du navigateur Web pour que l'interface Web de Zabbix fonctionne correctement.
Procédure de mise à jour du Proxy
1 Arrêt du proxy Zabbix
Arrêtez le proxy Zabbix.
2 Sauvegarde des fichiers de configuration et des binaires du proxy Zabbix
Faites une copie de sauvegarde des binaires du proxy Zabbix et des fichiers de configuration.
3 Installation des nouveaux binaires
Utilisez les instructions pour compiler le proxy Zabbix depuis les sources.
4 Exam des paramètres de configuration des proxys
Il n'y a pas de modifications obligatoires dans cette version pour les paramètres du proxy.
5 Démarrage du nouveau proxy Zabbix
Démarrez le nouveau proxy Zabbix. Vérifiez les fichiers de logs pour voir si le proxy a démarré correctement.
Zabbix mettra automatiquement à jour la base de données. La mise à jour de la base de données a lieu de la même manière que lors du démarrage du serveur Zabbix.
Processus de mise à niveau de l'agent
La mise à niveau des agents n'est pas obligatoire. Vous ne devez mettre à niveau les agents que si cela est nécessaire pour accéder à la nouvelle fonctionnalité.
La procédure de mise à niveau décrite dans cette section peut être utilisée pour mettre à niveau à la fois l'agent Zabbix et l'agent Zabbix 2.
1 Arrêt de l’agent Zabbix
Arrêtez l’agent Zabbix.
2 Sauvegarde des fichiers de configuration et des binaires de l’agent Zabbix
Faites une copie de sauvegarde des binaires de l’agent Zabbix et des fichiers de configuration.
3 Installation des nouveaux binaires d’agent
Utilisez les instructions pour compiler l’agent Zabbix depuis les sources.
Sinon, vous pouvez télécharger un agent pré-compilé depuis la page de téléchargement Zabbix.
4 Exam des paramètres de configuration des agents
Il n'y a pas de modifications obligatoires dans cette version ni des paramètres agent ni des paramètres agent 2.
5 Démarrage du nouvel agent Zabbix
Démarrez le nouvel agent Zabbix. Vérifiez les fichiers de logs pour vérifier que l’agent a démarré correctement.
Mise à niveau entre les versions mineures
Lors de la mise à niveau entre les versions mineures de 6.0.x (par exemple de 6.0.1 à 6.0.3), il est nécessaire d'exécuter les mêmes actions pour le serveur/proxy/agent que lors de la mise à niveau entre les versions majeures. La seule différence est que lors de la mise à niveau entre des versions mineures, aucune modification de la base de données n'est apportée.