Atualização a partir dos fontes

Visão geral

Esta seção provê os passos necessários para uma atualização bem-sucedida do Zabbix 5.4.x para o Zabbix 6.0.x usando os fontes oficiais do Zabbix.

Conquanto a atualização do Zabbix Agent não seja obrigatória (mas recomendada), o Zabbix Server e Proxies devem estar na mesma versão primária (major version). Deste modo, em um ambiente Server-Proxy, o Zabbix Server e todos os Proxies precisam ser parados e atualizados. Manter os Proxies em execução durante a atualização do Server não mais trará qualquer benefício, pois durante a atualização do Proxy seus dados antigos serão descartados e nenhum novo dado será reunido até que a configuração do Proxy seja sincronizada com o Server.

Note que com banco de dados SQLite nos Proxies, dados históricos de antes da atualização serão perdidos, porque a atualização do SQLite não é suportada e o arquivo de banco de dados tem de ser removido manualmente. Quando o Proxy for iniciado pela primeira vez e o arquivo de banco de dados do SQLite estiver ausente, o Proxy o criará automaticamente.

Dependendo do tamanho do banco de dados a atualização para a versão 6.0 pode levar um longo tempo.

As seguintes notas de atualização estão disponíveis:

Também pode ser de seu interesse verificar os requisitos para a versão 6.0.

Processo de atualização do Server

1 Stop server

Pare o Zabbix Server para certificar-se de que nenhum novo dado está sendo gravado no banco de dados.

2 Faça backup do banco de dados Zabbix

Este é um passo muito importante. Certifique-se de que você tem um backup do seu banco de dados. Ele o ajudará se o procedimento de atualização falhar (falta de espaço em disco, desligamento forçado, ou qualquer outro problema inesperado).

3 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

Utilize estas instruções para compilar o Zabbix Server a partir dos fontes.

5 Revise os parâmetros de configuração do Server

Consulte as notas de atualização para detalhes sobre alterações obrigatórias.

Para novos parâmetros opcionais, veja a seção O que há de novo.

6 Inicie os novos binários do Zabbix

Inicie os novos binários. Verifique os arquivos de log para garantia de que os binários subiram corretamente.

O Zabbix Server atualizará automaticamente o banco de dados. Quando iniciando, o Zabbix Server informa as versões de banco de dados atual (mandatório e opcional) e exigida. Se a versão mandatória atual é mais antiga que a versão exigida, o Zabbix Server executa as atualizações do banco de dados necessárias de forma automática. O andamento do processo de atualização (porcentagem) é registrado no arquivo de log do server. Quando a atualização estiver completa, uma mensagem de "atualização de banco de dados completa" é registrada no log. Se algum dos passos de atualização falhar, o Zabbix Server não inicializará. O Zabbix Server também não iniciará se a versão de banco de dados atual for maior que a versão requerida. O Zabbix Server iniciará apenas se a versão atual corresponder à versão necessária.

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

Antes de você iniciar o Server:

• Certifique-se de que o usuário do banco de dados possui permissões suficientes (create table, drop table, create index, drop index)
• Certifique-se de que tenha espaço em disco suficiente
• .

7 Instale a nova interface web do Zabbix

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

8 Limpe os cookies e 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 Pare o Proxy

Para continuar pare o Zabbix Proxy.

2 Backup da configuração e binários do Zabbix Proxy

Faça uma cópia de backup do arquivo de configuração e dos binários do Zabbix Proxy.

3 Instale novo binários do Proxy

Use estas instruções para compilar Zabbix Proxy a partir dos fontes.

4 Revise os parâmetros de configuração do Proxy

Não há alterações obrigatórias aos parâmetros do Zabbix Proxy nesta versão.

5 Inicie o novo ZabbixPproxy

Inicie o novo Zabbix Proxy. Consulte os arquivos de log para garantir que Proxy iniciou corretamente.

O Zabbix proxy atualizará automaticamente o banco de dados. A atualização do banco de dados ocorrerá de maneira semelhante à inicilização do Zabbix Server.

Processo de atualização do Agent

O processo de atualização descrito nesta seção pode ser usado para atualização tanto do Zabbix Agent quanto do Zabbix Agent 2.

1 Pare o Agent

Para prosseguir com a atualização pare o Zabbix Agent.

2 Backup da configuração e binários do Zabbix Agent

Faça uma cópia de backup do arquivo de configuração e dos binários do Zabbix Agent.

3 Instale novos binários do Agent

Use estas instruções para compilar o Zabbix Agent a partir dos fontes.

Alternativamente, você pode baixar os Zabbix Agents pré-compilados da página de download da Zabbix.

4 Revise os parâmetros de configuração do Agent

Não há alterações obrigatórias nos parâmetros desta versão do Agent e nem do Agent 2.

5 Inicie o novo Zabbix Agent

Inicie o novo Zabbix Agent. Confirme nos arquivos de log se o Agent iniciou corretamente.

Atualização entre versão secundárias (minor versions)

Quando atualizando entre versões secundárias do Zabbix 6.0.x (por exemplo de 6.0.1 para 6.0.3) é necessário executar as mesmas ações para o Zabbix Server/Proxy/Agent assim como durante a atualização entre versões primárias (major versions). A única diferença é que quando atualizando entre versões secundárias nenhuma alteração de banco de dados é feita.