Notas sobre la instalación desde paquetes

Descripción general

Los paquetes oficiales de prelanzamiento de Zabbix 8.0 están disponibles en el sitio web de Zabbix, donde puede seleccionar su sistema operativo y el componente de Zabbix para generar instrucciones y comandos de instalación.

Además de las notas sobre la instalación de paquetes que se incluyen a continuación, consulte también la página Instalación y configuración.

Los paquetes están disponibles para las siguientes distribuciones de Linux:

  • Red Hat Enterprise Linux y sus derivados: AlmaLinux, Amazon Linux 2023, CentOS Stream, CentOS 7, Oracle Linux, Rocky Linux
  • Debian, Ubuntu, Raspberry Pi OS, Raspbian
  • SUSE Linux Enterprise Server, openSUSE Leap

Algunas distribuciones de SO (en particular, las basadas en Debian) proporcionan sus propios paquetes de Zabbix. Estos paquetes no cuentan con soporte de Zabbix y pueden estar desactualizados o no incluir las funciones y correcciones de errores más recientes. Se recomienda utilizar únicamente los paquetes oficiales del repositorio oficial de Zabbix. Si instaló previamente Zabbix desde el repositorio de su sistema operativo, consulte los pasos para actualizar los paquetes de Zabbix desde los repositorios del SO.

Los paquetes son compatibles con bases de datos MySQL/PostgreSQL y servidores web Apache/Nginx. Tenga en cuenta que el server y el proxy de Zabbix no pueden compartir la misma base de datos; utilice nombres de base de datos diferentes si ambos están instalados en el mismo host.

Si es necesario, hay paquetes independientes para Zabbix agent/agent 2, Zabbix get y Zabbix sender disponibles en el repositorio oficial de Zabbix.

Zabbix también proporciona binarios precompilados de Zabbix agent para sistemas operativos que no son Linux; consulte:

Notas sobre la instalación de paquetes

Las siguientes notas se aplican a todos los sistemas:

  • Si utiliza PostgreSQL, DBHost=localhost (o una dirección IP) en la configuración de server/proxy de Zabbix hace que PostgreSQL utilice un socket de red en lugar de un socket UNIX local; consulte Configuración de SELinux para obtener instrucciones de configuración relacionadas.
  • Si utiliza TimescaleDB, consulte la configuración adicional de TimescaleDB.
  • Si instala Java gateway de Zabbix (para supervisar aplicaciones JMX), consulte las instrucciones de configuración adicionales para sistemas basados en RHEL y sistemas basados en Debian.
  • Si instala el servidor MCP de Zabbix, instale el paquete zabbix-mcp-server y actualice el archivo de configuración (al menos FrontendURL y AllowedIP) antes de iniciar el servicio.
  • Para ejecutar Zabbix agent como root, consulte Ejecución de agent como root.
  • La supervisión del rendimiento de aplicaciones (APM) en el proxy de Zabbix es compatible con estos paquetes:
    • RHEL 10 y sus derivados: instale el paquete APM del proxy de Zabbix (por ejemplo, zabbix-proxy-mysql-apm en lugar de zabbix-proxy-mysql); también es necesario instalar el repositorio EPEL y habilitar los repositorios de paquetes de dependencias CRB.
    • Debian 12 o posterior, Raspberry Pi OS (Raspbian) 12 o posterior, Ubuntu 24.04 o posterior: APM está incluido en los paquetes del proxy de Zabbix.
    • En otros sistemas, puede compilar el proxy de Zabbix a partir del código fuente con la opción --with-apm.

Las siguientes notas se aplican a RHEL y sus derivados:

Configuración de SELinux

Zabbix usa comunicación entre procesos basada en sockets. En sistemas donde Security-Enhanced Linux (SELinux) está habilitado, es posible que deba agregar reglas de SELinux para permitir que Zabbix cree/use sockets de dominio UNIX en el directorio SocketDir. Los archivos de socket son utilizados por Zabbix server (alerter, preprocessing, IPMI) y Zabbix proxy (IPMI), y están presentes mientras el proceso se está ejecutando.

Con SELinux habilitado en modo enforcing, ejecute los siguientes comandos para habilitar la comunicación entre Zabbix frontend y server:

Para RHEL 7 (y posteriores), AlmaLinux, CentOS Stream, Oracle Linux, Rocky Linux 8 (y posteriores):

setsebool -P httpd_can_connect_zabbix on

Si se accede a la base de datos a través de la red (incluido localhost para PostgreSQL), permita también que Zabbix frontend se conecte a la base de datos:

setsebool -P httpd_can_network_connect_db on

Para RHEL anteriores a la versión 7:

setsebool -P httpd_can_network_connect on
setsebool -P zabbix_can_network on

Después de aplicar la configuración de SELinux, reinicie Apache:

systemctl restart httpd

Opcionalmente, puede instalar un paquete zabbix-selinux-policy predefinido desde el Repositorio oficial de Zabbix. Este paquete se proporciona para todas las versiones de SO compatibles para simplificar la implementación de Zabbix y evitar que los usuarios desactiven SELinux debido a la complejidad de la configuración.
Para la versión 10 de AlmaLinux, CentOS Stream, RHEL, Rocky Linux y Oracle Linux, la política de SELinux se proporciona mediante el paquete zabbix-selinux-policy-main; el paquete zabbix-selinux-policy tiene una dependencia de zabbix-selinux-policy-main o selinux-policy-targeted-extra. El paquete zabbix-selinux-policy-main entra en conflicto con selinux-policy-targeted-extra; por lo tanto, ambos paquetes no pueden instalarse al mismo tiempo.

Para máxima seguridad, se recomienda establecer configuraciones personalizadas de SELinux.

El paquete zabbix-selinux-policy (zabbix-selinux-policy-main para la versión 10 de AlmaLinux, CentOS Stream, RHEL, Rocky Linux y Oracle Linux) contiene una política básica de SELinux que permite a Zabbix crear y usar sockets y habilita la conexión de HTTPd a PostgreSQL (utilizado por frontend).

El archivo fuente zabbix_policy.te contiene las siguientes reglas:

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;

Paquetes Debuginfo

Los paquetes Debuginfo contienen símbolos de depuración para los binarios de Zabbix. No son necesarios para una instalación u operación normales, pero son útiles para la resolución avanzada de problemas.

Tenga en cuenta que los paquetes Debuginfo están disponibles para las siguientes versiones: Red Hat Enterprise Linux 7 y anteriores (incluidas las derivadas), y SUSE Linux Enterprise Server 15 y anteriores (incluidas las derivadas).

Para habilitar el repositorio zabbix-debuginfo:

  • En RHEL 7, edite /etc/yum.repos.d/zabbix.repo y establezca enabled=1 para la sección 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
  • En SUSE, edite /etc/zypp/repos.d/zabbix.repo y establezca enabled=1 para la sección zabbix-debuginfo:
[zabbix-debuginfo]
name=Zabbix Official Repository debuginfo
type=rpm-md
baseurl=https://repo.zabbix.com/zabbix/8.0/unstable/sles/15/$basearch/debuginfo/
gpgcheck=1
gpgkey=https://repo.zabbix.com/zabbix/8.0/unstable/sles/15/$basearch/debuginfo/repodata/repomd.xml.key
enabled=0
update=1

Una vez habilitado, instale los paquetes:

  • En RHEL, instale un único paquete con información de depuración para todos los componentes de Zabbix:
dnf install zabbix-debuginfo
  • En SUSE, instale paquetes debuginfo específicos por componente:
zypper install zabbix-<component>-debuginfo

Habilitar los repositorios de versiones inestables

Las instrucciones siguientes son para habilitar los repositorios de versiones inestables de Zabbix (deshabilitados de forma predeterminada), que se usan para las versiones candidatas de las versiones menores de Zabbix.

Primero, instale o actualice al paquete zabbix-release más reciente. Para habilitar los paquetes rc en su sistema, haga lo siguiente:

Red Hat Enterprise Linux

Abra el archivo /etc/yum.repos.d/zabbix.repo y establezca enabled=1 para el repositorio 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

Abra el archivo /etc/apt/sources.list.d/zabbix.list y descomente "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

Abra el archivo /etc/zypp/repos.d/zabbix.repo y establezca enable=1 para el repositorio 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