Table of Contents
- 1 Atualização a partir do código-fonte
- Visão geral
- Processo de atualização do server
- 1 Parar o servidor
- 2 Faça backup do banco de dados Zabbix existente
- 3 Faça backup dos arquivos de configuração, arquivos PHP e binários do Zabbix
- 4 Instale os novos binários do servidor
- 5 Revisar os parâmetros de configuração do server
- 6 Inicie os novos binários do Zabbix
- 7 Instale a nova interface web do Zabbix
- 8 Limpe os cookies e o cache do navegador
- Processo de atualização do proxy
- Processo de atualização do agent
- Atualização entre versões secundárias
1 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 servidor
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: 03040000Antes 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.0.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
Não há alterações obrigatórias nesta versão nos parâmetros do proxy.
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
Não há alterações obrigatórias nesta versão nos parâmetros do agent nem do agent 2.
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.