7 Procedimento de atualização

Visão geral

Esta seção fornece informações de atualização para o Zabbix 7.4:

Instruções relacionadas:

A atualização dos agents do Zabbix é recomendada, mas não obrigatória.

A atualização dos proxies do Zabbix é altamente recomendada. O server do Zabbix oferece suporte total a proxies que sejam da mesma versão principal que o server. O server do Zabbix também oferece suporte a proxies que não sejam mais antigos do que a versão LTS anterior do Zabbix server, mas com funcionalidade limitada (coleta de dados, execução de remote commands, immediate item value checks). A atualização de configuração também fica desativada, e os proxies desatualizados funcionarão apenas com a configuração antiga.

Proxies que são mais antigos do que a versão LTS anterior do Zabbix server ou mais novos do que a versão principal do Zabbix server não são suportados. O Zabbix server irá ignorar dados de proxies não suportados e toda a comunicação com o Zabbix server falhará com um aviso. Para mais informações, consulte Compatibilidade de Versão.

Para minimizar o tempo de inatividade e a perda de dados durante a atualização, recomenda-se parar, atualizar e iniciar o Zabbix server e, em seguida, parar, atualizar e iniciar os proxies Zabbix um após o outro. Durante o tempo de inatividade do server, os proxies em execução continuarão a coletar dados. Assim que o server estiver em funcionamento, os proxies desatualizados enviarão os dados para o novo server (a configuração do proxy não será atualizada, porém) e permanecerão parcialmente funcionais. Quaisquer notificações de problemas durante o tempo de inatividade do Zabbix server serão geradas somente após o server atualizado ser iniciado.

Se o Zabbix proxy for iniciado pela primeira vez e o arquivo do banco de dados SQLite estiver ausente, o proxy o criará automaticamente.

Observe que, se o Zabbix proxy usar SQLite3 e, na inicialização, detectar que a versão do arquivo de banco de dados existente é mais antiga do que a exigida, ele excluirá o arquivo do banco de dados automaticamente e criará um novo. Portanto, os dados de histórico armazenados no arquivo do banco de dados SQLite serão perdidos. Se a versão do Zabbix proxy for mais antiga do que a versão do arquivo de banco de dados, o Zabbix registrará um erro e será encerrado.

Dependendo do tamanho do banco de dados, a atualização do banco de dados para a versão 7.4 pode levar muito tempo.

A atualização direta para o Zabbix 7.4.x é possível a partir do Zabbix 7.2.x, 7.0.x, 6.4.x, 6.2.x, 6.0.x, 5.4.x, 5.2.x, 5.0.x, 4.4.x, 4.2.x, 4.0.x, 3.4.x, 3.2.x, 3.0.x, 2.4.x, 2.2.x e 2.0.x. Para atualizar a partir de versões anteriores, consulte a documentação do Zabbix para 2.0 e anteriores.

Observe que, após a atualização, algumas integrações de software de terceiros no Zabbix podem ser afetadas se o software externo não for compatível com a versão atualizada do Zabbix.

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

Upgrade from Read full upgrade notes Most important changes between versions
7.2.x For:
Zabbix 7.4
Suporte à biblioteca PCRE removido.
7.0.x LTS For:
Zabbix 7.2
Zabbix 7.4
Suporte ao Oracle DB removido.
6.4.x For:
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Versão mínima exigida do PHP aumentada de 7.4.0 para 8.0.0.
Pollers assíncronos para verificações de agent, HTTP agent, SNMP walk[OID] e SNMP get[OID].
Tabela de banco de dados separada para proxies.
Local padrão do arquivo de configuração do agent no Windows alterado.
Oracle DB descontinuado.
Tipo de valor numérico antigo (float) removido.
6.2.x For:
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Versão mínima exigida do MySQL aumentada de 8.0.0 para 8.0.30.
A biblioteca 'libevent_pthreads' é necessária para o Zabbix server/proxy.
Na primeira inicialização após uma atualização, o Zabbix proxy com SQLite3 descarta automaticamente a versão antiga do banco de dados (com todo o histórico) e cria uma nova.
6.0.x LTS For:
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Versão mínima exigida do PHP aumentada de 7.2.5 para 7.4.0.
O monitoramento de serviços foi significativamente reformulado.
Triggers determinísticos precisam ser criados durante a atualização. Se o log binário estiver habilitado para MySQL/MariaDB, isso requer privilégios de superusuário ou a definição do parâmetro de configuração log_bin_trust_function_creators = 1. Consulte Database creation scripts para instruções sobre como definir a variável.
5.4.x For:
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Versões mínimas exigidas do banco de dados aumentadas.
O server/proxy não iniciará se o banco de dados estiver desatualizado.
Registros do log de auditoria perdidos devido à alteração na estrutura do banco de dados.
5.2.x For:
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Versões mínimas exigidas do banco de dados aumentadas.
Itens agregados removidos como um tipo separado.
5.0.x LTS For:
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Versão mínima exigida do PHP aumentada de 7.2.0 para 7.2.5.
O algoritmo de hash de senhas foi alterado de MD5 para bcrypt.
4.4.x For:
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Suporte ao IBM DB2 removido.
Versão mínima exigida do PHP aumentada de 5.4.0 para 7.2.0.
Versões mínimas exigidas do banco de dados aumentadas.
Diretório de arquivos PHP do Zabbix alterado.
4.2.x For:
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Tipos de mídia Jabber e Ez Texting removidos.
4.0.x LTS For:
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Proxies mais antigos não podem mais enviar dados para um server atualizado.
Agents mais novos não poderão mais funcionar com um server Zabbix mais antigo.
3.4.x For:
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
As bibliotecas 'libpthread' e 'zlib' agora são obrigatórias.
Suporte ao protocolo em texto simples removido e o cabeçalho é obrigatório.
Agents Zabbix de versão anterior à 1.4 não são mais suportados.
O parâmetro Server na configuração de proxy passivo agora é obrigatório.
3.2.x For:
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Suporte a SQLite como banco de dados de backend removido para o Zabbix server/frontend.
Expressões Regulares Compatíveis com Perl (PCRE) suportadas em vez de POSIX estendidas.
As bibliotecas 'libpcre' e 'libevent' são obrigatórias para o Zabbix server.
Verificações de código de saída adicionadas para parâmetros de usuário, comandos remotos e itens system.run[] sem a flag 'nowait', bem como para scripts executados pelo Zabbix server.
O Zabbix Java gateway precisa ser atualizado para oferecer suporte à nova funcionalidade.
3.0.x LTS For:
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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
A atualização do banco de dados pode ser lenta, dependendo do tamanho da tabela de histórico.
2.4.x For:
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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Versão mínima exigida do PHP aumentada de 5.3.0 para 5.4.0.
O parâmetro LogFile do agent deve ser especificado.
2.2.x LTS For:
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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Monitoramento distribuído baseado em nós removido.
2.0.x For:
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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Versão mínima exigida do PHP aumentada de 5.1.6 para 5.3.0.
É necessário um banco de dados MySQL com diferenciação entre maiúsculas e minúsculas para o funcionamento adequado do server; o conjunto de caracteres utf8 e a ordenação utf8_bin são necessários para que o Zabbix server funcione corretamente com o banco de dados MySQL. Consulte database creation scripts.
A extensão PHP 'mysqli' é necessária em vez de 'mysql'.