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

Visão geral

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

Antes da atualização, certifique-se de ler as notas de atualização relevantes!

Você também pode querer revisar os requisitos para o 8.0.

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

Processo de atualização do server

1 Parar o servidor

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

2 Faça backup do banco de dados Zabbix existente

Esta é uma etapa muito importante. Certifique-se de que você tem um backup do seu banco de dados. Isso ajudará caso o procedimento de atualização falhe (falta de espaço em disco, desligamento de energia, qualquer problema inesperado).

3 Faça 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, arquivos de configuração e do diretório de arquivos PHP.

4 Instale os novos binários do server

Use estas instruções para compilar o Zabbix server 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 novos parâmetros opcionais, consulte a página O que há de novo.

6 Inicie os novos binários do Zabbix

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

O Zabbix server irá atualizar o banco de dados automaticamente. Ao iniciar, o Zabbix server informa as versões atuais (obrigatórias e opcionais) e as versões exigidas do banco de dados. Se a versão obrigatória atual for mais antiga que a versão exigida, o Zabbix server executa automaticamente os patches de atualização necessários no banco de dados. O início e o nível de progresso (porcentagem) da atualização do banco de dados são registrados no arquivo de log do Zabbix server. Quando a atualização for concluída, uma mensagem "database upgrade fully completed" será registrada no arquivo de log. Se algum dos patches 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 exigida. O Zabbix server só será iniciado se a versão obrigatória atual do banco de dados corresponder à versão obrigatória exigida.

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 (create table, drop table, create index, drop index)
  • Certifique-se de que há espaço livre suficiente em disco.
7 Instale a nova interface web do Zabbix

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

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.

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 Instale os novos binários do proxy

Use estas instruções para compilar o proxy 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 novos parâmetros opcionais, consulte a página O que há de novo.

5 Inicie o novo proxy Zabbix

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

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

Processo de atualização do agent

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

O procedimento de atualização descrito nesta seção pode ser usado para atualizar tanto o agent Zabbix quanto o agent Zabbix 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 Instale os novos binários do agent

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

Como alternativa, você pode baixar agents Zabbix pré-compilados da 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 novos parâmetros opcionais, consulte a página O que há de novo.

5 Inicie o novo agent do Zabbix

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

Atualização entre versões secundárias

Ao atualizar entre versões secundárias do 8.0.x (por exemplo, de 8.0.1 para 8.0.3), é necessário executar as mesmas ações para 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.