1 Atualização a partir do código-fonte

Visão geral

Esta seção apresenta as etapas necessárias para realizar uma atualização bem-sucedida do Zabbix 7.2.x para o Zabbix 7.4.x usando fontes oficiais do Zabbix.

Antes da atualização, leia as notas de atualização relevantes!

Você também pode consultar os requisitos da versão 7.4.

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

Processo de atualização do server

1 Parar o server

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

2 Faça backup do banco de dados Zabbix existente

Esta é uma etapa muito importante.
Certifique-se de ter um backup do seu banco de dados.
Ele será útil se o procedimento de atualização falhar (falta de espaço em disco, desligamento, qualquer problema inesperado).

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

Faça uma cópia de backup dos binários do Zabbix, dos arquivos de configuração e do diretório de arquivos PHP.

4 Instalar novos binários do server

Use estas instruções para compilar o server do Zabbix a partir do código-fonte.

5 Revisar os parâmetros de configuração do server

Certifique-se de revisar as Notas de atualização para verificar se são necessárias alterações nos parâmetros de configuração.

Para obter informações sobre novos parâmetros opcionais, consulte a página O que há de novo.

6 Iniciar novos binários do Zabbix

Inicie os novos binários. Verifique os arquivos de log para confirmar se os binários foram iniciados com sucesso.

O Zabbix server atualizará o banco de dados automaticamente. Durante a inicialização, o Zabbix server informa as versões atuais (obrigatória e opcional) e as versões necessárias do banco de dados. Se a versão obrigatória atual for anterior à versão necessária, o Zabbix server executará automaticamente os patches de atualização necessários do banco de dados. O início e o nível de progresso (porcentagem) da atualização do banco de dados são gravados no arquivo de log do Zabbix server. Quando a atualização for concluída, a mensagem "database upgrade fully completed" será gravada no arquivo de log. Se algum patch de atualização falhar, o Zabbix server não será iniciado. O Zabbix server também não será iniciado se a versão obrigatória atual do banco de dados for mais recente que a versão necessária. O Zabbix server será iniciado somente se a versão obrigatória atual do banco de dados corresponder à versão obrigatória necessária.

8673:20161117:104750.259 current database version (mandatory/optional): 03040000/03040000
8673:20161117:104750.259 required mandatory version: 03040000

Antes de iniciar o server:

  • Certifique-se de que o usuário do banco de dados tenha permissões suficientes (criar tabela, excluir tabela, criar índice, excluir índice)
  • Certifique-se de que haja espaço livre suficiente em disco.
7 Instalar uma nova interface web do Zabbix

A versão mínima necessária do PHP é 8.0.0.
Atualize, se necessário, e siga as instruções de instalação.

8 Limpar os cookies e o cache do navegador da web

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

Processo de atualização do proxy

1 Parar o proxy

Pare o proxy Zabbix.

2 Faça backup dos arquivos de configuração e binários do Zabbix proxy

Faça uma cópia de backup do binário do Zabbix proxy e do arquivo de configuração.

3 Instalar novos binários do proxy

Use estas instruções para compilar o proxy do Zabbix a partir do código-fonte.

4 Revisar os parâmetros de configuração do proxy

Certifique-se de revisar as Notas de atualização para verificar se são necessárias alterações nos parâmetros de configuração.

Para obter informações sobre novos parâmetros opcionais, consulte a página O que há de novo.

5 Iniciar o novo proxy do Zabbix

Inicie o novo proxy do Zabbix.
Verifique os arquivos de log para confirmar se o proxy foi iniciado com sucesso.

O proxy do Zabbix atualizará o banco de dados automaticamente.
A atualização do banco de dados ocorre de forma semelhante à inicialização do Zabbix server.

Processo de atualização do agent

A atualização dos agents não é obrigatória. Você só precisa atualizar os agents se isso for necessário para acessar a nova funcionalidade.

O procedimento de atualização descrito nesta seção pode ser usado para atualizar tanto o Zabbix agent quanto o Zabbix agent 2.

1 Parar o agent

Pare o agent do Zabbix.

2 Faça backup dos arquivos de configuração e dos binários do agent Zabbix

Faça uma cópia de backup do binário do agent Zabbix e do arquivo de configuração.

3 Instalar novos binários do agent

Use estas instruções para compilar o agent do Zabbix a partir do código-fonte.

Como alternativa, você pode baixar agents do Zabbix pré-compilados na página de download do Zabbix.

4 Revisar os parâmetros de configuração do agent

Certifique-se de revisar as Notas de atualização para verificar se são necessárias alterações nos parâmetros de configuração.

Para obter informações sobre novos parâmetros opcionais, consulte a página O que há de novo.

5 Iniciar o novo Zabbix agent

Inicie o novo Zabbix agent.
Verifique os arquivos de log para confirmar se o agent foi iniciado com sucesso.

Atualização entre versões secundárias

Ao atualizar entre versões secundárias da 7.4.x (por exemplo, da 7.4.1 para a 7.4.3), é necessário executar as mesmas ações para o server/proxy/agent que durante a atualização entre versões principais. A única diferença é que, ao atualizar entre versões secundárias, nenhuma alteração é feita no banco de dados.