Remarques sur l’installation à partir de paquets

Aperçu

Les paquets officiels en préversion de Zabbix 8.0 sont disponibles sur le site web de Zabbix.

Sélectionnez votre système d’exploitation et le composant Zabbix afin de générer des instructions d’installation adaptées à votre environnement. Consultez également les notes d’installation des paquets sur cette page pour obtenir des informations complémentaires importantes, ainsi que la section Installation and setup.

Des paquets sont disponibles pour les distributions Linux suivantes :

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

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 si les deux sont installés sur le même hôte.

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

Zabbix fournit également des binaires précompilés de Zabbix agent pour les systèmes d’exploitation non Linux ; voir :

• Installation de l’agent Windows à partir d’un MSI
• Installation de l’agent macOS à partir d’un PKG
• Binaires hérités (pour les systèmes plus anciens ou moins courants, tels que HP-UX, NetBSD, Tru64 et les anciennes versions de SLES)

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 server/proxy Zabbix fait que PostgreSQL utilise un socket réseau au lieu d'un socket UNIX local ; voir la configuration SELinux pour les instructions de configuration associées.
• Si vous utilisez TimescaleDB, consultez la section supplémentaire sur la configuration de TimescaleDB.
• Si vous installez le Java gateway Zabbix (pour la supervision des applications JMX), consultez également les instructions de configuration supplémentaires pour les systèmes basés sur RHEL et les systèmes basés sur Debian.
• Pour exécuter l'agent Zabbix en tant que root, voir Exécuter l'agent en tant que root.

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

• Si vous avez activé le dépôt EPEL pour EL9, qui fournit également des paquets Zabbix, il doit être exclu de la résolution des paquets avant d'installer les paquets Zabbix officiels ; voir Installation accidentelle des paquets Zabbix EPEL.
• Pour installer des paquets Zabbix dans des environnements Red Hat UBI, voir Paquets Zabbix pour RHEL dans les environnements Red Hat UBI.
• Pour utiliser les éléments ICMP ping, des paquets pour fping sont également disponibles dans le dépôt officiel Zabbix.

Configuration de SELinux

Zabbix utilise une communication inter-processus basée sur des sockets. Sur les systèmes où Security-Enhanced Linux (SELinux) est activé, il peut être nécessaire d’ajouter des règles SELinux pour permettre à Zabbix de créer/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 ils sont présents tant que le processus est en cours d’exécution.

Si SELinux est activé en mode enforcing, exécutez les commandes suivantes pour autoriser la communication entre le frontend 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 le frontend Zabbix à se connecter à la base de données :

setsebool -P httpd_can_network_connect_db on

Pour les versions de RHEL antérieures à 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

En option, vous pouvez installer un paquet zabbix-selinux-policy prédéfini depuis le dépôt officiel de Zabbix. Ce paquet est fourni pour toutes les versions de systèmes d’exploitation prises en charge afin de simplifier le déploiement de Zabbix et d’éviter que les utilisateurs ne désactivent SELinux en raison de la complexité de la configuration.

Le paquet zabbix-selinux-policy contient une politique SELinux de base, permettant à Zabbix de créer et d’utiliser des sockets et d’autoriser la connexion de HTTPd à PostgreSQL (utilisé par le frontend).

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 pour les binaires Zabbix. Ils ne sont pas nécessaires pour une installation ou un fonctionnement normal, mais sont utiles pour le dépannage avancé.

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

• Sur RHEL 7, modifiez /etc/yum.repos.d/zabbix.repo et définissez enabled=1 pour la section zabbix-debuginfo :

[zabbix-debuginfo]
name=Zabbix Official Repository debuginfo - $basearch
baseurl=http://repo.zabbix.com/zabbix/8.0/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 pour la section zabbix-debuginfo :

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

Une fois activé, installez les paquets :

• Sur RHEL, installez un seul paquet avec les informations de débogage pour 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 permettent d’activer les dépôts des versions instables de Zabbix (désactivés par défaut), utilisés pour les versions candidates de publications mineures de Zabbix.

Commencez par installer ou mettre à jour vers la dernière version du paquet zabbix-release. 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.0/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.0/unstable/debian bullseye main
deb-src https://repo.zabbix.com/zabbix/8.0/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.0/unstable/sles/15/x86_64/
gpgcheck=1
gpgkey=https://repo.zabbix.com/zabbix/8.0/unstable/sles/15/x86_64/repodata/repomd.xml.key
enabled=1
update=1