Notas sobre a instalação a partir de pacotes

Visão geral

Os pacotes oficiais de pré-lançamento do Zabbix 8.2 estarão disponíveis em breve no site do Zabbix, onde você poderá 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 sistema operacional, 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 a partir de repositórios do sistema operacional.

Os pacotes são compatíveis com bancos de dados MySQL/PostgreSQL e com os web servers 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 a partir do mesmo repositório. Para instalar um pacote sem atualizar um pacote instalado do Zabbix server ou proxy, mantenha temporariamente esse pacote em espera 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 nos quais o Security-Enhanced Linux (SELinux) está habilitado, pode ser necessário adicionar regras do SELinux para permitir que o Zabbix crie/use sockets de domínio UNIX no diretório SocketDir. Os arquivos de socket são usados pelo Zabbix server (alerter, preprocessing, IPMI) e pelo Zabbix proxy (IPMI), e estão presentes enquanto o processo está em execução.

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

Para RHEL 7 (e posteriores), AlmaLinux, CentOS Stream, Oracle Linux e 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 Zabbix frontend se conecte ao banco de dados:

setsebool -P httpd_can_network_connect_db on

Para versões do RHEL anteriores à 7:

setsebool -P httpd_can_network_connect on
setsebool -P zabbix_can_network on

Depois de aplicar as configurações do SELinux, reinicie o Apache:

systemctl restart httpd

Opcionalmente, você pode instalar o pacote predefinido zabbix-selinux-policy do Zabbix Official Repository. Esse pacote é fornecido para todas as versões de SO compatíveis, a fim de simplificar a implantação do Zabbix e evitar que os usuários desabilitem o SELinux devido à 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 obter o máximo de 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 de origem 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 a 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 na seção 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
  • No SUSE, edite /etc/zypp/repos.d/zabbix.repo e defina enabled=1 na seção 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

Depois de habilitar o repositório, 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 para cada 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.2/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 remova o comentário de "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

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.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