Remarques sur l’installation à partir de paquets

Vue d’ensemble

Les paquets préliminaires officiels de Zabbix 8.2 seront bientôt disponibles sur le site web de Zabbix, où vous pouvez sélectionner votre système d’exploitation et le composant Zabbix afin de générer les instructions et les commandes d’installation.

En plus des notes d’installation des paquets ci-dessous, veuillez également consulter la page Installation et configuration.

Les paquets sont disponibles pour les distributions Linux suivantes :

  • Red Hat Enterprise Linux et ses dérivées : AlmaLinux, Amazon Linux 2023, CentOS Stream, CentOS 7, Oracle Linux, Rocky Linux
  • Debian, Ubuntu, Raspberry Pi OS, Raspbian
  • SUSE Linux Enterprise Server, openSUSE Leap

Certaines distributions de systèmes d’exploitation, notamment les distributions basées sur Debian, fournissent leurs propres paquets Zabbix. Ces paquets ne sont pas pris en charge par Zabbix et peuvent être obsolètes ou ne pas inclure les dernières fonctionnalités et corrections de bogues. Il est recommandé d’utiliser uniquement les paquets officiels du dépôt officiel Zabbix. Si vous avez précédemment installé Zabbix depuis le dépôt de votre système d’exploitation, consultez les étapes pour mettre à niveau les paquets Zabbix depuis les dépôts du système d’exploitation.

Les paquets prennent en charge les bases de données MySQL/PostgreSQL et les serveurs web Apache/Nginx. Notez que le serveur Zabbix et le proxy ne peuvent pas partager la même base de données ; utilisez des noms de base de données différents s’ils sont tous deux installés sur le même hôte.

Si nécessaire, des paquets distincts pour l’agent Zabbix/agent 2, Zabbix get et Zabbix sender sont disponibles dans le dépôt officiel Zabbix.

Sur les systèmes basés sur Debian ou Ubuntu, l’installation d’un paquet Zabbix supplémentaire avec apt peut également sélectionner les mises à niveau des paquets Zabbix déjà installés depuis le même dépôt. Pour installer un paquet sans mettre à niveau un paquet de serveur Zabbix ou de proxy déjà installé, bloquez temporairement ce paquet avant l’installation, puis débloquez-le ensuite :

apt-mark hold zabbix-server-mysql
apt install zabbix-sender
apt-mark unhold zabbix-server-mysql

Zabbix fournit également des binaires précompilés de l’agent Zabbix pour les systèmes d’exploitation autres que Linux ; consultez :

Remarques sur l'installation des paquets

Les remarques suivantes s'appliquent à tous les systèmes :

  • Si vous utilisez PostgreSQL, DBHost=localhost (ou une adresse IP) dans la configuration du serveur/proxy Zabbix oblige PostgreSQL à utiliser un socket réseau au lieu d'un socket UNIX local ; consultez Configuration de SELinux pour obtenir les instructions de configuration associées.
  • Si vous utilisez TimescaleDB, consultez les instructions supplémentaires de configuration de TimescaleDB.
  • Si vous installez le Java gateway Zabbix (pour surveiller les applications JMX), consultez les instructions de configuration supplémentaires pour les systèmes basés sur RHEL et les systèmes basés sur Debian.
  • Si vous installez le serveur MCP Zabbix, installez le paquet zabbix-mcp-server et mettez à jour le fichier de configuration (au moins FrontendURL et AllowedIP) avant de démarrer le service.
  • Pour exécuter l'agent Zabbix en tant que root, consultez Exécution de l'agent en tant que root.
  • La surveillance des performances des applications (APM) sur un proxy Zabbix est prise en charge par les paquets suivants :
    • RHEL 10 et ses dérivés - installez le paquet APM du proxy Zabbix (par exemple, zabbix-proxy-mysql-apm au lieu de zabbix-proxy-mysql) ; il nécessite également l'installation du dépôt EPEL et l'activation des dépôts de paquets de dépendances CRB.
    • Debian 12 ou version ultérieure, Raspberry Pi OS (Raspbian) 12 ou version ultérieure, Ubuntu 24.04 ou version ultérieure - APM est inclus dans les paquets du proxy Zabbix.
    • Sur les autres systèmes, vous pouvez installer le proxy Zabbix à partir des sources avec l'option --with-apm.

Les remarques suivantes s'appliquent à RHEL et à ses dérivés :

Configuration de SELinux

Zabbix utilise une communication interprocessus basée sur des sockets. Sur les systèmes où Security-Enhanced Linux (SELinux) est activé, vous devrez peut-être ajouter des règles SELinux pour autoriser Zabbix à créer et utiliser des sockets de domaine UNIX dans le répertoire SocketDir. Les fichiers de socket sont utilisés par le serveur Zabbix (alerter, prétraitement, IPMI) et le proxy Zabbix (IPMI), et sont présents pendant l'exécution du processus.

Lorsque SELinux est activé en mode enforcing, exécutez les commandes suivantes pour activer la communication entre l'interface Zabbix et le serveur :

Pour RHEL 7 (et versions ultérieures), AlmaLinux, CentOS Stream, Oracle Linux, Rocky Linux 8 (et versions ultérieures) :

setsebool -P httpd_can_connect_zabbix on

Si la base de données est accessible via le réseau (y compris localhost pour PostgreSQL), autorisez également l'interface Zabbix à se connecter à la base de données :

setsebool -P httpd_can_network_connect_db on

Pour les versions de RHEL antérieures à la version 7 :

setsebool -P httpd_can_network_connect on
setsebool -P zabbix_can_network on

Après avoir appliqué les paramètres SELinux, redémarrez Apache :

systemctl restart httpd

Vous pouvez également installer le paquet prédéfini zabbix-selinux-policy depuis le dépôt officiel Zabbix. Ce paquet est fourni pour toutes les versions prises en charge des systèmes d'exploitation afin de simplifier le déploiement de Zabbix et d'éviter que les utilisateurs désactivent SELinux en raison de la complexité de la configuration.
Pour la version 10 d'AlmaLinux, CentOS Stream, RHEL, Rocky Linux et Oracle Linux, la politique SELinux est fournie par le paquet zabbix-selinux-policy-main ; le paquet zabbix-selinux-policy possède une dépendance envers zabbix-selinux-policy-main ou selinux-policy-targeted-extra. Le paquet zabbix-selinux-policy-main entre en conflit avec selinux-policy-targeted-extra ; ces deux paquets ne peuvent donc pas être installés simultanément.

Pour une sécurité maximale, il est recommandé de définir des paramètres SELinux personnalisés.

Le paquet zabbix-selinux-policy (zabbix-selinux-policy-main pour la version 10 d'AlmaLinux, CentOS Stream, RHEL, Rocky Linux et Oracle Linux) contient une politique SELinux de base qui autorise Zabbix à créer et utiliser des sockets et active la connexion de HTTPd à PostgreSQL (utilisé par l'interface).

Le fichier source zabbix_policy.te contient les règles suivantes :

module zabbix_policy 1.2;

require {
    type zabbix_t;
    type zabbix_port_t;
    type zabbix_var_run_t;
    type postgresql_port_t;
    type httpd_t;
    class tcp_socket name_connect;
    class sock_file { create unlink };
    class unix_stream_socket connectto;
}

#============= zabbix_t ==============
allow zabbix_t self:unix_stream_socket connectto;
allow zabbix_t zabbix_port_t:tcp_socket name_connect;
allow zabbix_t zabbix_var_run_t:sock_file create;
allow zabbix_t zabbix_var_run_t:sock_file unlink;
allow httpd_t zabbix_port_t:tcp_socket name_connect;

#============= httpd_t ==============
allow httpd_t postgresql_port_t:tcp_socket name_connect;

Paquets Debuginfo

Les paquets Debuginfo contiennent les symboles de débogage des binaires Zabbix. Ils ne sont pas nécessaires pour l'installation ou le fonctionnement normal, mais sont utiles pour le dépannage avancé.

Veuillez noter que les paquets Debuginfo sont disponibles pour les versions suivantes : Red Hat Enterprise Linux 7 et antérieures (y compris les dérivés), ainsi que SUSE Linux Enterprise Server 15 et antérieures (y compris les dérivés).

Pour activer le dépôt zabbix-debuginfo :

  • Sur RHEL 7, modifiez /etc/yum.repos.d/zabbix.repo et définissez enabled=1 dans la section zabbix-debuginfo :
[zabbix-debuginfo]
name=Zabbix Official Repository debuginfo - $basearch
baseurl=http://repo.zabbix.com/zabbix/8.2/stable/rhel/7/$basearch/debuginfo/
enabled=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591
gpgcheck=1
  • Sur SUSE, modifiez /etc/zypp/repos.d/zabbix.repo et définissez enabled=1 dans la section zabbix-debuginfo :
[zabbix-debuginfo]
name=Zabbix Official Repository debuginfo
type=rpm-md
baseurl=https://repo.zabbix.com/zabbix/8.2/unstable/sles/15/$basearch/debuginfo/
gpgcheck=1
gpgkey=https://repo.zabbix.com/zabbix/8.2/unstable/sles/15/$basearch/debuginfo/repodata/repomd.xml.key
enabled=0
update=1

Une fois le dépôt activé, installez les paquets :

  • Sur RHEL, installez un seul paquet contenant les informations de débogage de tous les composants Zabbix :
dnf install zabbix-debuginfo
  • Sur SUSE, installez les paquets debuginfo spécifiques aux composants :
zypper install zabbix-<component>-debuginfo

Activation des dépôts des versions instables

Les instructions ci-dessous servent à activer les dépôts de versions Zabbix instables (désactivés par défaut), utilisés pour les versions candidates des versions mineures de Zabbix.

Commencez par installer ou mettre à jour le paquet zabbix-release vers la dernière version. Pour activer les paquets rc sur votre système, procédez comme suit :

Red Hat Enterprise Linux

Ouvrez le fichier /etc/yum.repos.d/zabbix.repo et définissez enabled=1 pour le dépôt zabbix-unstable.

[zabbix-unstable]
name=Zabbix Official Repository (unstable) - $basearch
baseurl=https://repo.zabbix.com/zabbix/8.2/unstable/rhel/8/$basearch/
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591
Debian/Ubuntu

Ouvrez le fichier /etc/apt/sources.list.d/zabbix.list et décommentez « Zabbix unstable repository ».

# Zabbix unstable repository
deb https://repo.zabbix.com/zabbix/8.2/unstable/debian bullseye main
deb-src https://repo.zabbix.com/zabbix/8.2/unstable/debian bullseye main
SUSE

Ouvrez le fichier /etc/zypp/repos.d/zabbix.repo et définissez enable=1 pour le dépôt zabbix-unstable.

[zabbix-unstable]
name=Zabbix Official Repository
type=rpm-md
baseurl=https://repo.zabbix.com/zabbix/8.2/unstable/sles/15/x86_64/
gpgcheck=1
gpgkey=https://repo.zabbix.com/zabbix/8.2/unstable/sles/15/x86_64/repodata/repomd.xml.key
enabled=1
update=1