Esta seção fornece os passos necessários para uma atualização bem-sucedida do upgrade do Zabbix 5.4.x para o Zabbix 6.0.x usando os pacotes oficiais do Zabbix para Debian/Ubuntu. Embora a atualização dos agentes do Zabbix não seja obrigatória (mas recomendada), o servidor e os proxies do Zabbix devem ser da mesma versão principal same major version. Portanto, em uma configuração de servidor-proxy, o servidor Zabbix e todos os proxies devem ser interrompidos e atualizados. Manter os proxies em execução durante a atualização do servidor não trará mais nenhum benefício, pois durante a atualização do proxy seus dados antigos serão descartados e nenhum novo dado será coletado até que a configuração do proxy seja sincronizada com o servidor. Observe que com o banco de dados SQLite nos proxies, os dados de histórico dos proxies antes da atualização serão perdidos, porque 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, a atualização do banco de dados para a versão 6.0 pode levar bastante tempo.
Antes da atualização, certifique-se de ler as notas de atualização!
As seguintes notas de atualização estão disponíveis:
Atualização a partir de | Leia as notas de atualização completas | Mudanças mais importantes entre versões |
---|---|---|
5.4.x | Para: Zabbix 6.0 |
Versões mínimas necessárias do banco de dados aumentadas; O Server/proxy não será iniciado se o banco de dados estiver desatualizado; Registros de log de auditoria perdidos devido à mudança na estrutura do banco de dados. |
5.2.x | Para: Zabbix 5.4 Zabbix 6.0 |
Versões mínimas necessárias do banco de dados aumentadas; tens de agregação removidos como um tipo separado. |
5.0.x LTS | Para: Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Versão mínima necessária do PHP 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 |
Suporte ao IBM DB2 removido; ersão mínima necessária do PHP aumentada de 5.4.0 para 7.2.0; ersões mínimas necessárias do banco de dados aumentadas; Diretório de arquivos PHP do Zabbix alterado.. |
4.2.x | Para: Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Tipos de mídia Jabber e Ez Texting 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 mais antigos não poderão mais enviar dados para um servidor atualizado; Agentes mais recentes não serão mais capazes de funcionar com um servidor 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 |
Bibliotecas 'libpthread' e 'zlib' agora são obrigatórias; Suporte para protocolo de texto simples removido e o cabeçalho é obrigatório; Versões pré-1.4 do Zabbix agentes não são mais suportadas; O parâmetro do servidor na configuração do 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 |
Suporte do SQLite como banco de dados backend removido para servidor/frontend do Zabbix; Expressões regulares compatíveis com Perl (PCRE) suportadas em vez de POSIX estendido; 'Bibliotecas 'libpcre' e 'libevent' obrigatórias para o servidor Zabbix; |
Verificações de código de saída adicionadas para parâmetros de usuário, comandos remotos e itens system.run [] do Zabbix server sem a flag 'nowait', bem como scripts executados pelo servidor Zabbix; O Java gateway do Zabbix deve ser atualizado para suportar novas funcionalidades. |
||
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 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 |
Aumento da versão mínima do PHP de 5.3.0 para 5.4.0 O parâmetro do agente LogFile 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 |
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 |
Aumento da versão mínima do PHP de 5.1.6 para 5.3.0;; Banco de dados MySQL com distinção entre maiúsculas e minúsculas necessário para o funcionamento adequado do servidor; o conjunto de caracteres utf8 e a colação utf8_bin são necessários para o servidor Zabbix funcionar corretamente com o banco de dados MySQL. Consulte os scripts database creation scripts. Extensão PHP 'mysqli' necessária em vez de 'mysql' |
Você também pode querer verificar os requisitos requirements para o 6.0.
Pode ser útil executar duas sessões SSH paralelas durante a atualização, executando os passos de atualização em uma e monitorando os logs do servidor/proxy em outra. Por exemplo, execute tail -f zabbix_server.log
ou tail -f zabbix_proxy.log
na segunda sessão SSH, mostrando as últimas entradas de log e possíveis erros em tempo real. Isso pode ser crítico para instâncias de produção.
Pare o servidor Zabbix para garantir que nenhum dado novo seja inserido no banco de dados.
Se estiver atualizando o proxy do Zabbix, pare o proxy também.
Este é um passo muito importante. Certifique-se de ter um backup do seu banco de dados. Isso ajudará caso o procedimento de atualização falhe (falta de espaço em disco, desligamento inesperado, qualquer problema inesperado).
Faça uma cópia de backup dos binários do Zabbix, 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/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/
Arquivos PHP e binários do Zabbix:
Para prosseguir com a atualização, seu pacote de repositório atual precisa ser desinstalado.
Em seguida, instale o novo pacote de configuração do repositório.
No Debian 12, execute:
wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-5+debian12_all.deb
dpkg -i zabbix-release_6.0-5+debian12_all.deb
No Debian 11, execute:
wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian11_all.deb
dpkg -i zabbix-release_6.0-1+debian11_all.deb
No Debian 10, execute:
wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian10_all.deb
dpkg -i zabbix-release_6.0-1+debian10_all.deb
On Debian 9 run:
wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian9_all.deb
dpkg -i zabbix-release_6.0-1+debian9_all.deb
No Ubuntu 20.04, execute:
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu20.04_all.deb
dpkg -i zabbix-release_6.0-1+ubuntu20.04_all.deb
On Ubuntu 18.04 run:
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu18.04_all.deb
dpkg -i zabbix-release_6.0-1+ubuntu18.04_all.deb
No Ubuntu 16.04, execute:
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu16.04_all.deb
dpkg -i zabbix-release_6.0-1+ubuntu16.04_all.deb
No Ubuntu 14.04, execute:
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu14.04_all.deb
dpkg -i zabbix-release_6.0-1+ubuntu14.04_all.deb
Atualize as informações do repositório.
Para atualizar os componentes do Zabbix, você pode executar algo como:
Se estiver usando PostgreSQL, substitua mysql
por pgsql
no comando. Se estiver atualizando o proxy, substitua server
por proxy
no comando. Se estiver atualizando o Zabbix agent 2, substituazabbix-agent
por zabbix-agent2
no comando.
Atualizar o Zabbix agent 2 com o comando apt install zabbix-agent2
pode resultar em um erro. Para mais informações, consulte Known issues.
Em seguida, para atualizar corretamente o frontend da web com o Apache, execute também:
Distribuições anteriores ao Debian 10 (buster) / Ubuntu 18.04 (bionic) / Raspbian 10 (buster) não fornecem PHP 7.2 ou mais recente, que é necessário para o frontend do Zabbix 6.0. Consulte informações information sobre como instalar o frontend do Zabbix em distribuições mais antigas.
Certifique-se de revisar as Upgrade notes para verificar se há alguma alteração nos parâmetros de configuração necessários.
Inicie os componentes do Zabbix atualizados.
# service zabbix-server start
# service zabbix-proxy start
# service zabbix-agent start
# service zabbix-agent2 start
Após a atualização pode ser necessário limpar os cookies e o cache do navegador para que a interface web do Zabbix funcione corretamente.
É possível atualizar versões secundárias do Zabbix 6.0.x (por exemplo, de 6.0.1 para 6.0.3). A atualização entre versões secundárias é fácil.
Para atualizar a versão secundária do Zabbix, execute:
Para atualizar a versão secundária do Zabbix Server, execute:
Para atualizar a versão secundária do Zabbix Agent, utilize:
ou, para Zabbix Agent 2: