Melakukan upgrade versi minor untuk AlloyDB Omni menggunakan RPM

Pilih versi dokumentasi:

Halaman ini menjelaskan cara melakukan upgrade versi database minor untuk AlloyDB Omni menggunakan Red Hat Package Manager (RPM), memverifikasi penginstalan yang diupgrade, dan melakukan roll back ke versi minor sebelumnya jika diperlukan. Upgrade versi minor mengupdate biner database secara langsung dan mempertahankan file konfigurasi dan data yang ada tanpa memerlukan migrasi data.

Petunjuk di halaman ini berlaku untuk deployment node tunggal mandiri dan untuk node database individual dalam topologi multi-node, seperti deployment dengan replika baca atau node standby ketersediaan tinggi. Perhatikan pertimbangan berikut berdasarkan penyiapan Anda:

  • Topologi multi-node: Selalu upgrade semua node replika dan standby sebelum Anda mengupgrade node utama. Dalam penyiapan ketersediaan tinggi, lakukan pengalihan ke node standby yang diupgrade sebelum Anda mengupgrade node utama sebelumnya.
  • Agen Monitoring (alloydbomni_monitor): Jika Anda menginstal paket alloydbomni_monitor opsional, upgrade alloydbomni_monitor bersama alloydbomni18 di setiap host.

Sebelum memulai

  1. Rencanakan masa pemeliharaan atau periode nonaktif layanan singkat, karena mengupgrade paket memerlukan penghentian sementara layanan database.
  2. Sebaiknya buat cadangan penuh database Anda sebelum memulai upgrade. Untuk mengetahui informasi selengkapnya, lihat Ringkasan pencadangan dan pemulihan.
  3. Jika Anda mengupgrade topologi multi-node, identifikasi node utama saat ini dan semua node standby atau replika, sehingga Anda dapat mengupgrade node standby dan replika terlebih dahulu.
  4. Verifikasi versi database AlloyDB Omni Anda saat ini sebelum mengupgrade:

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

Memeriksa update yang tersedia

Perbarui cache paket lokal Anda dan periksa versi paket alloydbomni18 yang lebih baru:

sudo dnf makecache
sudo dnf check-update alloydbomni18

Jika Anda menginstal paket alloydbomni_monitor, periksa juga update yang tersedia untuk agen pemantauan:

sudo dnf check-update alloydbomni_monitor

Memverifikasi repositori pribadi

Opsional: Jika Anda mengelola paket melalui repositori YUM pribadi atau di lingkungan tanpa akses internet, Anda dapat menjalankan perintah berikut untuk memeriksa konfigurasi repositori dan memeriksa versi paket yang tersedia:

  1. Tetapkan variabel lingkungan REPOID ke ID repositori pribadi Anda:

    export REPOID=REPO_ID

    Ganti REPO_ID dengan ID repositori dari repositori YUM pribadi Anda—misalnya, alloydbomni.

  2. Periksa repositori mana yang menyediakan penginstalan AlloyDB Omni Anda saat ini:

    sudo dnf list installed alloydbomni18
  3. Cantumkan semua repositori yang diaktifkan dan ID repositorinya:

    sudo dnf repolist
  4. Melihat metadata untuk repositori pribadi Anda:

    sudo dnf repoinfo $REPOID
  5. Cantumkan semua versi paket alloydbomni18 yang tersedia di repositori Anda:

    sudo dnf --showduplicates list available alloydbomni18

Mengupgrade AlloyDB Omni

Untuk mengupgrade penginstalan AlloyDB Omni ke versi minor yang lebih baru, ikuti langkah-langkah berikut di setiap node. Dalam topologi multi-node, selesaikan langkah-langkah ini di setiap node standby atau replika sebelum mengupgrade node utama:

  1. Hentikan layanan database AlloyDB Omni:

    sudo systemctl stop alloydbomni18

    Jika Anda menginstal layanan alloydbomni_monitor, hentikan juga layanan tersebut:

    sudo systemctl stop alloydbomni_monitor
  2. Instal paket RPM AlloyDB Omni yang telah diupdate:

    sudo dnf upgrade -y alloydbomni18

    Perintah ini mengupdate paket dan biner AlloyDB Omni, tetapi tidak mengubah direktori data database Anda.

    Jika Anda menginstal paket alloydbomni_monitor, upgrade paket tersebut bersama dengan paket database:

    sudo dnf upgrade -y alloydbomni_monitor
  3. Mulai layanan systemd AlloyDB Omni:

    sudo systemctl start alloydbomni18

    Jika Anda menghentikan layanan alloydbomni_monitor, mulai lagi:

    sudo systemctl start alloydbomni_monitor

Memverifikasi upgrade

Setelah Anda mengupgrade paket RPM dan memulai layanan, pastikan layanan database menjalankan versi yang diupdate:

  1. Periksa status layanan AlloyDB Omni dan pastikan statusnya active (running):

    sudo systemctl status alloydbomni18

    Jika Anda mengupgrade alloydbomni_monitor, pastikan layanan monitor juga active (running):

    sudo systemctl status alloydbomni_monitor
  2. Hubungkan ke database dan pastikan versi yang diupgrade sudah aktif:

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

Me-roll back upgrade

Jika Anda perlu mengembalikan penginstalan AlloyDB Omni ke versi minor sebelumnya, ikuti langkah-langkah berikut:

  1. Hentikan layanan database AlloyDB Omni:

    sudo systemctl stop alloydbomni18

    Jika Anda menginstal layanan alloydbomni_monitor, hentikan juga layanan tersebut:

    sudo systemctl stop alloydbomni_monitor
  2. Cantumkan semua versi paket alloydbomni18 yang tersedia dan identifikasi string versi yang tepat dari penginstalan Anda sebelumnya:

    sudo dnf --showduplicates list alloydbomni18
  3. Downgrade paket alloydbomni18 ke versi sebelumnya:

    sudo dnf downgrade -y alloydbomni18-ROLLBACK_VERSION

    Ganti ROLLBACK_VERSION dengan string versi yang sama persis dari penginstalan sebelumnya—misalnya, 18.1.0-3.rhel9.

    Jika Anda juga perlu mendowngrade alloydbomni_monitor, cantumkan versi yang tersedia dan downgrade ke versi paket monitor sebelumnya:

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

    Ganti MONITOR_ROLLBACK_VERSION dengan string versi paket alloydbomni_monitor sebelumnya.

  4. Mulai layanan systemd AlloyDB Omni:

    sudo systemctl start alloydbomni18

    Jika Anda menghentikan layanan alloydbomni_monitor, mulai lagi:

    sudo systemctl start alloydbomni_monitor
  5. Pastikan layanan AlloyDB Omni aktif dan menjalankan versi sebelumnya:

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

Langkah berikutnya