2 Debian/Ubuntu

Visão geral

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.

Procedimento de atualização

1 Pare os processos do Zabbix

Pare o servidor Zabbix para garantir que nenhum dado novo seja inserido no banco de dados.

service zabbix-server stop

Se estiver atualizando o proxy do Zabbix, pare o proxy também.

service zabbix-proxy stop
2 Fazer backup do banco de dados do Zabbix

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).

3 Backup dos arquivos de configuração, arquivos PHP e binários do Zabbix

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:

# cp -R /usr/share/zabbix/ /opt/zabbix-backup/
       # cp -R /usr/share/doc/zabbix-* /opt/zabbix-backup/
4 Atualizar pacote de configuração do repositório

Para prosseguir com a atualização, seu pacote de repositório atual precisa ser desinstalado.

rm -Rf /etc/apt/sources.list.d/zabbix.list

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.

apt-get update
5 Atualizar os componentes do Zabbix

Para atualizar os componentes do Zabbix, você pode executar algo como:

apt-get install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent

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:

apt-get install zabbix-apache-conf

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.

6 Revisar parâmetros de configuração dos componentes

Certifique-se de revisar as Upgrade notes para verificar se há alguma alteração nos parâmetros de configuração necessários.

7 Inicie os processos do Zabbix

Inicie os componentes do Zabbix atualizados.

# service zabbix-server start
       # service zabbix-proxy start
       # service zabbix-agent start
       # service zabbix-agent2 start
8 Limpe os cookies e cache do navegador

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.

Atualização entre versão secundárias

É 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:

$ sudo apt install --only-upgrade 'zabbix.*'

Para atualizar a versão secundária do Zabbix Server, execute:

$ sudo apt install --only-upgrade 'zabbix-server.*'

Para atualizar a versão secundária do Zabbix Agent, utilize:

$ sudo apt install --only-upgrade 'zabbix-agent.*'

ou, para Zabbix Agent 2:

$ sudo apt install --only-upgrade 'zabbix-agent2.*'