2 Debian/Ubuntu

Visão geral

Esta seção provê os passos necessários para uma atualização bem-sucedida do Zabbix 5.4.x para o Zabbix 6.0.x usando os pacotes oficiais da Zabbix para Debian/Ubuntu.

Conquanto a atualização do Zabbix Agent não seja obrigatória (mas recomendada), o Zabbix Server e Proxies devem estar na mesma versão primária (major version). Deste modo, em um ambiente Server-Proxy, o Zabbix Server e todos os Proxies precisam ser parados e atualizados. Manter os Proxies em execução durante a atualização do Server não mais trará qualquer benefício, pois durante a atualização do Proxy seus dados antigos serão descartados e nenhum novo dado será reunido até que a configuração do Proxy seja sincronizada com o Server.

Note que com banco de dados SQLite nos Proxies, dados históricos de antes da atualização serão perdidos, porque a atualização do SQLite não é suportada e o arquivo de banco de dados tem de ser removido manualmente. Quando o Proxy for iniciado pela primeira vez e o arquivo de banco de dados do SQLite estiver ausente, o Proxy o criará automaticamente.

Dependendo do tamanho do banco de dados a atualização para a versão 6.0 pode levar um longo tempo.

As seguintes notas de atualização estão disponíveis:

Também pode ser de seu interesse verificar os requisitos para a versão 6.0.

Procedimento de atualização

1 Pare os processos do Zabbix

Pare o Zabbix Server para certificar-se de que nenhum novo dado está sendo gravado no banco de dados.

# systemctl stop zabbix-server

Se atualizando o Zabbix Proxy, pare-o também.

# systemctl stop zabbix-proxy

2 Faça backup do banco de dados Zabbix

Este é um passo muito importante. Certifique-se de que você tem um backup do seu banco de dados. Ele o ajudará se o procedimento de atualização falhar (falta de espaço em disco, desligamento forçado, ou qualquer outro 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 Atualize o pacote de configuração de repositório

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

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

Então instale o novo pacote de configuração de repositório.

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_5.4-1+debian10_all.deb

No Debian 9 execute:

# 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_5.4-1+debian9_all.deb

No Debian 8 execute:

# wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian8_all.deb
# dpkg -i zabbix-release_5.4-1+debian8_all.deb

No Ubuntu 20.04 execute:

# wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu20.04_all.deb
# dpkg -i zabbix-release_5.4-1+ubuntu20.04_all.deb

No Ubuntu 18.04 execute:

# wget https://repo.zabbix.com/zabbix/5.4/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/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu16.04_all.deb
# dpkg -i zabbix-release_5.4-1+ubuntu16.04_all.deb

No Ubuntu 14.04 execute:

# wget https://repo.zabbix.com/zabbix/5.4/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 Atualize os componentes do Zabbix

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

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

Se usando PostgreSQL, substitua mysql por pgsql no comando. Se atualizando o Proxy, substitua server por proxy no comando. Se atualizando o Agent 2, substitua zabbix-agent por zabbix-agent2 no comando.

Para atualizar corretamente o Zabbix Frontend com Apache, execute também:

# apt-get install zabbix-apache-conf

Distributions prior to Debian 10 (buster) / Ubuntu 18.04 (bionic) / Raspbian 10 (buster) do not provide PHP 7.2 or newer, which is required for Zabbix frontend 5.0. See information about installing Zabbix frontend on older distributions.

6 Revise os parâmetros de configuração dos componentes

Consulte as notas de atualização para detalhes sobre alterações obrigatórias (caso existam).

Para novos parâmetros opcionais, veja a seção O que há de novo.

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 (minor versions)

É possível atualizar entre 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 proceder com a atualização de versão secundária do Zabbix é necessário executar:

$ 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.*'