Esegui un upgrade della versione secondaria per AlloyDB Omni utilizzando RPM

Seleziona una versione della documentazione:

Questa pagina descrive come eseguire l'upgrade di una versione secondaria del database per AlloyDB Omni utilizzando Red Hat Package Manager (RPM), verificare l'installazione di cui è stato eseguito l'upgrade ed eseguire il rollback a una versione secondaria precedente, se necessario. Gli upgrade delle versioni secondarie aggiornano i file binari del database in loco e conservano i file di configurazione e di dati esistenti senza richiedere la migrazione dei dati.

Le istruzioni riportate in questa pagina si applicano ai deployment autonomi a nodo singolo e ai singoli nodi di database in topologie multi-nodo, come i deployment con repliche di lettura o nodi in standby ad alta affidabilità. Tieni presenti le seguenti considerazioni in base alla tua configurazione:

  • Topologie multi-nodo: esegui sempre l'upgrade di tutti i nodi di replica e di standby prima di eseguire l'upgrade del nodo principale. In una configurazione ad alta affidabilità, esegui un cambio a un nodo in standby di cui è stato eseguito l'upgrade prima di eseguire l'upgrade del nodo primario precedente.
  • Agente di monitoraggio (alloydbomni_monitor): se hai installato il pacchetto alloydbomni_monitor facoltativo, esegui l'upgrade di alloydbomni_monitor insieme a alloydbomni18 su ogni host.

Prima di iniziare

  1. Pianifica un periodo di manutenzione o un breve tempo di inattività del servizio, perché l'upgrade del pacchetto richiede l'interruzione temporanea del servizio di database.
  2. Ti consigliamo di eseguire un backup completo del database prima di iniziare l'upgrade. Per saperne di più, consulta la panoramica di backup e ripristino.
  3. Se esegui l'upgrade di una topologia multi-nodo, identifica il nodo principale attuale e tutti i nodi in standby o di replica in modo da poter eseguire l'upgrade dei nodi in standby e di replica per primi.
  4. Verifica la versione attuale del database AlloyDB Omni prima di eseguire l'upgrade:

    /usr/lib/postgresql/18/bin/psql -h localhost -U postgres -W -c "SELECT version();"

Verifica la disponibilità di aggiornamenti

Aggiorna la cache dei pacchetti locale e verifica la presenza di versioni successive del pacchetto alloydbomni18:

sudo dnf makecache
sudo dnf check-update alloydbomni18

Se hai installato il pacchetto alloydbomni_monitor, controlla anche la disponibilità di aggiornamenti per l'agente di monitoraggio:

sudo dnf check-update alloydbomni_monitor

Verifica un repository privato

(Facoltativo) Se gestisci i pacchetti tramite un repository YUM privato o in un ambiente senza accesso a internet, puoi eseguire i seguenti comandi per ispezionare la configurazione del repository e verificare quali versioni dei pacchetti sono disponibili:

  1. Imposta la variabile di ambiente REPOID sull'ID del tuo repository privato:

    export REPOID=REPO_ID

    Sostituisci REPO_ID con l'ID repository del tuo repository YUM privato, ad esempio alloydbomni.

  2. Controlla quale repository ha fornito l'installazione attuale di AlloyDB Omni:

    sudo dnf list installed alloydbomni18
  3. Elenca tutti i repository abilitati e i relativi ID:

    sudo dnf repolist
  4. Visualizza i metadati del tuo repository privato:

    sudo dnf repoinfo $REPOID
  5. Elenca tutte le versioni del pacchetto alloydbomni18 disponibili nei tuoi repository:

    sudo dnf --showduplicates list available alloydbomni18

Esegui l'upgrade di AlloyDB Omni

Per eseguire l'upgrade dell'installazione di AlloyDB Omni a una versione secondaria successiva, segui questi passaggi su ciascun nodo. In una topologia con più nodi, completa questi passaggi su ogni nodo di standby o di replica prima di eseguire l'upgrade del nodo principale:

  1. Arresta il servizio di database AlloyDB Omni:

    sudo systemctl stop alloydbomni18

    Se hai installato il servizio alloydbomni_monitor, interrompi anche questo:

    sudo systemctl stop alloydbomni_monitor
  2. Installa il pacchetto RPM di AlloyDB Omni aggiornato:

    sudo dnf upgrade -y alloydbomni18

    Questo comando aggiorna i pacchetti e i file binari di AlloyDB Omni, lasciando intatta la directory di dati del database.

    Se hai installato il pacchetto alloydbomni_monitor, esegui l'upgrade insieme al pacchetto del database:

    sudo dnf upgrade -y alloydbomni_monitor
  3. Avvia il servizio AlloyDB Omni systemd:

    sudo systemctl start alloydbomni18

    Se hai interrotto il servizio alloydbomni_monitor, riavvialo:

    sudo systemctl start alloydbomni_monitor

Verifica l'upgrade

Dopo aver eseguito l'upgrade dei pacchetti RPM e avviato i servizi, verifica che il servizio di database esegua la versione aggiornata:

  1. Controlla lo stato del servizio AlloyDB Omni e verifica che sia active (running):

    sudo systemctl status alloydbomni18

    Se hai eseguito l'upgrade di alloydbomni_monitor, verifica che anche il servizio di monitoraggio sia active (running):

    sudo systemctl status alloydbomni_monitor
  2. Connettiti al database e verifica che la versione di cui è stato eseguito l'upgrade sia attiva:

    /usr/lib/postgresql/18/bin/psql -h localhost -U postgres -W -c "SELECT version();"

Esegui il rollback dell'upgrade

Se devi ripristinare la versione secondaria precedente dell'installazione di AlloyDB Omni, segui questi passaggi:

  1. Arresta il servizio di database AlloyDB Omni:

    sudo systemctl stop alloydbomni18

    Se hai installato il servizio alloydbomni_monitor, interrompi anche questo:

    sudo systemctl stop alloydbomni_monitor
  2. Elenca tutte le versioni disponibili del pacchetto alloydbomni18 e identifica la stringa di versione esatta dell'installazione precedente:

    sudo dnf --showduplicates list alloydbomni18
  3. Esegui il downgrade del pacchetto alloydbomni18 alla versione precedente:

    sudo dnf downgrade -y alloydbomni18-ROLLBACK_VERSION

    Sostituisci ROLLBACK_VERSION con la stringa di versione esatta della tua installazione precedente, ad esempio 18.1.0-3.rhel9.

    Se devi eseguire il downgrade anche di alloydbomni_monitor, elenca le versioni disponibili ed esegui il downgrade alla versione precedente del pacchetto di monitoraggio:

    sudo dnf --showduplicates list alloydbomni_monitor
    sudo dnf downgrade -y alloydbomni_monitor-MONITOR_ROLLBACK_VERSION

    Sostituisci MONITOR_ROLLBACK_VERSION con la stringa della versione del pacchetto alloydbomni_monitor precedente.

  4. Avvia il servizio AlloyDB Omni systemd:

    sudo systemctl start alloydbomni18

    Se hai interrotto il servizio alloydbomni_monitor, riavvialo:

    sudo systemctl start alloydbomni_monitor
  5. Verifica che il servizio AlloyDB Omni sia attivo e in esecuzione nella versione precedente:

    sudo systemctl status alloydbomni18
    /usr/lib/postgresql/18/bin/psql -h localhost -U postgres -W -c "SELECT version();"

Passaggi successivi