RPM を使用して AlloyDB Omni をインストールする

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

RHEL 9 ランタイムをサポートする任意の Linux マシンまたはベアメタル サーバーで、AlloyDB Omni の単一インスタンス インストールを実行できます。

始める前に

AlloyDB Omni をインストールする前に、AlloyDB Omni のインストールを計画するをご覧ください。

AlloyDB Omni がデータを保存するディレクトリを作成する

AlloyDB Omni と他のアプリケーションを一緒に実行するストレージ システムを使用している場合は、デバイスの既存のファイル システムに AlloyDB Omni ディレクトリを作成できます。それ以外の場合は、専用デバイスに新しいファイル システムを作成できます。

既存のファイル システム

既存のファイル システムにディレクトリを作成するには、次のコマンドを実行します。

mkdir -p DATA_DIR

次の変数を置き換えます。

  • DATA_DIR: データが保存されているホスト ディレクトリ パス。

専用デバイス

専用ファイル システムにディレクトリを作成する手順は次のとおりです。

  1. ディスクをマウントするホストにディレクトリを作成します。

    mkdir -p MOUNT_POINT

    次の変数を置き換えます。

    • MOUNT_POINT: AlloyDB Omni インスタンスを含む最上位ディレクトリ パス。

  2. gpt パーティション テーブルとファイル システムを作成し、ディスク デバイスをマウントします。

    EXT4

    parted -s DEVICE_PATH mklabel gpt
parted -s DEVICE_PATH mkpart primary 0% 100%
mkfs.ext4 -q -m 1 -L FS_LABEL -F PARTITION_PATH
echo -e "LABEL=FS_LABEL\tMOUNT_POINT\text4\tdefaults\t0 0" | tee -a /etc/fstab
mount MOUNT_POINT

    次の変数を置き換えます。

    • DEVICE_PATH: オペレーティング システムによってディスク デバイスに割り当てられたパス。
    • FS_LABEL: ファイル システムのラベル。xfs の最大長は 12 文字です。
    • PARTITION_PATH: ファイル システム データの保存に使用されるディスク パーティションのパス。

    XFS

    parted -s DEVICE_PATH mklabel gpt
parted -s DEVICE_PATH mkpart primary 0% 100%
dnf install xfsprogs
mkfs.xfs -L FS_LABEL -f PARTITION_PATH
echo -e "LABEL=FS_LABEL\tMOUNT_POINT\txfs\tdefaults\t0 0" | tee -a /etc/fstab
mount MOUNT_POINT

    次の変数を置き換えます。

    • DEVICE_PATH: オペレーティング システムによってディスク デバイスに割り当てられたパス。
    • FS_LABEL: ファイル システムのラベル。ext4 の最大長は 16 文字です。
    • PARTITION_PATH: ファイル システム データの保存に使用されるディスク パーティションのパス。

  3. このファイル システムにデータ ディレクトリを作成します。DATA_DIR をマウント ポイント内のサブディレクトリとして作成することをおすすめします（例: MOUNT_POINT/18）。

    mkdir -p DATA_DIR

    DATA_DIR は、データベース関連のデータを保存するホスト ディレクトリ パスに置き換えます（例: MOUNT_POINT/18）。

SELinux ポリシーを構成する

AlloyDB Omni RPM パッケージのインストール時に AlloyDB Omni データベース サービスを許可するように SELinux ポリシーが構成されるように、必要な policycoreutils-python-utils パッケージをインストールします。

AlloyDB Omni をインストール

  1. ローカル ディレクトリに YUM リポジトリを構成します。

    sudo tee -a /etc/yum.repos.d/alloydbomni.repo << EOF
[alloydbomni]
name=alloydbomni
baseurl=ALLOYDB_OMNI_URL
enabled=1
repo_gpgcheck=1
gpgcheck=1
gpgkey=https://dl.google.com/linux/linux_signing_key.pub
EOF

    sudo yum makecache

    ALLOYDB_OMNI_URL は、受け取った AlloyDB Omni URL に置き換えます。

  2. AlloyDB Omni RPM パッケージをインストールします。

    sudo dnf install alloydbomni18

  3. AlloyDB Omni データベースを初期化して構成します。

    sudo PGPASSWORD=POSTGRES_PASSWORD PGDATA=DATA_DIR /usr/lib/postgresql/18/bin/alloydbomni18-setup initdb

    必要に応じて、標準の initdb オプションを POSTGRES_INITDB_ARGS 変数の単一の文字列として渡すことができます。

  4. カスタム データ ディレクトリを使用している場合は、次のコマンドを実行して、AlloyDB Omni サービスがそのディレクトリ内のデータを読み書きできるように SELinux を構成します。この手順では、policycoreutils-python-utils パッケージがインストールされている必要があります。

    /usr/sbin/semanage fcontext -a -t postgresql_db_t "DATA_DIR(/.*)?"

    sudo PWFILE=PASSWORD_FILE_PATH PGDATA=DATA_DIR /usr/lib/postgresql/18/bin/alloydbomni18-setup initdb

    次の変数を置き換えます。

    • POSTGRES_PASSWORD: パスワード。
    • PASSWORD_FILE_PATH: パスワードのみを含むパス（書式なしテキスト）。
    • DATA_DIR: データベース関連データを保存するホスト ディレクトリ パス。例: MOUNT_POINT/18

    必要に応じて、標準の initdb オプションを POSTGRES_INITDB_ARGS 変数内の単一の文字列として渡すことができます。

  5. カスタム データ ディレクトリを使用しており、SELinux が有効になっている場合は、次のコマンドを実行して、AlloyDB Omni サービスがそのディレクトリ内のデータを読み書きできるように SELinux を構成します。この手順では、policycoreutils-python-utils パッケージがインストールされている必要があります。

      sudo /usr/sbin/semanage fcontext -a -t postgresql_db_t "DATA_DIR(/.*)?"
  sudo /sbin/restorecon -R -F DATA_DIR
/sbin/restorecon -R -F DATA_DIR

  6. AlloyDB Omni データベースを準備します。

    sudo PGPASSWORD=POSTGRES_PASSWORD /usr/lib/postgresql/18/bin/alloydbomni18-setup preparedb

  7. 省略可。AlloyDB Omni サービスの実行を最適化するには、次のコマンドを実行します。

    sudo /usr/lib/postgresql/18/bin/alloydbomni18-setup-host

    上記のコマンドを実行すると、次のシステム構成が推奨値に設定されます。

    システム設定のイベント 推奨値
    /sys/kernel/mm/transparent_hugepage/shmem_enabled within_size
    /sys/kernel/mm/transparent_hugepage/khugepaged/max_ptes_swap 511
    /sys/kernel/mm/transparent_hugepage/khugepaged/max_ptes_shared 511
    /proc/sys/vm/nr_overcommit_hugepages MemTotal のサイズ（MB）に等しい値
    /proc/sys/vm/max_map_count 1073741824

    これらの構成にカスタム値を渡すには、次の例のように、alloydbomni18-setup-host コマンドに <system_setting>=<value> 形式の引数を含めます。

    sudo /usr/lib/postgresql/18/bin/alloydbomni18-setup-host /proc/sys/vm/max_map_count=2097152 /proc/sys/vm/nr_overcommit_hugepages=524288

  8. AlloyDB Omni systemd サービスを開始します。

    sudo systemctl enable alloydbomni18

    sudo systemctl start alloydbomni18

  9. AlloyDB Omni サービスが正常に実行されているかどうかを確認します。

    sudo systemctl status alloydbomni18

    レスポンスの例を次に示します。ステータスがアクティブ（実行中）であることを確認します。

        Loaded: loaded (/usr/lib/systemd/system/alloydbomni18.service; enabled; preset: disabled)
   Drop-In: /etc/systemd/system/alloydbomni18.service.d
     Active: active (running) since Wed 2025-11-19 07:37:31 UTC; 1 day 6h ago "
   Process: 120228 ExecStartPre=/usr/lib/postgresql/18/bin/alloydbomni18-check-db-dir ${PGDATA} (code=exited, status=0 SUCCESS)
  Main PID: 120231 (postgres)
     Tasks: 19 (limit: 203438)
    Memory: 161.7M (peak: 170.0M)
       CPU: 28min 10.149s
    CGroup: /system.slice/alloydbomni18.service
            ├─120231 /usr/lib/postgresql/18/bin/postgres -D /var/lib/postgresql/18/data
            ├─120232 "postgres: alloydb internal logger "
            ├─120233 "postgres: checkpointer "
            ├─120234 "postgres: background writer "
            ├─120237 "postgres: walwriter "
            ├─120243 "postgres: lux wal preallocator "
            ├─120244 "postgres: autovacuum launcher "
            ├─120246 "postgres: free buffer manager "
            ├─120247 "postgres: buffer control "

次のステップ