As instruções nesta página se aplicam a implantações independentes de nó único e a nós de banco de dados individuais em topologias de vários nós, como implantações com réplicas de leitura ou nós de espera de alta disponibilidade. Considere o seguinte com base na sua configuração:
- Topologias de vários nós: sempre faça upgrade de todos os nós de réplica e de espera antes de fazer upgrade do nó principal. Em uma configuração de alta disponibilidade, faça uma troca para um nó de espera atualizado antes de fazer upgrade do nó principal anterior.
- Agente do Monitoring (
alloydbomni_monitor): se você instalou o pacotealloydbomni_monitoropcional, faça upgrade dealloydbomni_monitorcomalloydbomni18em cada host.
Antes de começar
- Planeje uma janela de manutenção ou um breve período de inatividade do serviço, porque o upgrade do pacote exige a interrupção temporária do serviço de banco de dados.
- Recomendamos que você faça um backup completo do banco de dados antes de iniciar o upgrade. Para mais informações, consulte Visão geral de backup e restauração.
- Se você estiver fazendo upgrade de uma topologia de vários nós, identifique o nó principal atual e todos os nós de espera ou de réplica para que possa fazer upgrade dos nós de espera e de réplica primeiro.
Verifique a versão atual do banco de dados do AlloyDB Omni antes de fazer upgrade:
/usr/lib/postgresql/18/bin/psql -h localhost -U postgres -W -c "SELECT version();"
Verificar se há atualizações disponíveis
Atualize o cache do pacote local e verifique se há versões mais recentes do
pacote alloydbomni18:
sudo dnf makecache
sudo dnf check-update alloydbomni18Se você instalou o pacote alloydbomni_monitor, verifique também se há atualizações disponíveis
para o agente de monitoramento:
sudo dnf check-update alloydbomni_monitorVerificar um repositório particular
Opcional: se você gerencia pacotes por um repositório YUM particular ou em um ambiente sem acesso à Internet, execute os seguintes comandos para inspecionar a configuração do repositório e verificar quais versões de pacote estão disponíveis:
Defina a variável de ambiente
REPOIDcomo o ID do repositório particular:export REPOID=REPO_IDSubstitua
REPO_IDpelo ID do repositório privado do YUM, por exemplo,alloydbomni.Verifique qual repositório forneceu sua instalação atual do AlloyDB Omni:
sudo dnf list installed alloydbomni18Liste todos os repositórios ativados e os IDs deles:
sudo dnf repolistVeja os metadados do seu repositório particular:
sudo dnf repoinfo $REPOIDListe todas as versões do pacote
alloydbomni18disponíveis nos repositórios:sudo dnf --showduplicates list available alloydbomni18
Fazer upgrade do AlloyDB Omni
Para fazer upgrade da instalação do AlloyDB Omni para uma versão secundária mais recente, siga estas etapas em cada nó. Em uma topologia de vários nós, conclua estas etapas em cada nó de espera ou réplica antes de fazer upgrade do nó principal:
Interrompa o serviço de banco de dados do AlloyDB Omni:
sudo systemctl stop alloydbomni18Se você instalou o serviço
alloydbomni_monitor, interrompa-o também:sudo systemctl stop alloydbomni_monitorInstale o pacote RPM atualizado do AlloyDB Omni:
sudo dnf upgrade -y alloydbomni18Esse comando atualiza os pacotes e binários do AlloyDB Omni, mas deixa o diretório de dados do banco de dados intacto.
Se você instalou o pacote
alloydbomni_monitor, faça upgrade dele junto com o pacote do banco de dados:sudo dnf upgrade -y alloydbomni_monitorInicie o serviço
systemddo AlloyDB Omni:sudo systemctl start alloydbomni18Se você interrompeu o serviço
alloydbomni_monitor, inicie-o novamente:sudo systemctl start alloydbomni_monitor
Verificar o upgrade
Depois de fazer upgrade dos pacotes RPM e iniciar os serviços, verifique se o serviço de banco de dados está executando a versão atualizada:
Verifique o status do serviço do AlloyDB Omni e confirme se ele é
active (running):sudo systemctl status alloydbomni18Se você fez upgrade do
alloydbomni_monitor, confirme se o serviço de monitoramento também éactive (running):sudo systemctl status alloydbomni_monitorConecte-se ao banco de dados e verifique se a versão atualizada está ativa:
/usr/lib/postgresql/18/bin/psql -h localhost -U postgres -W -c "SELECT version();"
Reverter o upgrade
Se você precisar reverter a instalação do AlloyDB Omni para a versão secundária anterior, siga estas etapas:
Interrompa o serviço de banco de dados do AlloyDB Omni:
sudo systemctl stop alloydbomni18Se você instalou o serviço
alloydbomni_monitor, interrompa-o também:sudo systemctl stop alloydbomni_monitorListe todas as versões disponíveis do pacote
alloydbomni18e identifique a string de versão exata da instalação anterior:sudo dnf --showduplicates list alloydbomni18Faça downgrade do pacote
alloydbomni18para a versão anterior:sudo dnf downgrade -y alloydbomni18-ROLLBACK_VERSIONSubstitua
ROLLBACK_VERSIONpela string de versão exata da instalação anterior, por exemplo,18.1.0-3.rhel9.Se você também precisar fazer downgrade de
alloydbomni_monitor, liste as versões disponíveis e faça downgrade para a versão anterior do pacote de monitoramento:sudo dnf --showduplicates list alloydbomni_monitor sudo dnf downgrade -y alloydbomni_monitor-MONITOR_ROLLBACK_VERSIONSubstitua
MONITOR_ROLLBACK_VERSIONpela string de versão do pacotealloydbomni_monitoranterior.Inicie o serviço
systemddo AlloyDB Omni:sudo systemctl start alloydbomni18Se você interrompeu o serviço
alloydbomni_monitor, inicie-o novamente:sudo systemctl start alloydbomni_monitorVerifique se o serviço do AlloyDB Omni está ativo e executando a versão anterior:
sudo systemctl status alloydbomni18 /usr/lib/postgresql/18/bin/psql -h localhost -U postgres -W -c "SELECT version();"