4 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 containers
- Atualização usando fontes
Instruções relacionadas:
- Para servidores em um cluster de alta disponibilidade (HA), veja Atualizando cluster HA
- Para o banco de dados TimescaleDB, veja Atualizando o schema do TimescaleDB
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 versões |
|---|---|---|
| 7.4.x | Para: Zabbix 8.0 |
As versões mínimas exigidas de banco de dados foram elevadas. A versão mínima exigida do PHP foi elevada de 8.0.0 para 8.2.0. O caractere % foi adicionado à lista UnsafeUserParameters para Zabbix agent e 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 elevada de 7.4.0 para 8.0.0. Pollers assíncronos para verificações de agent, agent HTTP, SNMP walk[OID] e SNMP get[OID]. Tabela de banco de dados separada para proxies. O local padrão do arquivo de configuração do agent no Windows foi alterado. Oracle DB descontinuado. 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 elevada de 8.0.0 para 8.0.30. A biblioteca 'libevent_pthreads' é obrigatória para o Zabbix server/proxy. No primeiro início 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 elevada 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 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 de banco de dados foram elevadas. O server/proxy não iniciará 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 de banco de dados foram elevadas. Items 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 elevada de 7.2.0 para 7.2.5. O algoritmo de hash de senha 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 elevada de 5.4.0 para 7.2.0. As versões mínimas exigidas de banco de dados foram elevadas. 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 podem mais reportar dados para um server atualizado. Agents mais novos não poderão mais funcionar 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. As versões anteriores à 1.4 dos Zabbix agents não são mais suportadas. 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 suportadas em vez de POSIX estendido. As bibliotecas 'libpcre' e 'libevent' são obrigatórias para o Zabbix server. Verificações de código de saída foram adicionadas para parâmetros de usuário, comandos remotos e items system.run[] sem o sinalizador '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 elevada 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 elevada 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 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 banco de dados MySQL. Consulte scripts de criação do banco de dados. A extensão PHP 'mysqli' é obrigatória em vez de 'mysql'. |