- 2 Debian/Ubuntu
- Visão geral
- Procedimento de atualização
- 1 Pare os processos do Zabbix
- 2 Faça backup do banco de dados do Zabbix
- 3 Faça backup dos arquivos de configuração do Zabbix, arquivos PHP e binários do Zabbix
- 4 Atualizar o pacote de configuração do repositório
- 5 Atualizar os componentes do Zabbix
- 6 Revisar os parâmetros de configuração do componente
- 7 Inicie os processos do Zabbix
- 8 Limpe os cookies e o cache do navegador
- Atualização entre versões menores
2 Debian/Ubuntu
Visão geral
Esta seção fornece instruções para atualizar do Zabbix 7.2.x para a versão mais recente do Zabbix 7.4.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 do Zabbix 7.4.
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 mais recentes do log e possíveis erros em tempo real.
Isso pode ser crítico para instâncias de produção.
Para instruções sobre a atualização entre versões menores do Zabbix 7.4.x (por exemplo, de 7.4.1 para 7.4.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-serverSe 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-agent22 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, dos arquivos PHP e dos binários do Zabbix.
Para os arquivos de configuração, execute:
mkdir /opt/zabbix-backup/
cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
# Para Apache:
cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/
# Para Nginx:
cp /etc/nginx/conf.d/zabbix.conf /opt/zabbix-backup/
cp /etc/zabbix/nginx.conf /opt/zabbix-backup/Para os arquivos PHP e os 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 atual do repositório do Zabbix:
rm -Rf /etc/apt/sources.list.d/zabbix.listTambém pode ser necessário 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 pacote, para evitar que o gerenciador de pacotes reutilize uma versão desatualizada durante o processo de atualização.
Em seguida, instale o pacote mais recente de configuração do repositório para garantir a compatibilidade com os pacotes mais recentes e incluir quaisquer correções de segurança ou de bugs recentes.
No Debian 13, execute:
wget https://repo.zabbix.com/zabbix/7.4/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian13_all.deb
dpkg -i zabbix-release_latest+debian13_all.debNo Debian 12, execute:
wget https://repo.zabbix.com/zabbix/7.4/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
dpkg -i zabbix-release_latest+debian12_all.debPara versões mais antigas do Debian, substitua o link acima pelo link correto do repositório do Zabbix. Observe, no entanto, que os pacotes para essas versões podem não incluir todos os componentes do Zabbix. Para atualizar esses componentes a partir dos pacotes, considere atualizar seu sistema operacional. Para obter uma lista dos componentes incluídos, consulte Pacotes do Zabbix.
No Ubuntu 26.04, execute:
wget https://repo.zabbix.com/zabbix/7.4/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu26.04_all.deb
dpkg -i zabbix-release_latest+ubuntu26.04_all.debNo Ubuntu 24.04, execute:
wget https://repo.zabbix.com/zabbix/7.4/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb
dpkg -i zabbix-release_latest+ubuntu24.04_all.debNo Ubuntu 22.04, execute:
wget https://repo.zabbix.com/zabbix/7.4/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb
dpkg -i zabbix-release_latest+ubuntu22.04_all.debPara versões mais antigas do Ubuntu, substitua o link acima pelo link correto do repositório do Zabbix. Observe, no entanto, que os pacotes para essas versões podem não incluir todos os componentes do Zabbix. Para atualizar esses componentes a partir dos pacotes, considere atualizar seu sistema operacional. Para obter uma lista dos componentes incluídos, consulte Pacotes do Zabbix.
Você poderá ver uma solicitação sobre a configuração do repositório do 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 do Zabbix.
Em seguida, atualize as informações do repositório:
apt update5 Atualizar os 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
mysqlporpgsqlno comando. - Se estiver atualizando o proxy, substitua
serverporproxyno comando. - Se estiver atualizando o Zabbix agent 2, substitua
zabbix-agentporzabbix-agent2 zabbix-agent2-plugin-*no comando.
Atualizar o Zabbix agent 2 com o comando apt install zabbix-agent2 pode causar um erro.
Para obter mais informações, consulte Problemas conhecidos.
Você poderá ver uma solicitação 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] ?Insira a opção que melhor se aplica à sua situação.
Por exemplo, insira D para comparar a configuração atual com a nova e, em seguida, decida se deseja instalar a versão do mantenedor do pacote (Y ou I).
Em seguida, atualize o frontend do Zabbix e reinicie o web server.
Para Apache, execute:
apt install zabbix-apache-conf
systemctl restart apache2Para Nginx, execute:
apt install zabbix-nginx-conf
systemctl restart nginxPara Nginx, você poderá ver uma solicitação sobre o arquivo de configuração nginx.conf.
Insira a opção que melhor se aplica à sua situação:
Configuration file '/etc/zabbix/nginx.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.
*** nginx.conf (Y/I/N/O/D/Z) [default=N] ?Se, após a atualização, você precisar instalar um pacote adicional do Zabbix a partir do mesmo repositório, o apt poderá selecionar atualizações para pacotes do Zabbix já instalados durante a resolução de dependências.
Para evitar a atualização de 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-mysql6 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.
Se estiver usando o Nginx como web server e o arquivo de configuração /etc/zabbix/nginx.conf foi reinstalado durante a atualização, revise o arquivo e atualize as diretivas listen e server_name para corresponder à configuração do seu frontend do Zabbix.
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-agent28 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 menores
É possível atualizar entre versões menores do Zabbix 7.4.x (por exemplo, da 7.4.1 para a 7.4.3).
Primeiro, atualize as informações do repositório:
apt updateEm 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.