Red Hat Enterprise Linux

Visão geral

Esta seção fornece instruções para atualizar do Zabbix 7.4.x para a versão mais recente do Zabbix 8.0.x usando os pacotes oficiais do Zabbix para Red Hat Enterprise Linux ou seus derivados - AlmaLinux, CentOS Stream, Oracle Linux e Rocky Linux.

Antes de atualizar, revise as notas de atualização relevantes e certifique-se de que seu sistema atende aos requisitos para o Zabbix 8.0.

Considere executar duas sessões SSH paralelas durante a atualização: uma para executar as etapas de atualização e outra para monitorar os logs do server/proxy. Por exemplo, execute tail -f zabbix_server.log ou tail -f zabbix_proxy.log na segunda sessão para visualizar as entradas de log mais recentes e possíveis erros em tempo real. Isso pode ser crítico para instâncias de produção.

Para instruções sobre como atualizar entre versões menores do Zabbix 8.0.x (por exemplo, de 8.0.1 para 8.0.3), consulte Atualização entre versões menores.

Procedimento de atualização

1 Pare os processos do Zabbix

Pare o Zabbix server para garantir que nenhum novo dado seja inserido no banco de dados:

systemctl stop zabbix-server

Se estiver atualizando o Zabbix proxy, agent ou agent 2, pare esses componentes também:

systemctl stop zabbix-proxy
systemctl stop zabbix-agent
systemctl stop zabbix-agent2
2 Faça backup do banco de dados do Zabbix

Faça backup do seu banco de dados Zabbix existente para se proteger contra falhas na atualização (por exemplo, problemas de espaço em disco, falta de energia ou problemas inesperados).

3 Faça backup dos arquivos de configuração do Zabbix, arquivos PHP e binários do Zabbix

Faça backup dos arquivos de configuração existentes do Zabbix, arquivos PHP e binários do Zabbix.

Para os arquivos de configuração, execute:

mkdir /opt/zabbix-backup/
cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
cp /etc/httpd/conf.d/zabbix.conf  /opt/zabbix-backup/

Para arquivos PHP e binários do Zabbix, execute:

cp -R /usr/share/zabbix/ /opt/zabbix-backup/
cp -R /usr/share/zabbix-* /opt/zabbix-backup/
4 Atualizar o pacote de configuração do repositório

Antes de prosseguir com a atualização, atualize o pacote do repositório atual para a versão mais recente, a fim de garantir a compatibilidade com os pacotes mais novos e incluir quaisquer patches de segurança ou correções de bugs recentes.

No RHEL 10, execute:

rpm -Uvh https://repo.zabbix.com/zabbix/8.0/release/rhel/10/noarch/zabbix-release-latest.el10.noarch.rpm

Se você estiver atualizando o Zabbix proxy no RHEL 10 e quiser usar APM, instale também o repositório EPEL e habilite o repositório CRB, pois ambos fornecem dependências para o pacote de APM do Zabbix proxy:

dnf -y install epel-release || dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-$(rpm -E %rhel).noarch.rpm
crb enable

No RHEL 9, execute:

rpm -Uvh https://repo.zabbix.com/zabbix/8.0/release/rhel/9/noarch/zabbix-release-latest.el9.noarch.rpm

Para versões mais antigas do RHEL ou seus derivados, substitua o link acima pelo link correto disponível no repositório do Zabbix. Observe, no entanto, que os pacotes dessas versões podem não incluir todos os componentes do Zabbix. Para atualizar esses componentes a partir de pacotes, considere atualizar o sistema operacional. Para obter uma lista dos componentes incluídos, consulte Pacotes do Zabbix.

Em seguida, limpe o cache do gerenciador de pacotes dnf (incluindo cabeçalhos, metadados e arquivos de pacotes baixados durante instalações ou atualizações anteriores):

dnf clean all

Na próxima operação do dnf, o dnf baixará metadados atualizados dos repositórios, pois os metadados antigos foram removidos.

Consulte também: Problemas conhecidos para atualizar o pacote de configuração do repositório no RHEL.

5 Atualização dos componentes do Zabbix

Para atualizar os componentes do Zabbix, execute:

dnf install zabbix-server-mysql zabbix-web-mysql zabbix-selinux-policy zabbix-agent
  • Se estiver usando PostgreSQL, substitua mysql por pgsql no comando.
  • Se estiver atualizando o proxy, substitua server por proxy no comando.
  • Se você tiver o RHEL 10 e quiser usar APM, adicione -apm ao nome do pacote do proxy (por exemplo, zabbix-proxy-mysql-apm).
  • Se estiver atualizando o agent 2, substitua zabbix-agent por zabbix-agent2 zabbix-agent2-plugin-* no comando.
  • Se houver outros pacotes do Zabbix instalados, considere atualizá-los também, incluindo-os no comando.

Atualizar o agent 2 do Zabbix com o comando dnf install zabbix-agent2 pode resultar em um erro. Para obter mais informações, consulte Problemas conhecidos.

Em seguida, para atualizar o frontend do Zabbix com o Apache e reiniciar o Apache, execute:

dnf install zabbix-apache-conf
systemctl restart httpd
6 Revisar os parâmetros de configuração do componente

Revise as notas de atualização relevantes para verificar se alguma alteração nos parâmetros de configuração é necessária.

Para novos parâmetros opcionais, consulte a página Novidades.

7 Inicie os processos do Zabbix

Inicie os componentes do Zabbix atualizados:

systemctl start zabbix-server
systemctl start zabbix-proxy
systemctl start zabbix-agent
systemctl start zabbix-agent2
8 Limpe os cookies e o cache do navegador

Após a atualização, pode ser necessário limpar os cookies e o cache do navegador para que a interface web do Zabbix funcione corretamente.

Atualização entre versões secundárias

É possível atualizar entre versões secundárias do Zabbix 8.0.x (por exemplo, de 8.0.1 para 8.0.3).

Para atualizar todos os componentes do Zabbix, execute:

dnf upgrade 'zabbix-*'
  • Para atualizar apenas o Zabbix server, substitua 'zabbix-*' por 'zabbix-server-*' no comando.
  • Para atualizar apenas o Zabbix proxy, substitua 'zabbix-*' por 'zabbix-proxy-*' no comando.
  • Para atualizar apenas o Zabbix agent, substitua 'zabbix-*' por 'zabbix-agent-*' no comando.
  • Para atualizar apenas o Zabbix agent 2, substitua 'zabbix-*' por 'zabbix-agent2-*' no comando.