1 Mise à niveau à partir des sources

Vue d’ensemble

Cette section présente les étapes nécessaires pour effectuer une mise à niveau réussie de Zabbix 7.2.x vers Zabbix 7.4.x à l’aide des sources officielles de Zabbix.

Avant la mise à niveau, veillez à lire les notes de mise à niveau pertinentes !

Vous pouvez également consulter les prérequis pour la version 7.4.

Il peut être utile d’exécuter deux sessions SSH en parallèle pendant la mise à niveau : effectuez les étapes de mise à niveau dans l’une et surveillez 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 deuxième session SSH afin d’afficher les dernières entrées du fichier journal et les éventuelles erreurs en temps réel. Cela peut être essentiel pour les instances de production.

Procédure de mise à jour du serveur

1 Arrêter le serveur

Arrêtez le serveur Zabbix afin de vous assurer qu'aucune nouvelle donnée n'est insérée dans la base de données.

2 Sauvegarder la base de données Zabbix existante

Cette étape est très importante. Assurez-vous de disposer d'une sauvegarde de votre base de données. Elle vous sera utile si la procédure de mise à niveau échoue (espace disque insuffisant, coupure de courant ou tout autre problème inattendu).

3 Sauvegarder les fichiers de configuration, les fichiers PHP et les binaires Zabbix

Créez une copie de sauvegarde des binaires Zabbix, des fichiers de configuration et du répertoire contenant les 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

Veillez à consulter les Notes de mise à niveau afin de vérifier si des modifications des paramètres de configuration sont nécessaires.

Pour connaître les nouveaux paramètres facultatifs, consultez la page Nouveautés.

6 Démarrer les nouveaux binaires de Zabbix

Démarrez les nouveaux binaires. Consultez les fichiers journaux pour vérifier que les binaires ont démarré correctement.

Le serveur Zabbix met automatiquement à niveau la base de données. Lors de son démarrage, le serveur Zabbix indique les versions actuelles (obligatoire et facultative) et les versions requises de la base de données. Si la version obligatoire actuelle est antérieure à la version requise, le serveur Zabbix exécute automatiquement les correctifs de mise à niveau requis de la base de données. Le début et la progression (en pourcentage) de la mise à niveau de la base de données sont consignés dans le fichier journal du serveur Zabbix. Lorsque la mise à niveau est terminée, le message « database upgrade fully completed » est écrit dans le fichier journal. Si l’un des correctifs de mise à niveau échoue, le serveur Zabbix ne démarre pas. Le serveur Zabbix ne démarre pas non plus si la version obligatoire actuelle de la base de données est plus récente que la version requise. Le serveur Zabbix démarre uniquement si la version obligatoire actuelle de la base de données 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 de suffisamment d’autorisations (création de tables, suppression de tables, création d’index, suppression d’index).
  • Assurez-vous de disposer de suffisamment d’espace disque libre.
7 Installer la nouvelle interface web Zabbix

La version minimale requise de PHP est 8.0.0. Mettez-la à jour si nécessaire et suivez les instructions d'installation.

8 Effacer les cookies et le cache du navigateur web

Après la mise à niveau, 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

Veillez à consulter les Notes de mise à niveau afin de vérifier si des modifications des paramètres de configuration sont nécessaires.

Pour connaître les nouveaux paramètres facultatifs, consultez la page Nouveautés.

5 Démarrer le nouveau proxy Zabbix

Démarrez le nouveau proxy Zabbix. Consultez les fichiers journaux pour vérifier que 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 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 devez uniquement mettre à niveau les agents si cela est nécessaire pour accéder aux nouvelles fonctionnalités.

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 les nouveaux binaires de l'agent

Suivez 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 connaître les nouveaux paramètres facultatifs, consultez la page Nouveautés.

5 Démarrer le nouvel agent Zabbix

Démarrez le nouvel agent Zabbix. Consultez les fichiers journaux 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 7.4.x (par exemple, de 7.4.1 vers 7.4.3), il est nécessaire d'exécuter les mêmes actions pour le serveur/proxy/agent que lors d'une mise à niveau entre des versions majeures. La seule différence est que lors d'une mise à niveau entre des versions mineures, aucune modification n'est apportée à la base de données.