Table of Contents

2 Debian/Ubuntu

2 Debian/Ubuntu

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 Debian/Ubuntu.

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 servidor Zabbix para garantir que nenhum novo dado seja inserido no banco de dados:

systemctl stop zabbix-server

Se estiver atualizando o proxy, agent ou agent 2 do Zabbix, 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 de 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/apache2/conf-enabled/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, desinstale o pacote de repositório Zabbix atual:

rm -Rf /etc/apt/sources.list.d/zabbix.list

Você também pode precisar remover manualmente quaisquer pacotes antigos do Zabbix do seu diretório de trabalho (por exemplo, rm zabbix-release_latest+debian12_all.deb) antes de baixar o novo, para evitar que o gerenciador de pacotes reutilize uma versão desatualizada durante o processo de atualização.

Em seguida, instale o pacote de configuração do repositório mais recente para garantir a compatibilidade com os pacotes mais novos e incluir quaisquer correções de segurança ou bugs recentes.

No Debian 12, execute:

wget https://repo.zabbix.com/zabbix/8.0/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
       dpkg -i zabbix-release_latest+debian12_all.deb

Para versões mais antigas do Debian, substitua o link acima pelo correto do repositório Zabbix. Observe, no entanto, que os pacotes para essas versões podem não incluir todos os componentes do Zabbix e, para atualizar esses componentes a partir de pacotes, considere atualizar seu sistema operacional. Para uma lista de componentes incluídos, consulte Pacotes Zabbix.

No Ubuntu 24.04, execute:

wget https://repo.zabbix.com/zabbix/8.0/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb
       dpkg -i zabbix-release_latest+ubuntu24.04_all.deb

No Ubuntu 22.04, execute:

wget https://repo.zabbix.com/zabbix/8.0/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb
       dpkg -i zabbix-release_latest+ubuntu22.04_all.deb

Para versões mais antigas do Ubuntu, substitua o link acima pelo correto do repositório Zabbix. Observe, no entanto, que os pacotes para essas versões podem não incluir todos os componentes do Zabbix e, para atualizar esses componentes a partir de pacotes, considere atualizar seu sistema operacional. Para uma lista de componentes incluídos, consulte Pacotes Zabbix.

Você pode ver um prompt sobre a configuração do repositório Zabbix:

Configuration file '/etc/apt/sources.list.d/zabbix.list'
       ==> Deleted (by you or by a script) since installation.
       ==> Package distributor has shipped an updated version.
       What would you like to do about it ?  Your options are:
       Y or I  : install the package maintainer's version
       N or O  : keep your currently-installed version
       D       : show the differences between the versions
       Z       : start a shell to examine the situation
       The default action is to keep your current version.
       *** zabbix.list (Y/I/N/O/D/Z) [default=N] ?

Digite Y (ou I) para instalar a versão do mantenedor do pacote da configuração do repositório Zabbix.

Em seguida, atualize as informações do repositório:

apt update

5 Atualizar componentes do Zabbix

Para atualizar os componentes do Zabbix, execute:

apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent

Se estiver usando PostgreSQL, substitua mysql por pgsql no comando.
Se estiver atualizando o proxy, substitua server por proxy no comando.
Se estiver atualizando o Zabbix agent 2, substitua zabbix-agent por zabbix-agent2 zabbix-agent2-plugin-* no comando.

Atualizar o Zabbix agent 2 com o comando apt install zabbix-agent2 pode levar a um erro. Para mais informações, consulte Problemas conhecidos.

Você pode ver um prompt sobre a configuração do Zabbix server (ou proxy):

Configuration file '/etc/zabbix/zabbix_server.conf'
       ==> Modified (by you or by a script) since installation.
       ==> Package distributor has shipped an updated version.
       What would you like to do about it ?  Your options are:
       Y or I  : install the package maintainer's version
       N or O  : keep your currently-installed version
       D       : show the differences between the versions
       Z       : start a shell to examine the situation
       The default action is to keep your current version.
       *** zabbix_server.conf (Y/I/N/O/D/Z) [default=N] ?

Digite a opção que melhor se encaixa na sua situação. Por exemplo, digite D para comparar a configuração atual e a nova, depois decida se deseja instalar a versão do mantenedor do pacote (Y ou I).

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

apt install zabbix-apache-conf
       systemctl restart apache2

6 Revisar os parâmetros de configuração dos componentes

Revise as notas de atualização relevantes para verificar se são necessárias alterações nos parâmetros de configuração.

Para novos parâmetros opcionais, consulte a página O que há de novo.

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

Primeiro, atualize as informações do repositório:

apt update

Em seguida, para atualizar todos os componentes do Zabbix, execute:

apt install --only-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.

Documentation