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

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=

Inicie o serviço do Zabbix Server:

$ systemctl start zabbix-server

Você pode acompanhar a atualização do Zabbix através do log:

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

Após a conclusão da atualização, verifique a versão do Zabbix:

$ zabbix_server -V

zabbix_server (Zabbix) 5.0.4

Se tudo correr bem, a tela inicial após logar no Zabbix 5.0 será esta:

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/

Espero que este material tenha auxiliado a tirar suas dúvidas sobre a atualização de versão do Zabbix. Até a próxima!

Líder em Treinamento e serviços de Consultoria, Suporte e Implantação para o mundo open source. Conheça nossas soluções:

CURSOSCONSULTORIA

Anterior Descubra como os Sistemas de Recomendação impactam seu dia a dia
Próxima Guia sobre como criar um cluster com o centralizador de logs Graylog 3.3

About author

Felipe Valim
Felipe Valim 3 posts

Felipe Valim é Graduado em Sistemas de Informação pelo Centro Universitario Eniac, possui as certificações LPIC-3 Virtualization and Containerization, LPIC-2, LPIC-1, Zabbix Certified Professional & Specialist. Com mais de 8 anos de experiência em tecnologias Open Source, atualmente integra o time de Consultoria e Treinamento 4Linux.

View all posts by this author →

Você pode gostar também

Infraestrutura TI

Guia Prático: Como Implementar uma Wiki em Ambiente Corporativo

Em ambientes corporativos, onde vários projetos são elaborados, algumas informações são muito importantes e muito específicas aos diretamente envolvidos, como configurações de ambiente e opções dos parâmetros. Neste contexto, a

DevOps

Guia Prático: Instalação e Funcionamento do Kong API e Kong-Dashboard

Estive envolvido num projeto de migração, algumas aplicações internas para o modelo de micro serviço. No caso, cada parte do código se tornaria um projeto independente, dessa forma, agilizando os

Infraestrutura TI

Descubra o pfSense: a solução opensource de firewall mais popular do mundo

Entre as soluções opensource, pfSense é a mais popular do mundo, devido a sua robustez, gestão simplificada e uma grande lista de recursos. O pfSense é a solução mais adequada