Installation à partir des sources

Vous pouvez obtenir la toute dernière version de Zabbix en la compilant à partir des sources. Voir également Obtention du code source de Zabbix.

Un tutoriel détaillé pour installer Zabbix à partir des sources est disponible ici.

Installation des démons Zabbix

1 Télécharger l’archive source

Accédez à la page de téléchargement de Zabbix et téléchargez l’archive source. Une fois le téléchargement terminé, extrayez les sources en exécutant :

tar -zxvf zabbix-8.0.0.tar.gz

Saisissez la version correcte de Zabbix dans la commande. Elle doit correspondre au nom de l’archive téléchargée.

2 Créer un compte utilisateur

Tous les processus daemon de Zabbix s’exécutent sous des utilisateurs système non privilégiés. Si un daemon Zabbix est démarré depuis un compte utilisateur non privilégié, il continuera de s’exécuter sous ce compte.

Dans la configuration par défaut, si un daemon est démarré en tant que root, il bascule vers le compte utilisateur zabbix, qui doit être présent. Pour créer un utilisateur et un groupe système zabbix, exécutez les commandes ci-dessous.

Système basé sur RedHat :

groupadd --system zabbix
useradd --system -g zabbix -d /usr/lib/zabbix -s /sbin/nologin -c "Zabbix Monitoring System" zabbix

Système basé sur Debian :

addgroup --system --quiet zabbix
adduser --quiet --system --disabled-login --ingroup zabbix --home /var/lib/zabbix --no-create-home zabbix

Il n’est pas nécessaire de créer un compte utilisateur distinct pour l’interface Zabbix.

Recommandation de sécurité

Si le serveur et l’agent Zabbix s’exécutent sur la même machine, il est recommandé de les exécuter sous des comptes utilisateur distincts. Les exécuter sous le même utilisateur permet à l’agent d’accéder au fichier de configuration du serveur, ce qui pourrait exposer des informations sensibles, telles que le mot de passe de la base de données, à tout utilisateur disposant du niveau d’accès Administrateur dans Zabbix.

Exécuter Zabbix en tant que root, bin ou tout autre compte disposant de droits spéciaux constitue un risque de sécurité.

Répertoire personnel (facultatif)

Les processus Zabbix n’ont pas besoin d’un répertoire personnel ; il n’est donc généralement pas recommandé d’en créer un. Cependant, si vous avez besoin d’une fonctionnalité nécessitant un répertoire personnel (par exemple, stocker les identifiants MySQL dans $HOME/.my.cnf), vous pouvez le créer à l’aide des commandes ci-dessous.

Sur les systèmes basés sur RedHat, exécutez :

mkdir -m u=rwx,g=rwx,o= -p /usr/lib/zabbix
chown zabbix:zabbix /usr/lib/zabbix

Sur les systèmes basés sur Debian, exécutez :

mkdir -m u=rwx,g=rwx,o= -p /var/lib/zabbix
chown zabbix:zabbix /var/lib/zabbix
3 Créer la base de données Zabbix

Une base de données est requise pour les démons serveur et proxy Zabbix, ainsi que pour l'interface Zabbix. Elle n'est pas nécessaire pour exécuter l'agent Zabbix.

Des scripts SQL sont fournis pour créer le schéma de la base de données et insérer le jeu de données. La base de données du proxy Zabbix nécessite uniquement le schéma, tandis que la base de données du serveur Zabbix nécessite également le jeu de données en plus du schéma.

Après avoir créé une base de données Zabbix, passez aux étapes suivantes de la compilation de Zabbix.

4 Configurer les sources

C99 avec les extensions GNU est requis pour compiler le serveur Zabbix, le proxy Zabbix ou l'agent Zabbix. Cette version peut être spécifiée explicitement en définissant CFLAGS="-std=gnu99" :

export CFLAGS="-std=gnu99"

Si l'installation est effectuée depuis le dépôt Git de Zabbix, il est nécessaire d'exécuter au préalable :

./bootstrap.sh

Lors de la configuration des sources pour un serveur Zabbix ou un proxy, vous devez spécifier le type de base de données à utiliser. Un seul type de base de données peut être compilé avec un processus serveur ou proxy à la fois.

Pour afficher toutes les options de configuration prises en charge, exécutez la commande suivante dans le répertoire contenant les sources Zabbix extraites :

./configure --help

Pour configurer les sources d'un serveur Zabbix et d'un agent, vous pouvez exécuter une commande similaire à :

./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openipmi --with-ares

Pour configurer les sources d'un serveur Zabbix (avec PostgreSQL, etc.), vous pouvez exécuter :

./configure --enable-server --with-postgresql --with-net-snmp

Pour configurer les sources d'un proxy Zabbix (avec SQLite, etc.), vous pouvez exécuter :

./configure --prefix=/usr --enable-proxy --with-net-snmp --with-sqlite3 --with-ssh2

Pour configurer les sources d'un agent Zabbix, vous pouvez exécuter :

./configure --enable-agent

ou, pour l'agent Zabbix 2 :

./configure --enable-agent2

Une version prise en charge de Go doit être installée pour compiler l'agent Zabbix 2.

Remarques sur les options de compilation :

  • --enable-agent - compile l'agent Zabbix, ainsi que les utilitaires en ligne de commande Zabbix get et Zabbix sender.
  • --with-libcurl - requis pour la surveillance des machines virtuelles, l'authentification SMTP, les éléments de l'agent Zabbix web.page.* et les éléments de requête de télémétrie. Voir également : Configuration requise (libcurl).
  • --with-libxml2 - requis pour la surveillance des machines virtuelles.
  • --with-libpcre2[=DIR] - Zabbix est toujours compilé avec la bibliothèque PCRE2 ; cette option permet uniquement de spécifier un chemin d'installation personnalisé de PCRE2.
  • --with-mysql=/path/to/mysql_config - spécifie le chemin vers la configuration d'une bibliothèque cliente MySQL particulière. Utile lorsque plusieurs versions de MySQL ou MariaDB sont installées.
  • --enable-static - lie statiquement les bibliothèques (non pris en charge sur Solaris). Utilisez cette option si vous prévoyez de distribuer les binaires compilés sur des systèmes dépourvus des bibliothèques requises. Cette option n'est pas recommandée lors de la compilation du serveur Zabbix. Pour compiler le serveur de manière statique, une version statique de chaque bibliothèque externe est requise. Le script configure ne vérifie pas automatiquement ce point.
  • --with-stacksize=<value> - définit la taille de pile par thread en kilo-octets (par exemple, --with-stacksize=512). Vous pouvez augmenter cette valeur si Zabbix se bloque ou se fige en raison de débordements de pile (par exemple, lors du prétraitement sur des systèmes dont la limite par défaut de la pile des threads est faible).
  • --with-apm (à utiliser uniquement avec --enable-proxy) - requis pour la surveillance des performances des applications (APM) sur un proxy Zabbix. Voir également : Configuration requise (g++, gRPC, protobuf, Abseil).

Si ./configure échoue en raison de bibliothèques manquantes ou d'autres problèmes, consultez le fichier config.log pour obtenir des informations détaillées sur l'erreur.

Par exemple, si libssl est manquante, le message d'erreur immédiat peut être trompeur :

checking for main in -lmysqlclient... no
configure: error: Not found mysqlclient library

Dans ce cas, config.log révèle la cause réelle :

/usr/bin/ld: cannot find -lssl
/usr/bin/ld: cannot find -lcrypto

Voir également :

5 Compiler et installer tous les composants

Si l'installation est effectuée depuis le dépôt Git de Zabbix, il est nécessaire d'exécuter d'abord :

$ make dbschema

make install

Cette étape doit être exécutée par un utilisateur disposant des autorisations suffisantes (généralement « root » ou en utilisant sudo).

Par défaut, l'exécution de make install installe les binaires du démon (zabbix_server, zabbix_agentd, zabbix_proxy) dans /usr/local/sbin et les binaires client (zabbix_get, zabbix_sender) dans /usr/local/bin.

Pour spécifier un emplacement différent de /usr/local, utilisez une option --prefix lors de l'étape précédente de configuration des sources, par exemple --prefix=/home/zabbix. Dans ce cas, les binaires du démon seront installés sous <prefix>/sbin, tandis que les utilitaires seront installés sous <prefix>/bin. Les pages de manuel seront installées sous <prefix>/share.

6 Examiner et modifier les fichiers de configuration

Vous devez configurer ce fichier pour chaque hôte sur lequel zabbix_agentd est installé.

Vous devez spécifier l'adresse IP du serveur Zabbix dans le fichier. Les connexions provenant d'autres hôtes seront refusées.

Vous devez spécifier le nom de la base de données, l'utilisateur et le mot de passe (le cas échéant).

Les autres paramètres par défaut vous conviendront si vous avez une petite installation (jusqu'à dix hôtes surveillés). Vous devriez toutefois modifier les paramètres par défaut si vous souhaitez optimiser les performances du serveur Zabbix (ou du proxy).

Vous devez spécifier l'adresse IP du serveur et le nom d'hôte du proxy (qui doit être connu du serveur), ainsi que le nom de la base de données, l'utilisateur et le mot de passe (le cas échéant).

Avec SQLite, le chemin complet vers le fichier de base de données doit être spécifié ; l'utilisateur et le mot de passe de la base de données ne sont pas requis.

7 Démarrer les daemons

Exécutez zabbix_server côté serveur.

zabbix_server

Assurez-vous que votre système autorise l'allocation de 36 Mo (ou un peu plus) de mémoire partagée ; sinon, le serveur risque de ne pas démarrer et vous verrez le message « Cannot allocate shared memory for <type of cache>. » dans le fichier journal du serveur. Cela peut se produire sur FreeBSD et Solaris 8.

Exécutez zabbix_agentd sur toutes les machines surveillées.

zabbix_agentd

Assurez-vous que votre système autorise l'allocation de 2 Mo de mémoire partagée ; sinon, l'agent risque de ne pas démarrer et vous verrez le message « Cannot allocate shared memory for collector. » dans le fichier journal de l'agent. Cela peut se produire sur Solaris 8.

Si vous avez installé un proxy Zabbix, exécutez zabbix_proxy.

zabbix_proxy

Installation de l’interface web Zabbix

Copie des fichiers PHP

L’interface Zabbix est écrite en PHP. Pour l’exécuter, un serveur web prenant en charge PHP est donc nécessaire. L’installation consiste simplement à copier les fichiers PHP du répertoire ui dans le répertoire des documents HTML du serveur web.

Les emplacements courants des répertoires de documents HTML pour les serveurs web Apache sont notamment les suivants :

  • /usr/local/apache2/htdocs (répertoire par défaut lors de l’installation d’Apache depuis les sources)
  • /srv/www/htdocs (OpenSUSE, SLES)
  • /var/www/html (Debian, Ubuntu, Fedora, RHEL)

Il est recommandé d’utiliser un sous-répertoire plutôt que la racine HTML. Pour créer un sous-répertoire et y copier les fichiers de l’interface Zabbix, exécutez les commandes suivantes en remplaçant <htdocs> par le répertoire approprié :

mkdir <htdocs>/zabbix
cd ui
cp -a . <htdocs>/zabbix

Si vous prévoyez d’utiliser une autre langue que l’anglais, consultez Installation de langues supplémentaires pour l’interface pour obtenir les instructions.

Installation de l’interface web

Veuillez consulter la page Installation de l’interface web pour obtenir des informations sur l’assistant d’installation de l’interface web de Zabbix.

Installation des plugins chargeables de l'agent Zabbix 2

L'installation des plugins chargeables de l'agent Zabbix 2 est uniquement nécessaire si vous souhaitez superviser des cibles qui ne sont pas prises en charge par les plugins intégrés (par exemple, des serveurs ou clusters MongoDB, PostgreSQL et ses forks, etc.). Consultez la liste complète des plugins chargeables et des plugins intégrés.

Avant d'installer un plugin, veuillez consulter son fichier README. Il peut contenir des exigences et des instructions d'installation spécifiques.

Pour installer un plugin à partir des sources, commencez par télécharger et extraire l'archive des sources du plugin chargeable.

Pour compiler le plugin, accédez au répertoire du plugin extrait et exécutez make :

make

Une version prise en charge de Go doit être installée pour compiler les plugins chargeables de l'agent Zabbix 2.

L'exécutable du plugin peut être placé n'importe où, à condition qu'il puisse être chargé par l'agent Zabbix 2. Indiquez le chemin vers le binaire du plugin dans le fichier de configuration du plugin, par exemple dans postgresql.conf pour le plugin PostgreSQL :

Plugins.PostgreSQL.System.Path=/path/to/executable/zabbix-agent2-plugin-postgresql

Le chemin vers le fichier de configuration du plugin doit être indiqué dans le paramètre Include du fichier de configuration de l'agent Zabbix 2 :

Include=/path/to/plugin/configuration/file/postgresql.conf

Passez à la configuration pour plus d'informations sur la configuration des plugins.

Les plugins chargeables fournis par Zabbix utilisent des makefiles simples avec les cibles de compilation suivantes :

  • make - compiler le plugin
  • make clean - supprimer tous les fichiers créés lors de la compilation du plugin
  • make check - exécuter les tests automatiques (nécessite une cible de supervision réelle, par exemple une base de données PostgreSQL)
  • make style - vérifier le style du code Go avec golangci-lint
  • make format - formater le code Go avec go fmt
  • make dist - créer une archive des sources incluant toutes les dépendances

Installation de Java gateway

Il est nécessaire d’installer Java gateway uniquement si vous souhaitez superviser des applications JMX. Java gateway est léger et ne nécessite pas de base de données.

Pour l’installer à partir des sources, commencez par télécharger et extraire l’archive source.

Pour compiler Java gateway, exécutez le script ./configure avec l’option --enable-java. Il est recommandé de spécifier l’option --prefix afin de demander un chemin d’installation autre que le chemin par défaut /usr/local, car l’installation de Java gateway créera toute une arborescence de répertoires, et pas seulement un fichier exécutable.

./configure --enable-java --prefix=$PREFIX

Pour compiler et empaqueter Java gateway dans un fichier JAR, exécutez make. Notez que pour cette étape, vous aurez besoin des exécutables javac et jar dans votre chemin.

make

Vous disposez maintenant d’un fichier zabbix-java-gateway-$VERSION.jar dans src/zabbix_java/bin. Si vous êtes à l’aise avec l’exécution de Java gateway depuis src/zabbix_java dans le répertoire de distribution, vous pouvez passer aux instructions de configuration et d’exécution de Java gateway. Sinon, assurez-vous de disposer de privilèges suffisants et exécutez make install.

make install

Consultez la section configuration pour plus de détails sur la configuration et l’exécution de Java gateway.

Installation du service web Zabbix

L'installation du service web Zabbix est uniquement requise si vous souhaitez utiliser les rapports planifiés.

Pour effectuer l'installation à partir des sources, commencez par télécharger et extraire l'archive source.

Pour compiler le service web Zabbix, exécutez le script ./configure avec l'option --enable-webservice.

Une version prise en charge de Go doit être installée pour compiler le service web Zabbix.

Exécutez zabbix_web_service sur la machine où le service web est installé :

zabbix_web_service

Consultez la section configuration pour plus de détails sur la configuration de la génération des rapports planifiés.

Installation du serveur MCP Zabbix

Pour installer à partir des sources, commencez par télécharger et extraire l’archive source.

Pour compiler le serveur MCP Zabbix, exécutez la commande suivante dans le répertoire des sources du serveur MCP :

make build

Une version de Go prise en charge doit être installée pour compiler le serveur MCP Zabbix.

Pour indiquer une version spécifique dans la sortie de zabbix_mcp_server -V et dans le User-Agent des requêtes API Zabbix, définissez la variable VERSION, par exemple : make build VERSION=8.0.0.

Pour installer le binaire dans /usr/local/sbin et le fichier de configuration d’exemple dans /etc/zabbix, exécutez :

sudo make install

Modifiez le fichier de configuration /etc/zabbix/zabbix_mcp_server.conf et définissez au moins les paramètres suivants :

  • FrontendURL - l’URL de l’API Zabbix, se terminant par api_jsonrpc.php ;
  • AllowedIP - les adresses des clients MCP autorisés à se connecter.

Pour chiffrer les connexions des clients MCP, définissez TLSAccept=cert et indiquez TLSCertFile et TLSKeyFile, ou exécutez le serveur MCP derrière un proxy inverse de confiance qui gère TLS.

Si l’utilisateur zabbix n’existe pas (par exemple, si seul le serveur MCP est installé sur la machine), créez-le comme décrit dans Créer un compte utilisateur.

Validez le fichier de configuration et démarrez zabbix_mcp_server :

zabbix_mcp_server -c /etc/zabbix/zabbix_mcp_server.conf -T
zabbix_mcp_server -c /etc/zabbix/zabbix_mcp_server.conf

Consultez Serveur MCP pour plus d’informations sur la configuration du serveur et la connexion des clients MCP.

Obtenir le code source de Zabbix

Il existe plusieurs façons d'obtenir le code source de Zabbix :

  • Vous pouvez télécharger les versions stables publiées depuis le site officiel de Zabbix
  • Vous pouvez télécharger les versions nocturnes depuis la page des développeurs du site officiel de Zabbix
  • Vous pouvez obtenir la dernière version en développement depuis le système de dépôt de code source Git :

Un client Git doit être installé pour cloner le dépôt. Le paquet client Git officiel en ligne de commande est généralement appelé git dans les distributions. Pour l'installer, par exemple sur Debian/Ubuntu, exécutez :

sudo apt-get update
sudo apt-get install git

Pour récupérer l'intégralité du code source de Zabbix, accédez au répertoire dans lequel vous souhaitez placer le code et exécutez :

git clone https://git.zabbix.com/scm/zbx/zabbix.git

Problèmes de compilation

Voici les problèmes connus concernant la compilation de Zabbix à partir des sources. Pour tous les autres cas, consultez la page Problèmes connus.

Bibliothèque dans un emplacement non standard

Zabbix vous permet de spécifier une bibliothèque située dans un emplacement non standard. Dans l’exemple ci-dessous, Zabbix exécutera curl-config depuis l’emplacement non standard spécifié et utilisera sa sortie pour déterminer la libcurl appropriée à utiliser.

$ ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config

Cela fonctionnera si c’est la seule libcurl installée sur le système, mais pourrait ne pas fonctionner si une autre libcurl est installée dans un emplacement standard (par exemple, par le gestionnaire de paquets). C’est notamment le cas lorsque vous avez besoin d’une version plus récente de la bibliothèque pour Zabbix et de l’ancienne version pour d’autres applications.

Par conséquent, le fait de spécifier un composant situé dans un emplacement non standard ne fonctionnera pas toujours lorsque le même composant existe également dans un emplacement standard.

Par exemple, si vous utilisez une libcurl plus récente installée dans /usr/local alors que le paquet libcurl est toujours installé, Zabbix pourrait sélectionner la mauvaise version et la compilation échouerait :

usr/bin/ld: ../../src/libs/zbxhttp/libzbxhttp.a(http.o): in function 'zbx_http_convert_to_utf8':
/tmp/zabbix-master/src/libs/zbxhttp/http.c:957: undefined reference to 'curl_easy_header'
collect2: error: ld returned 1 exit status

Ici, la fonction curl_easy_header() n’est pas disponible dans l’ancienne /usr/lib/x86_64-linux-gnu/libcurl.so, mais elle est disponible dans la nouvelle /usr/local/lib/libcurl.so.

Le problème vient de l’ordre des options de l’éditeur de liens. Une solution consiste à spécifier le chemin complet vers la bibliothèque dans une variable LDFLAGS :

$ LDFLAGS="-Wl,--no-as-needed /usr/local/lib/libcurl.so" ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config

Notez l’option -Wl,--no-as-needed, qui peut être nécessaire sur certains systèmes (voir également : les options d’édition de liens par défaut sur les systèmes basés sur Debian).

Taille de pile trop faible sur certains systèmes

Si Zabbix plante ou se fige en raison de débordements de pile, vous pouvez augmenter la taille de la pile par thread à l'aide de l'option --with-stacksize lors de la configuration des sources. Ce problème peut se produire sur des systèmes dont les limites par défaut de la pile des threads sont faibles, en particulier pendant le prétraitement, où plusieurs threads sont créés.

L'exemple suivant définit la taille de la pile à 512 Ko par thread :

./configure --enable-server --with-mysql --with-stacksize=512

Vous pouvez vérifier les limites de pile des threads du système à l'exécution à l'aide de la commande ulimit -s sur les systèmes basés sur Linux.