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

Sidebar

1 Red Hat Enterprise Linux/CentOS

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 pacotes oficiais da Zabbix para Red Hat Enterprise Linux/CentOS.

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.

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.

Procedimento de atualização

1 Pare os processos do Zabbix

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

# systemctl stop zabbix-server

Se atualizando o Zabbix Proxy, pare-o também.

# systemctl stop zabbix-proxy

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.

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.

Arquivos de configuração:

# mkdir /opt/zabbix-backup/
       # cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
       # cp /etc/httpd/conf.d/zabbix.conf  /opt/zabbix-backup/

Arquivos PHP e binários do Zabbix:

# cp -R /usr/share/zabbix/ /opt/zabbix-backup/
       # cp -R /usr/share/doc/zabbix-* /opt/zabbix-backup/
4 Atualize o pacote de configuração de repositório

Para prosseguir com a atualização seu pacote de repositório atual tem de ser atualizado.

# rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/zabbix-release-6.0-1.el8.noarch.rpm
5 Atualize os componentes do Zabbix

Para atualizar os componentes do Zabbix você deve executar algo como:

# yum upgrade zabbix-server-mysql zabbix-web-mysql zabbix-agent

Se usando PostgreSQL, substitua mysql por pgsql no comando. Se atualizando o Proxy, substitua server por proxy no comando. Se atualizando o Agent 2, substitua zabbix-agent por zabbix-agent2 no comando.

Para atualizar corretamente o Zabbix Frontend com Apache no RHEL 8, execute também:

# yum install zabbix-apache-conf 

e faça as alterações necessárias nesse arquivo.

Para atualizar o Zabbix Frontend no RHEL 7 siga as instruções específicas da distribuição (etapas extras são necessárias para instalar o PHP 7.2 ou maior).

6 Revise os parâmetros de configuração dos componentes

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

7 Inicie os processos do Zabbix

Inicie os componentes do Zabbix atualizados.

# systemctl start zabbix-server
       # systemctl start zabbix-proxy
       # systemctl start zabbix-agent
       # systemctl start zabbix-agent2
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.

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

É possível atualizar entre versões secundárias do Zabbix 6.0.x (por exemplo, de 6.0.1 para 6.0.3). A atualização entre versões secundárias é fácil.

Para proceder com a atualização de versão secundária do Zabbix é necessário executar:

$ sudo yum upgrade 'zabbix-*'

Para atualizar a versão secundária do Zabbix Server, execute:

$ sudo yum upgrade 'zabbix-server-*'

Para atualizar a versão secundária do Zabbix Agent, utilize:

$ sudo yum upgrade 'zabbix-agent-*'

ou, para Zabbix Agent 2:

$ sudo yum upgrade 'zabbix-agent2-*'

Note que você também pode usar 'update' em vez de 'upgrade' nestes comandos. Enquanto 'upgrade' eliminará os pacotes obsoletos, 'update' os preservará.