Esta é uma tradução da página de documentação original em inglês. Ajude-nos a torná-la melhor.

Sidebar

Become a monitoring expert!
Sign up for Zabbix training

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.

Não é mais possível iniciar um Zabbix Server atualizado e ter instâncias do Zabbix Proxy mais antigas, ainda não atualizadas reportando dados para este novo Server. Esta abordagem, que nunca foi suportada e nem recomendada pela Zabbix, agora está oficialmente desabilitada. O Zabbix Server irá ignorar os dados enviados de Proxies não atualizados.

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.

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

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

Atualização de Leia as notas de atualização completas Mudanças mais importantes entre as versões
5.4.x Para:
Zabbix 6.0
5.2.x Para:
Zabbix 5.4
Zabbix 6.0
Versões mínimas de banco de dados exigidas elevadas;
Itens agregados removidos como tipo separado.
5.0.x Para:
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Versão mínima requerida para PHP elevada de 7.2.0 para 7.2.5.
4.4.x Para:
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Suporte a IBM DB2 retirado;
Versão mínima requerida para PHP elevada de 5.4.0 para 7.2.0;
Versões mínimas de banco de dados exigidas elevadas;
Alterado diretório de arquivos PHP do Zabbix.
4.2.x Para:
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Jabber, Ez Texting media types removidos.
4.0.x LTS Para:
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Proxies mais antigos não podem mais enviar dados para um Server atualizado;
Agents mais novos não podem mais trabalhar com um Zabbix Server mais antigo.
3.4.x Para:
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Bibliotecas 'libpthread' e 'zlib' agora obrigatórias;
Suporte ao protocolo de texto plano removido e cabeçalho é mandatório;
Versões Pré-1.4 dos Zabbix Agents não são mais suportadas;
Parâmetro Server na configuração de Proxy passivo agora obrigatória.
3.2.x Para:
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Suporte a SQLite como banco de dados removido para Zabbix Server/Frontend;
Expressões Regulares compatíveis com Perl (PCRE) suportadas em vez do POSIX estendido;
Bibliotecas 'libpcre' e 'libevent' obrigatórias para Zabbix Server;
Códigos de saída adicionados para parâmetros de usuário, comandos remotos e itens system.run[] sem o marcador 'nowait' assim como scripts executados do Zabbix Server;
Zabbix Java Gateway tem de ser atualizado para suportar novas funcionalidades.
3.0.x LTS Para:
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Atualização do banco de dados por ser lenta, dependendo do tamanho da tabela de histórico.
2.4.x Para:
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Versão mínima requerida para PHP elevada de 5.3.0 para 5.4.0
Parâmetro LogFile do Agent deve ser especificado
2.2.x LTS Para:
Zabbix 2.4
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Monitoramento distribuído baseado em Node removido
2.0.x Para:
Zabbix 2.2
Zabbix 2.4
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Versão mínima requerida para PHP elevada de 5.1.6 para 5.3.0;
Banco de dados MySQL Case-sensitive requerido para correto funcionamento do Server; Codificação utf8 e utf8_bin necessária para Zabbix Server funcionar corretamente com MySQL. Veja criação de scripts de banco de dados.
Extensão 'mysqli' do PHP necessária em vez de 'mysql'

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

Pode ser útil executar duas sessões SSH paralelas durante a atualização, executando os passos de atualização em uma e monitorando os logs do Server/Proxy em outra. Por exemplo, a execução do comando tail -f zabbix_server.log ou tail -f zabbix_proxy.log na segunda sessão SSH lhe mostrará os últimos registros do arquivo de log conforme eles forem sendo registrados, possibilitando a verificação de possíveis erros em tempo real. Isto pode ser crítico para ambientes de produção.

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

A atualização dos Agents não é obrigatória. Você só precisa atualizar os Agents se exigido para acessar novas funcionalidades.

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.