Guia prático para atualizar o Zabbix 4.0 LTS para a 5.0 LTS

Assim como muitas ferramentas Open Source, o Zabbix vem aprimorando seus recursos através de um ciclo contínuo de desenvolvimento sempre tentando atender as necessidades de clientes e da própria comunidade, gerando assim, novas atualizações.

A última versão LTS (Long-Term Support) 5.0 foi lançada em 12 de maio de 2020 e para utilizar todos os recursos desta nova versão, temos que atualizar o nosso Zabbix. Atualizar uma ferramenta como esta não é uma tarefa tão simples, ainda mais quando temos  o monitoramento como um “braço direito” da nossa infraestrutura. Para esse post sugiro que faça um laboratório sem dados em produção. Caso realmente queira fazer este tipo de atualização, no final deste conteúdo vou deixar algumas dicas importantes.

Hoje vou mostrar a atualização da versão 4.0 LTS para a 5.0 LTS usando o Debian 10 Buster.

Antes de tudo, verifique a versão atual instalada:

$ zabbix_server -V

zabbix_server (Zabbix) 4.0.25

A tela inicial após o login no Zabbix 4.0 é esta:

Procedimento de atualização

Primeiramente pare o serviço do Zabbix para que o serviço não receba mais conexões e não entrem novos dados no banco de dados:

$ systemctl stop zabbix-server

Faça backup dos arquivos de binários do Zabbix, arquivos de configuração e diretórios do PHP:

Arquivos de configuração:

$ mkdir -p /opt/zabbix-backup/database
$ cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
$ cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/

Arquivos de PHP e binários do Zabbix:

$  cp -R /usr/share/zabbix/ /opt/zabbix-backup/
$  cp -R /usr/share/doc/zabbix-* /opt/zabbix-backup/

Faça o backup do banco de dados e copie este backup para um diretório de armazenamento de backups. Certifique-se de ter espaço no diretório de destino pois este é um processo que pode demorar horas dependendo do tamanho do seu banco de dados. Segue um exemplo:

$ mysqldump -h localhost -u'root' -p --single-transaction 'zabbix' | gzip > /opt/zabbix-backup/database/zabbixdatabase_backup.sql.gz

Atualização de repositório:

$ rm /etc/apt/sources.list.d/zabbix.list
$ wget https://repo.zabbix.com/zabbix/5.0/debian/pool/main/z/zabbix-release/zabbix-release_5.0-1+buster_all.deb
$ dpkg -i zabbix-release_5.0-1+buster_all.deb

$ apt-get update

Atualizações dos componentes do Zabbix:

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

Atualização do front-end com Apache.

$ apt-get install zabbix-apache-conf

Ajuste os arquivos de configuração do Zabbix de acordo com o backup feito em /opt/zabbix-backup/zabbix_server.conf dando atenção aos seguintes campos no arquivo /etc/zabbix/zabbix_server.conf:

DBHost=
DBName=
DBUser=
DBPassword=

$ systemctl start zabbix-server

$ tail -f /var/log/zabbix/zabbix_server.log

$ zabbix_server -V

zabbix_server (Zabbix) 5.0.4

Dicas

Para atualizar seu ambiente em produção sugiro a leitura da documentação o que há de novo na versão que você quer atualizar, o documento notas de atualização  e também o resumo da atualização da versão do seu ambiente. Existem pontos importantes nestes documentos, como informações de compatibilidade da versão do PHP, banco de dados, e outras informações importantes, como por exemplo, os proxies em versões mais antigas como na 3.x não podem mais relatar dados para um servidor atualizado e os agentes em versões mais novas não serão mais capazes de trabalhar com um servidor Zabbix na versão mais antiga.

No procedimento de atualização efetuei o backup apenas dos arquivos e pastas recomendados na documentação oficial de atualização do Zabbix, todavia é sempre bom ter o backup completo, contendo todas as pastas e arquivos relacionadas ao Zabbix Server entre outros serviços relacionados.

Abaixo tenho uma breve lista de exemplo:

/etc/zabbix/
/usr/sbin/zabbix_server
/usr/share/doc/zabbix-*
/etc/httpd/conf.d/zabbix.conf
/etc/apache2/conf-enabled/zabbix.conf
/usr/share/zabbix/