Notas sobre a instalação a partir de pacotes

Visão geral

Os pacotes oficiais de pré-lançamento do Zabbix 8.0 estão disponíveis no site do Zabbix, onde você pode selecionar seu sistema operacional e o componente do Zabbix para gerar instruções e comandos de instalação.

Além das notas sobre a instalação de pacotes abaixo, consulte também a página Instalação e configuração.

Os pacotes estão disponíveis para as seguintes distribuições Linux:

  • Red Hat Enterprise Linux e seus 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

Algumas distribuições de SO, especialmente as baseadas em Debian, fornecem seus próprios pacotes do Zabbix. Esses pacotes não são compatíveis com o Zabbix e podem estar desatualizados ou não incluir os recursos e as correções de bugs mais recentes. Recomenda-se usar somente os pacotes oficiais do Repositório oficial do Zabbix. Se você instalou anteriormente o Zabbix a partir do repositório do seu sistema operacional, consulte as etapas para atualizar pacotes do Zabbix provenientes de repositórios do SO.

Os pacotes são compatíveis com bancos de dados MySQL/PostgreSQL e web server Apache/Nginx. Observe que o Zabbix server e o proxy não podem compartilhar o mesmo banco de dados; use nomes de banco de dados diferentes se ambos estiverem instalados no mesmo host.

Se necessário, pacotes separados para o Zabbix agent/agent 2, Zabbix get e Zabbix sender estão disponíveis no Repositório oficial do Zabbix.

Em sistemas baseados em Debian ou Ubuntu, a instalação de um pacote adicional do Zabbix com apt também pode selecionar atualizações para pacotes do Zabbix já instalados provenientes do mesmo repositório. Para instalar um pacote sem atualizar um pacote instalado do Zabbix server ou proxy, mantenha temporariamente esse pacote em retenção antes da instalação e remova a retenção depois:

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

O Zabbix também fornece binários pré-compilados do Zabbix agent para sistemas operacionais não Linux; consulte:

Observações sobre a instalação de pacotes

As observações a seguir se aplicam a todos os sistemas:

  • Ao usar PostgreSQL, DBHost=localhost (ou um endereço IP) na configuração do server/proxy do Zabbix faz com que o PostgreSQL use um socket de rede em vez de um socket UNIX local; consulte Configuração do SELinux para obter instruções de configuração relacionadas.
  • Ao usar TimescaleDB, consulte a configuração adicional do TimescaleDB.
  • Ao instalar o Java gateway do Zabbix (para monitorar aplicações JMX), consulte as instruções de configuração adicionais para sistemas baseados em RHEL e sistemas baseados em Debian.
  • Ao instalar o MCP server, instale o pacote zabbix-mcp-server e atualize o arquivo de configuração (pelo menos FrontendURL e AllowedIP) antes de iniciar o serviço.
  • Para executar o Zabbix agent como root, consulte Executando o agent como root.
  • O monitoramento de desempenho de aplicações (APM) no proxy do Zabbix é compatível com os seguintes pacotes:
    • RHEL 10 e seus derivados - instale o pacote APM do proxy do Zabbix (por exemplo, zabbix-proxy-mysql-apm em vez de zabbix-proxy-mysql); também é necessário instalar o repositório EPEL e habilitar os repositórios de pacotes de dependências do CRB.
    • Debian 12 ou posterior, Raspberry Pi OS (Raspbian) 12 ou posterior, Ubuntu 24.04 ou posterior - o APM está incluído nos pacotes do proxy do Zabbix.
    • Em outros sistemas, você pode instalar o proxy do Zabbix a partir do código-fonte com a opção --with-apm.

As observações a seguir se aplicam ao RHEL e seus derivados:

Configuração do SELinux

O Zabbix usa comunicação entre processos baseada em sockets. Em sistemas onde o Security-Enhanced Linux (SELinux) está habilitado, talvez seja necessário adicionar regras do SELinux para permitir que o Zabbix crie/use sockets de domínio UNIX no diretório SocketDir. Arquivos de socket são usados pelo server do Zabbix (alerter, preprocessing, IPMI) e pelo proxy do Zabbix (IPMI), e ficam presentes enquanto o processo está em execução.

Com o SELinux habilitado no modo enforcing, execute os seguintes comandos para permitir a comunicação entre o frontend do Zabbix e o server:

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

setsebool -P httpd_can_connect_zabbix on

Se o banco de dados for acessado pela rede (incluindo localhost para PostgreSQL), permita também que o frontend do Zabbix se conecte ao banco de dados:

setsebool -P httpd_can_network_connect_db on

Para RHEL anterior à versão 7:

setsebool -P httpd_can_network_connect on
setsebool -P zabbix_can_network on

Após aplicar as configurações do SELinux, reinicie o Apache:

systemctl restart httpd

Opcionalmente, você pode instalar um pacote zabbix-selinux-policy predefinido do Zabbix Official Repository. Esse pacote é fornecido para todas as versões de SO suportadas para simplificar a implantação do Zabbix e evitar que os usuários desativem o SELinux por causa da complexidade da configuração.
Para a versão 10 do AlmaLinux, CentOS Stream, RHEL, Rocky Linux e Oracle Linux, a política do SELinux é fornecida pelo pacote zabbix-selinux-policy-main; o pacote zabbix-selinux-policy tem uma dependência de zabbix-selinux-policy-main ou selinux-policy-targeted-extra. O pacote zabbix-selinux-policy-main entra em conflito com selinux-policy-targeted-extra; portanto, ambos os pacotes não podem ser instalados ao mesmo tempo.

Para máxima segurança, é recomendável definir configurações personalizadas do SELinux.

O pacote zabbix-selinux-policy (zabbix-selinux-policy-main para a versão 10 do AlmaLinux, CentOS Stream, RHEL, Rocky Linux e Oracle Linux) contém uma política básica do SELinux que permite ao Zabbix criar e usar sockets e habilita a conexão do HTTPd ao PostgreSQL (usado pelo frontend).

O arquivo-fonte zabbix_policy.te contém as seguintes regras:

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;

Pacotes Debuginfo

Os pacotes Debuginfo contêm símbolos de depuração para os binários do Zabbix. Eles não são necessários para a instalação ou operação normal, mas são úteis para solução avançada de problemas.

Observe que os pacotes Debuginfo estão disponíveis para as seguintes versões: Red Hat Enterprise Linux 7 e anteriores (incluindo derivados) e SUSE Linux Enterprise Server 15 e anteriores (incluindo derivados).

Para habilitar o repositório zabbix-debuginfo:

  • No RHEL 7, edite /etc/yum.repos.d/zabbix.repo e defina enabled=1 para a seção 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
  • No SUSE, edite /etc/zypp/repos.d/zabbix.repo e defina enabled=1 para a seção 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

Depois de habilitado, instale os pacotes:

  • No RHEL, instale um único pacote com informações de depuração para todos os componentes do Zabbix:
dnf install zabbix-debuginfo
  • No SUSE, instale pacotes debuginfo específicos por componente:
zypper install zabbix-<component>-debuginfo

Habilitando repositórios de versões instáveis

As instruções abaixo são para habilitar repositórios de lançamento instáveis do Zabbix (desativados por padrão), usados para candidatos a lançamento de versões menores do Zabbix.

Primeiro, instale ou atualize para o pacote zabbix-release mais recente. Para habilitar pacotes rc no seu sistema, faça o seguinte:

Red Hat Enterprise Linux

Abra o arquivo /etc/yum.repos.d/zabbix.repo e defina enabled=1 para o repositório 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 o arquivo /etc/apt/sources.list.d/zabbix.list e descomente o "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 o arquivo /etc/zypp/repos.d/zabbix.repo e defina enable=1 para o repositório 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