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:
- Red Hat Enterprise Linux (usando pacotes)
- Debian/Ubuntu (usando pacotes)
- Atualização usando contêineres
- Atualização usando código-fonte
Instruções relacionadas:
- Para servers em um cluster de alta disponibilidade (HA), consulte Atualizando o cluster HA
- Para o banco de dados TimescaleDB, consulte Atualizando o esquema do TimescaleDB
Componentes a atualizar
A atualização dos Zabbix agents é recomendada, mas não obrigatória.
A atualização dos Zabbix proxies é altamente recomendada.
O Zabbix server oferece suporte completo a proxies que tenham a mesma versão principal do server.
O Zabbix server também oferece suporte a proxies que não sejam mais antigos que a versão LTS anterior do Zabbix server, mas com funcionalidade limitada (coleta de dados, execução de comandos remotos, verificações imediatas de valores de itens).
A atualização da configuração também é desabilitada, e os proxies desatualizados funcionarão somente com a configuração antiga.
Proxies mais antigos que a versão LTS anterior do Zabbix server ou mais recentes que a versão principal do Zabbix server não são compatíveis. O Zabbix server ignorará os dados de proxies não compatíveis, e toda a comunicação com o Zabbix server falhará com um aviso. Para obter mais informações, consulte Compatibilidade de versões.
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 do Zabbix um após o outro. Durante o tempo de inatividade do server, os proxies em execução continuarão coletando dados. Quando o server estiver em funcionamento novamente, os proxies desatualizados enviarão os dados para o server mais recente (a configuração do proxy, no entanto, não será atualizada) e permanecerão parcialmente funcionais. Todas as notificações de problemas ocorridos durante o tempo de inatividade do Zabbix server serão geradas somente após a inicialização do server atualizado.
Se o proxy do Zabbix for iniciado pela primeira vez e o arquivo do banco de dados SQLite estiver ausente, o proxy o criará automaticamente.
Observe que, se o proxy do Zabbix usar SQLite3 e detectar, durante a inicialização, que a versão do arquivo de banco de dados existente é mais antiga 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 do banco de dados SQLite serão perdidos. Se a versão do proxy do Zabbix for mais antiga 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 8.0 poderá levar bastante tempo.
Notas de atualização
A atualização direta para o Zabbix 8.0.x é compatível a partir das versões 2.0.x.
Para atualizar a partir de versões anteriores, consulte a documentação do Zabbix para a versão 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 caso o software externo não seja 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'. |