1 Red Hat Enterprise Linux

Visão geral

Esta seção oferece as etapas necessárias para uma atualização de sucesso upgrade do Zabbix 5.4.x para o Zabbix 6.0.x, usando os pacotes oficiais do Zabbix para Red Hat Enterprise Linux.

Embora a atualização dos agentes Zabbix não seja obrigatória (mas recomendada), o servidor e proxies Zabbix devem estar na mesma versão same major version. Portanto, em uma configuração servidor-proxy, o servidor e todos os proxies Zabbix devem ser pausados e atualizados. Manter os proxies em execução durante a atualização do servidor não trará nenhum benefício, pois durante a atualização do proxy, os dados antigos serão descartados e nenhum dado novo será coletado até que a configuração do proxy seja sincronizada com o servidor.

Observe que, com um banco de dados SQLite em proxies, os dados de histórico dos proxies anteriores à atualização serão perdidos, pois a atualização do banco de dados SQLite não é suportada e o arquivo de banco de dados SQLite deve ser removido manualmente. Quando o proxy é iniciado pela primeira vez e o arquivo de banco de dados SQLite está ausente, o proxy o cria automaticamente.

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

Antes de iniciar a atualização, leia as notas de atualização relevantes.

Notas de atualização!

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

Upgrade from Leia todas as notas de atualização As mudanças mais importantes entre as versões
5.4.x Para:
Zabbix 6.0
As versões mínimas do banco de dados necessários foram aumentadas;
O Servidor/proxy não irá iniciar se o banco de dados estiver desatualizado;
Registros de log de auditoria perdidos devido a mudança na estrutra do banco de dados.
5.2.x Para:
Zabbix 5.4
Zabbix 6.0
As versões mínimas do banco de dados necessários foram aumentadas;
Itens agregados removidos como um tipo separado.
5.0.x LTS Para:
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Versão mínima do PHP exigida aumentada de 7.2.0 para 7.2.5.
4.4.x Para:
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
O suporte do IBM DB2 foi descontinuado;
Versão mínima do PHP exigida aumentada de 5.4.0 para 7.2.0;
As versões mínimas requeridas de banco de dados foram aumentadas;
O diretório de arquivo PHP do Zabbix foi alterado.
4.2.x Para:
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Os tipos de mídia Jabber e Ez Texting foram 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 antigos não conseguem mais reportar dados para um servidor atualizado;
Agentes mais novos não serão mais capazes de funcionar com um servidor Zabbix 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 são obrigatórias;
O suporte para o protocolo de texto simples foi removido e o cabeçalho é obrigatório;
Os agentes Zabbix versão Pre-1.4 não são mais suportados;
Agora, o parâmetro do servidor na configuração do proxy passivo é obrigatório.
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
O suporte ao SQLite e o banco de dados de backend forão removidos para o servidor/frontend do Zabbix;
Expressões regulares compatíveis com Perl (PCRE) são suportadas em vez de POSIX estendido;
as bibliotecas 'libpcre' e 'libevent'são obrigatórias para o servidor Zabbix;
Verificações de codigo de saída para os parâmetros de usuário foram adicionadas, comandos remotos e itens system.run[] sem a flag 'nowait' assim como os scrips executados pelo servidor Zabbix;
Zabbix Java gateway precisa ser atualizado para suportar nova funcionalidade.
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
A atualização do banco de dados pode ser lenta, dependendo do tamanho da tabela do 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
A versão mínima do PHP requerida foi aumentada de 5.3.0 para 5.4.0
O parâmetro LogFile do agente 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 nós 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 do PHP aumentada de 5.1.6 para 5.3.0;
Um banco de dados MySQL que diferencia maísuculas de minúsculas é necessário para o correto funcionamente do servidor; o conjunto de carácteres utf8 e a ordenação utf8_bin são necessários para que o servidor Zabbix funcione corretamente com o banco de dados MySQL. Ver database creation scripts.
Extensão 'mysqli' PHP é necessária em vez de 'mysql'.

Você também pode desejar verificar o requirements para 6.0.

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

Procedimento de atualização

1 Pausar os processos Zabbix

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

systemctl stop zabbix-server

If upgrading the proxy, stop proxy too.

systemctl stop zabbix-proxy

It is no longer possible to start the upgraded server and have older and unupgraded proxies report data to a newer server. This approach, which was never recommended nor supported by Zabbix, now is officially disabled, as the server will ignore data from unupgraded proxies.

2 Back up do banco de dados existente Zabbix

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

3 Backup dos arquivos de configuração, arquivos PHP e binários Zabbix

Realize uma cópia do backup binários Zabbix, dos 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/

Arquivo de PHP files e binários Zabbix:

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

Antes de prosseguir com a atualização, atualizar seu pacote do repositório atual. Em RHEL 9, execute:

rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/9/x86_64/zabbix-release-latest.el9.noarch.rpm

(Para versões RHEL anteriores, substituir o link acima pelo link correto a partir do Zabbix repository).

5 Atualizar componentes Zabbix

Para atualizar os componentes Zabbix, você pode executar algo semelhante a:

dnf upgrade zabbix-server-mysql zabbix-web-mysql zabbix-agent

Caso esteja utilizando PostgreSQL, substitua mysql por pgsql no comando. Caso esteja atualizando o proxy, substitua o server porproxy no comando. Caso esteja atualizando o agente 2, substitua o zabbix-agent por zabbix-agent2 no comando.

Atualizar o agente 2 Zabbix com o comando dnf install zabbix-agent2 , pode levar a um erro. Para mais informações, ver Known issues.

Para atualizar o web frontend com Apache on RHEL 8 corretamente, execute também:

dnf install zabbix-apache-conf
6 Revisar parâmetros de configuração do componente

Assegure-se de revisar as notas de atualização Upgrade notes para verificar se alguma mudança dos parâmetros de configuração é necessária.

7 Inicie os processos Zabbix

Inicie a atualização dos componentes Zabbix.

systemctl start zabbix-server
       systemctl start zabbix-proxy
       systemctl start zabbix-agent
       systemctl start zabbix-agent2
Limpar os cookies e cache do navegador

Após a atualização, pode ser necessário limpar os cookies e cache do navegador para que a interface do Zabbix funcione corretamente.

Atualização entre versões menores

É possível fazer atualização entre versões menores de 6.0.x (por exemplo, de 6.0.1 para 6.0.3). Fazer atualização entre as versões menores é simples.

Para executar a atualização da versão menor do Zabbix, é necessário executar:

sudo dnf upgrade 'zabbix-*'

Para executar a atualização da versão menor do servidor Zabbix, execute:

sudo dnf upgrade 'zabbix-server-*'

Para executar o a atualização do agente da versão menor do Zabbix, execute:

sudo dnf upgrade 'zabbix-agent-*'

ou, para o agente 2 do Zabbix:

sudo dnf upgrade 'zabbix-agent2-*'