- 1 Red Hat Enterprise Linux
- Visão geral
- Procedimento de atualização
- 1 Pausar os processos Zabbix
- 2 Back up do banco de dados existente Zabbix
- 3 Backup dos arquivos de configuração, arquivos PHP e binários Zabbix
- 4 Atualização do pacote de configuração do repositório
- 5 Atualizar componentes Zabbix
- 6 Revisar parâmetros de configuração do componente
- 7 Inicie os processos Zabbix
- Limpar os cookies e cache do navegador
- Atualização entre versões menores
1 Red Hat Enterprise Linux
Visão geral
Esta seção oferece as etapas necessárias para uma atualização de sucesso upgrade do Zabbix 5.4.x para o Zabbix 6.0.x, usando os pacotes oficiais do Zabbix para Red Hat Enterprise Linux.
Embora a atualização dos agentes Zabbix não seja obrigatória (mas recomendada), o servidor e proxies Zabbix devem estar na mesma versão same major version. Portanto, em uma configuração servidor-proxy, o servidor e todos os proxies Zabbix devem ser pausados e atualizados. Manter os proxies em execução durante a atualização do servidor não trará nenhum benefício, pois durante a atualização do proxy, os dados antigos serão descartados e nenhum dado novo será coletado até que a configuração do proxy seja sincronizada com o servidor.
Observe que, com um banco de dados SQLite em proxies, os dados de histórico dos proxies anteriores à atualização serão perdidos, pois 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, sua atualização para a versão 6.0 pode levar um bom tempo.
Antes de iniciar a atualização, leia as notas de atualização relevantes.
Notas de atualização!
As seguintes notas de atualização estão disponíveis:
| Upgrade from | Leia todas as notas de atualização | As mudanças mais importantes entre as versões |
|---|---|---|
| 5.4.x | Para: Zabbix 6.0 |
As versões mínimas do banco de dados necessários foram aumentadas; O Servidor/proxy não irá iniciar se o banco de dados estiver desatualizado; Registros de log de auditoria perdidos devido a mudança na estrutra do banco de dados. |
| 5.2.x | Para: Zabbix 5.4 Zabbix 6.0 |
As versões mínimas do banco de dados necessários foram aumentadas; Itens agregados removidos como um tipo separado. |
| 5.0.x LTS | Para: Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Versão mínima do PHP exigida 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 |
O suporte do IBM DB2 foi descontinuado; Versão mínima do PHP exigida aumentada de 5.4.0 para 7.2.0; As versões mínimas requeridas de banco de dados foram aumentadas; O diretório de arquivo PHP do Zabbix foi alterado. |
| 4.2.x | Para: Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 |
Os tipos de mídia Jabber e Ez Texting foram 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 antigos não conseguem mais reportar dados para um servidor atualizado; Agentes mais novos não serão mais capazes de funcionar com um servidor Zabbix antigo. |
| 3.4.x | Para: 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; O suporte para o protocolo de texto simples foi removido e o cabeçalho é obrigatório; Os agentes Zabbix versão Pre-1.4 não são mais suportados; Agora, o parâmetro do servidor na configuração do proxy passivo é 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 |
O suporte ao SQLite e o banco de dados de backend forão removidos para o servidor/frontend do Zabbix; Expressões regulares compatíveis com Perl (PCRE) são suportadas em vez de POSIX estendido; as bibliotecas 'libpcre' e 'libevent'são obrigatórias para o servidor Zabbix; Verificações de codigo de saída para os parâmetros de usuário foram adicionadas, comandos remotos e itens system.run[] sem a flag 'nowait' assim como os scrips executados pelo servidor Zabbix; Zabbix Java gateway precisa ser atualizado para suportar nova funcionalidade. |
| 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 do 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 |
A versão mínima do PHP requerida foi aumentada de 5.3.0 para 5.4.0 O parâmetro LogFile do agente deve ser especificado. |
| 2.2.x LTS | Para: 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 |
Versão mínima do PHP aumentada de 5.1.6 para 5.3.0; Um banco de dados MySQL que diferencia maísuculas de minúsculas é necessário para o correto funcionamente do servidor; o conjunto de carácteres utf8 e a ordenação utf8_bin são necessários para que o servidor Zabbix funcione corretamente com o banco de dados MySQL. Ver database creation scripts. Extensão 'mysqli' PHP é necessária em vez de 'mysql'. |
Você também pode desejar verificar o requirements para 6.0.
Pode ser útil executar duas sessões SSH paralelas durante a atualização, realizando as etapas de atualização em uma e monitorando os logs de servidor/proxy em outra. Por exemplo, execute
tail -f zabbix_server.log ou tail -f zabbix_proxy.log na segunda sessão do SSH, mostrando os registros mais recentes do arquivos de log e possíveis erros em tempo real. Isso pode ser crítico para instâncias em produção.
Procedimento de atualização
1 Pausar os processos Zabbix
Pausar o servidor Zabbix para garantir que nenhum dado novo seja inserido no banco de dados.
systemctl stop zabbix-server
If upgrading the proxy, stop proxy too.
systemctl stop zabbix-proxy
It is no longer possible to start the upgraded server and have older and unupgraded proxies report data to a newer server. This approach, which was never recommended nor supported by Zabbix, now is officially disabled, as the server will ignore data from unupgraded proxies.
2 Back up do banco de dados existente Zabbix
Esta é uma etapa muito importante. Assegure-se de que você tenha um backup do seu banco de dados. Isso ajudará caso o procedimento de atualização falhe (falta de espaço em disco, desligamento, qualquer problema inesperado).
3 Backup dos arquivos de configuração, arquivos PHP e binários Zabbix
Realize uma cópia do backup binários Zabbix, dos 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/httpd/conf.d/zabbix.conf /opt/zabbix-backup/
Arquivo de PHP files e binários Zabbix:
cp -R /usr/share/zabbix/ /opt/zabbix-backup/
cp -R /usr/share/zabbix-* /opt/zabbix-backup/
4 Atualização do pacote de configuração do repositório
Antes de prosseguir com a atualização, atualizar seu pacote do repositório atual. Em RHEL 9, execute:
rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/9/x86_64/zabbix-release-latest.el9.noarch.rpm
(Para versões RHEL anteriores, substituir o link acima pelo link correto a partir do Zabbix repository).
5 Atualizar componentes Zabbix
Para atualizar os componentes Zabbix, você pode executar algo semelhante a:
dnf upgrade zabbix-server-mysql zabbix-web-mysql zabbix-agent
Caso esteja utilizando PostgreSQL, substitua mysql por pgsql no comando.
Caso esteja atualizando o proxy, substitua o server porproxy no comando.
Caso esteja atualizando o agente 2, substitua o zabbix-agent por zabbix-agent2 no comando.
::: notaimportante
Atualizar o agente 2 Zabbix com o comando dnf install zabbix-agent2 , pode levar a um erro.
Para mais informações, ver Known issues.
:::
Para atualizar o web frontend com Apache on RHEL 8 corretamente, execute também:
dnf install zabbix-apache-conf
6 Revisar parâmetros de configuração do componente
Assegure-se de revisar as notas de atualização Upgrade notes para verificar se alguma mudança dos parâmetros de configuração é necessária.
7 Inicie os processos Zabbix
Inicie a atualização dos componentes Zabbix.
systemctl start zabbix-server
systemctl start zabbix-proxy
systemctl start zabbix-agent
systemctl start zabbix-agent2
Limpar os cookies e cache do navegador
Após a atualização, pode ser necessário limpar os cookies e cache do navegador para que a interface do Zabbix funcione corretamente.
Atualização entre versões menores
É possível fazer atualização entre versões menores de 6.0.x (por exemplo, de 6.0.1 para 6.0.3). Fazer atualização entre as versões menores é simples.
Para executar a atualização da versão menor do Zabbix, é necessário executar:
sudo dnf upgrade 'zabbix-*'
Para executar a atualização da versão menor do servidor Zabbix, execute:
sudo dnf upgrade 'zabbix-server-*'
Para executar o a atualização do agente da versão menor do Zabbix, execute:
sudo dnf upgrade 'zabbix-agent-*'
ou, para o agente 2 do Zabbix:
sudo dnf upgrade 'zabbix-agent2-*'