RPM を使用して AlloyDB Omni のマイナー バージョン アップグレードを実行する

ドキュメントのバージョンを選択してください。

このページでは、Red Hat Package Manager(RPM)を使用して AlloyDB Omni のデータベースのマイナー バージョンをアップグレードする方法、アップグレードされたインストールを確認する方法、必要に応じて以前のマイナー バージョンにロールバックする方法について説明します。マイナー バージョンのアップグレードでは、データベース バイナリがインプレースで更新され、既存の構成ファイルとデータファイルが保持されます。データ移行は必要ありません。

このページの手順は、スタンドアロンの単一ノードデプロイと、マルチノード トポロジの個々のデータベース ノード(リードレプリカや高可用性スタンバイ ノードを使用したデプロイなど)に適用されます。設定に基づいて、次の考慮事項を確認してください。

  • マルチノード トポロジ: プライマリ ノードをアップグレードする前に、すべてのレプリカノードとスタンバイ ノードをアップグレードします。高可用性設定では、以前のプライマリ ノードをアップグレードする前に、アップグレードされたスタンバイ ノードに切り替えます。
  • Monitoring エージェント(alloydbomni_monitor): オプションの alloydbomni_monitor パッケージをインストールした場合は、各ホストで alloydbomni18 とともに alloydbomni_monitor をアップグレードします。

始める前に

  1. パッケージをアップグレードするには、データベース サービスを一時的に停止する必要があるため、メンテナンスの時間枠または短いサービス ダウンタイムを計画します。
  2. アップグレードを開始する前に、データベースのフル バックアップを取得することをおすすめします。詳細については、バックアップと復元の概要をご覧ください。
  3. マルチノード トポロジをアップグレードする場合は、現在のプライマリ ノードとすべてのスタンバイ ノードまたはレプリカノードを特定して、スタンバイ ノードとレプリカノードを最初にアップグレードできるようにします。
  4. アップグレードする前に、現在の AlloyDB Omni データベース バージョンを確認します。

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

利用可能なアップデートを確認する

ローカル パッケージ キャッシュを更新し、alloydbomni18 パッケージの新しいバージョンを確認します。

sudo dnf makecache
sudo dnf check-update alloydbomni18

alloydbomni_monitor パッケージをインストールした場合は、モニタリング エージェントの利用可能な更新も確認します。

sudo dnf check-update alloydbomni_monitor

非公開リポジトリを確認する

省略可: 非公開の YUM リポジトリを介してパッケージを管理する場合、またはインターネット アクセスできない環境でパッケージを管理する場合は、次のコマンドを実行してリポジトリ構成を検査し、使用可能なパッケージ バージョンを確認します。

  1. 環境変数 REPOID をプライベート リポジトリの ID に設定します。

    export REPOID=REPO_ID

    REPO_ID は、非公開 YUM リポジトリのリポジトリ ID(alloydbomni など)に置き換えます。

  2. 現在の AlloyDB Omni のインストールを提供したリポジトリを確認します。

    sudo dnf list installed alloydbomni18
  3. 有効になっているすべてのリポジトリとそのリポジトリ ID を一覧表示します。

    sudo dnf repolist
  4. 非公開リポジトリのメタデータを表示します。

    sudo dnf repoinfo $REPOID
  5. リポジトリで使用可能な alloydbomni18 パッケージのすべてのバージョンを一覧表示します。

    sudo dnf --showduplicates list available alloydbomni18

AlloyDB Omni をアップグレードする

AlloyDB Omni のインストールを新しいマイナー バージョンにアップグレードするには、各ノードで次の手順を行います。マルチノード トポロジでは、プライマリ ノードをアップグレードする前に、各スタンバイ ノードまたはレプリカノードで次の手順を完了します。

  1. AlloyDB Omni データベース サービスを停止します。

    sudo systemctl stop alloydbomni18

    alloydbomni_monitor サービスをインストールした場合は、それも停止します。

    sudo systemctl stop alloydbomni_monitor
  2. 更新された AlloyDB Omni RPM パッケージをインストールします。

    sudo dnf upgrade -y alloydbomni18

    このコマンドは、データベースのデータ ディレクトリをそのままにして、AlloyDB Omni パッケージとバイナリを更新します。

    alloydbomni_monitor パッケージをインストールした場合は、データベース パッケージとともにアップグレードします。

    sudo dnf upgrade -y alloydbomni_monitor
  3. AlloyDB Omni systemd サービスを起動します。

    sudo systemctl start alloydbomni18

    alloydbomni_monitor サービスを停止した場合は、再度起動します。

    sudo systemctl start alloydbomni_monitor

アップグレードを確認する

RPM パッケージをアップグレードしてサービスを開始したら、データベース サービスが更新されたバージョンを実行していることを確認します。

  1. AlloyDB Omni サービスのステータスを確認し、active (running) であることを確認します。

    sudo systemctl status alloydbomni18

    alloydbomni_monitor をアップグレードした場合は、モニタリング サービスも active (running) であることを確認します。

    sudo systemctl status alloydbomni_monitor
  2. データベースに接続し、アップグレードされたバージョンが有効であることを確認します。

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

アップグレードをロールバックする

AlloyDB Omni のインストールを以前のマイナー バージョンに戻す必要がある場合は、次の手順に沿って操作します。

  1. AlloyDB Omni データベース サービスを停止します。

    sudo systemctl stop alloydbomni18

    alloydbomni_monitor サービスをインストールした場合は、それも停止します。

    sudo systemctl stop alloydbomni_monitor
  2. alloydbomni18 パッケージの利用可能なすべてのバージョンを一覧表示し、以前のインストールの正確なバージョン文字列を特定します。

    sudo dnf --showduplicates list alloydbomni18
  3. alloydbomni18 パッケージを以前のバージョンにダウングレードします。

    sudo dnf downgrade -y alloydbomni18-ROLLBACK_VERSION

    ROLLBACK_VERSION は、以前のインストールの正確なバージョン文字列に置き換えます(例: 18.1.0-3.rhel9)。

    alloydbomni_monitor もダウングレードする必要がある場合は、使用可能なバージョンを一覧表示し、以前のモニター パッケージ バージョンにダウングレードします。

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

    MONITOR_ROLLBACK_VERSION は、以前の alloydbomni_monitor パッケージ バージョン文字列に置き換えます。

  4. AlloyDB Omni systemd サービスを起動します。

    sudo systemctl start alloydbomni18

    alloydbomni_monitor サービスを停止した場合は、再度起動します。

    sudo systemctl start alloydbomni_monitor
  5. AlloyDB Omni サービスがアクティブで、以前のバージョンを実行していることを確認します。

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

次のステップ