- Mise à niveau à partir des 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 Installer les nouveaux binaires du serveur
- 5 Vérifier les paramètres de configuration du serveur
- 6 Démarrer les nouveaux binaires Zabbix
- 7 Installer la nouvelle interface web de 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 versions mineures
Mise à niveau à partir des sources
Aperçu
Cette section présente les étapes nécessaires pour effectuer une mise à niveau réussie de Zabbix 7.4.x vers Zabbix 8.0.x à l’aide des sources officielles de Zabbix.
Avant la mise à niveau, assurez-vous de lire les notes de mise à niveau correspondantes !
Vous pouvez également consulter les prérequis pour la version 8.0.
Il peut être utile d’exécuter deux sessions SSH parallèles pendant
la mise à niveau, en effectuant les étapes de mise à niveau dans l’une et en surveillant les
journaux du serveur/proxy dans l’autre. Par exemple, exécutez
tail -f zabbix_server.log ou tail -f zabbix_proxy.log dans la seconde
session SSH afin d’afficher les dernières entrées du fichier journal et les erreurs éventuelles
en temps réel. Cela peut être essentiel 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 Installer les nouveaux binaires du serveur
Utilisez ces instructions pour compiler le serveur Zabbix à partir des sources.
5 Vérifier les paramètres de configuration du serveur
Assurez-vous de consulter les Notes de mise à niveau pour vérifier si des modifications des paramètres de configuration sont nécessaires.
Pour les nouveaux paramètres optionnels, consultez la page Nouveautés.
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 Installer la nouvelle interface web de Zabbix
La version minimale requise de PHP est 8.2.0. 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 Installer les nouveaux binaires du proxy
Utilisez ces instructions pour compiler le proxy Zabbix à partir des sources.
4 Vérifier les paramètres de configuration du proxy
Assurez-vous de consulter les Notes de mise à niveau pour vérifier si des modifications des paramètres de configuration sont nécessaires.
Pour les nouveaux paramètres optionnels, consultez la page Nouveautés.
5 Démarrer le nouveau proxy Zabbix
Démarrez le nouveau proxy Zabbix. Vérifiez les fichiers journaux pour voir si le proxy a démarré correctement.
Le proxy Zabbix mettra automatiquement à niveau la base de données. La mise à niveau de la base de données s’effectue de manière similaire à celle 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 Installer de nouveaux binaires d’agent
Utilisez ces instructions pour compiler l’agent Zabbix à partir des sources.
Vous pouvez également télécharger des agents Zabbix précompilés depuis la page de téléchargement de Zabbix.
4 Vérifier les paramètres de configuration de l'agent
Veillez à consulter les Notes de mise à niveau afin de vérifier si des modifications des paramètres de configuration sont nécessaires.
Pour les nouveaux paramètres facultatifs, consultez la page Nouveautés.
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 versions mineures
Lors d’une mise à niveau entre des versions mineures de 8.0.x (par exemple de 8.0.1 à 8.0.3), il est nécessaire d’exécuter les mêmes actions pour le serveur/proxy/agent que lors d’une mise à niveau entre versions majeures. La seule différence est que, lors d’une mise à niveau entre versions mineures, aucune modification n’est apportée à la base de données.