Fazer upgrade de uma versão secundária do AlloyDB Omni usando RPM

Selecione uma versão da documentação:

Nesta página, descrevemos como fazer um upgrade de versão secundária do banco de dados para o AlloyDB Omni usando o Red Hat Package Manager (RPM), verificar a instalação atualizada e reverter para uma versão secundária anterior, se necessário. Os upgrades de versão secundária atualizam os binários do banco de dados no local e preservam os arquivos de configuração e dados atuais sem exigir a migração de dados.

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 pacote alloydbomni_monitor opcional, faça upgrade de alloydbomni_monitor com alloydbomni18 em cada host.

Antes de começar

  1. 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.
  2. 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.
  3. 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.
  4. 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 alloydbomni18

Se 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_monitor

Verificar 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:

  1. Defina a variável de ambiente REPOID como o ID do repositório particular:

    export REPOID=REPO_ID

    Substitua REPO_ID pelo ID do repositório privado do YUM, por exemplo, alloydbomni.

  2. Verifique qual repositório forneceu sua instalação atual do AlloyDB Omni:

    sudo dnf list installed alloydbomni18
  3. Liste todos os repositórios ativados e os IDs deles:

    sudo dnf repolist
  4. Veja os metadados do seu repositório particular:

    sudo dnf repoinfo $REPOID
  5. Liste todas as versões do pacote alloydbomni18 disponí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:

  1. Interrompa o serviço de banco de dados do AlloyDB Omni:

    sudo systemctl stop alloydbomni18

    Se você instalou o serviço alloydbomni_monitor, interrompa-o também:

    sudo systemctl stop alloydbomni_monitor
  2. Instale o pacote RPM atualizado do AlloyDB Omni:

    sudo dnf upgrade -y alloydbomni18

    Esse 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_monitor
  3. Inicie o serviço systemd do AlloyDB Omni:

    sudo systemctl start alloydbomni18

    Se 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:

  1. Verifique o status do serviço do AlloyDB Omni e confirme se ele é active (running):

    sudo systemctl status alloydbomni18

    Se você fez upgrade do alloydbomni_monitor, confirme se o serviço de monitoramento também é active (running):

    sudo systemctl status alloydbomni_monitor
  2. Conecte-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:

  1. Interrompa o serviço de banco de dados do AlloyDB Omni:

    sudo systemctl stop alloydbomni18

    Se você instalou o serviço alloydbomni_monitor, interrompa-o também:

    sudo systemctl stop alloydbomni_monitor
  2. Liste todas as versões disponíveis do pacote alloydbomni18 e identifique a string de versão exata da instalação anterior:

    sudo dnf --showduplicates list alloydbomni18
  3. Faça downgrade do pacote alloydbomni18 para a versão anterior:

    sudo dnf downgrade -y alloydbomni18-ROLLBACK_VERSION

    Substitua ROLLBACK_VERSION pela 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_VERSION

    Substitua MONITOR_ROLLBACK_VERSION pela string de versão do pacote alloydbomni_monitor anterior.

  4. Inicie o serviço systemd do AlloyDB Omni:

    sudo systemctl start alloydbomni18

    Se você interrompeu o serviço alloydbomni_monitor, inicie-o novamente:

    sudo systemctl start alloydbomni_monitor
  5. Verifique 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();"

A seguir