Atualização

Antes de atualizar, é altamente recomendável consultar todas as notas de atualização relevantes.

Também será útil saber quais componentes você deve atualizar.

Visão geral

Instruções de atualização passo a passo estão disponíveis para:

Instruções relacionadas:

Componentes para atualizar

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

A atualização dos proxies Zabbix é altamente recomendada. O server Zabbix oferece suporte total a proxies que sejam da mesma versão principal do server. O server Zabbix também oferece suporte a proxies que sejam não mais antigos do que a versão da LTS anterior do server Zabbix, mas com funcionalidade limitada (coleta de dados, execução de comandos remotos, verificações imediatas de valores de item). A atualização da configuração também é desabilitada, e 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 de banco de dados SQLite estiver ausente, o proxy o criará automaticamente.

Observe que se o Zabbix proxy usar SQLite3 e, ao iniciar, detectar que a versão do arquivo de banco de dados existente é mais antiga do que a necessária, ele excluirá o arquivo de banco de dados automaticamente e criará um novo. Portanto, os dados históricos armazenados no arquivo de 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 encerrará.

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

Notas de atualização

A atualização direta para o Zabbix 8.0.x é suportada a partir das versões 2.0.x. Para atualizar a partir de versões anteriores, consulte a documentação do Zabbix para 2.0 e anteriores.

Esteja ciente de 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:

Atualização de Leia as notas completas de atualização Alterações mais importantes entre as versões
7.4.x Para:
Zabbix 8.0
Os Zabbix agents anteriores à versão 1.6 não são mais compatíveis.
As versões mínimas exigidas dos bancos de dados foram aumentadas.
A versão mínima exigida do PHP foi aumentada de 8.0.0 para 8.2.0.
O caractere % foi adicionado à lista UnsafeUserParameters do Zabbix agent e do Zabbix agent 2.
7.2.x Para:
Zabbix 7.4
Zabbix 8.0
O suporte à biblioteca PCRE foi removido.
7.0.x Para:
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
O suporte ao Oracle DB foi removido.
6.4.x Para:
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
A versão mínima exigida do PHP foi 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.
A localização padrão do arquivo de configuração do agent do Windows foi alterada.
Oracle DB obsoleto.
O tipo de valor numérico antigo (float) foi removido.
6.2.x Para:
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
A versão mínima exigida do MySQL foi 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 remove automaticamente a versão antiga do banco de dados (com todo o histórico) e cria uma nova.
6.0.x LTS Para:
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
A versão mínima exigida do PHP foi 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 registro binário estiver habilitado para MySQL/MariaDB, isso exigirá privilégios de superusuário ou a definição da variável/parâmetro de configuração log_bin_trust_function_creators = 1. Consulte Scripts de criação do banco de dados para obter instruções sobre como definir a variável.
5.4.x Para:
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
As versões mínimas exigidas dos bancos de dados foram aumentadas.
O server/proxy não será iniciado se o banco de dados estiver desatualizado.
Registros do log de auditoria foram perdidos devido à alteração na estrutura do banco de dados.
5.2.x Para:
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
As versões mínimas exigidas dos bancos de dados foram aumentadas.
Os itens agregados foram removidos como um tipo separado.
5.0.x LTS Para:
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
A versão mínima exigida do PHP foi aumentada de 7.2.0 para 7.2.5.
O algoritmo de hash de senhas foi alterado de MD5 para bcrypt.
4.4.x Para:
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
Zabbix 8.0
O suporte ao IBM DB2 foi removido.
A versão mínima exigida do PHP foi aumentada de 5.4.0 para 7.2.0.
As versões mínimas exigidas dos bancos de dados foram aumentadas.
O diretório dos arquivos PHP do Zabbix foi alterado.
4.2.x Para:
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
Zabbix 8.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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
Proxies mais antigos não poderão mais enviar dados para um server atualizado.
Agents mais recentes não poderão 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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
As bibliotecas 'libpthread' e 'zlib' agora são obrigatórias.
O suporte ao protocolo de texto simples foi removido e o cabeçalho é obrigatório.
Os Zabbix agents anteriores à versão 1.4 não são mais compatíveis.
O parâmetro Server na configuração de proxy passivo agora é 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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
O suporte ao SQLite como banco de dados de backend foi removido para o Zabbix server/frontend.
Expressões regulares compatíveis com Perl (PCRE) são usadas em vez das expressões estendidas POSIX.
As bibliotecas 'libpcre' e 'libevent' são obrigatórias para o Zabbix server.
Foram adicionadas verificações do código de saída 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 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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
A atualização do banco de dados pode 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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
A versão mínima exigida do PHP foi aumentada de 5.3.0 para 5.4.0.
O 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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
O monitoramento distribuído baseado em nós foi 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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
A versão mínima exigida do PHP foi aumentada de 5.1.6 para 5.3.0.
É necessário um banco de dados MySQL que diferencie maiúsculas de minúsculas para o funcionamento correto 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 scripts de criação do banco de dados.
A extensão PHP 'mysqli' é necessária em vez de 'mysql'.