AlloyDB Omni for Linux をインストールする

プレビュー版

この機能は、 サービス固有の規約の対象となります。 pre-GA の機能は「現状のまま」で提供されるものであり、サポートが制限されることがあります。 詳細については、リリース ステージの説明をご覧ください。

このリリースへのアクセスについては、アクセス リクエスト ページをご覧ください。

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

• 現行バージョン（17.5.0）
• 17.5.0

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/17 など）として作成することをおすすめします。

   mkdir -p DATA_DIR

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

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=0
   gpgcheck=1
   gpgkey=https://dl.google.com/linux/linux_signing_key.pub
   EOF
   

   sudo yum makecache
   

   ALLOYDB_OMNI_URL は、アクセスに登録した後に受け取る AlloyDB Omni の URL に置き換えます。

   注: プレビュー リリースでは、パッケージの完全性は個々の RPM レベルで検証されます。repo_gpgcheck=0 を構成して、YUM リポジトリの構成を続行します。

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

   sudo dnf install alloydbomni17

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

   sudo PGPASSWORD=POSTGRES_PASSWORD PGDATA=DATA_DIR /usr/lib/postgresql/17/bin/alloydbomni17-setup initdb

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

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

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

   /sbin/restorecon -R -F DATA_DIR
   

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

   sudo PGPASSWORD=POSTGRES_PASSWORD /usr/lib/postgresql/17/bin/alloydbomni17-setup preparedb

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

   sudo /usr/lib/postgresql/17/bin/alloydbomni17-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

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

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

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

   sudo systemctl enable alloydbomni17
   

   sudo systemctl start alloydbomni17
   

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

   sudo systemctl status alloydbomni17

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

       Loaded: loaded (/usr/lib/systemd/system/alloydbomni17.service; enabled; preset: disabled)
      Drop-In: /etc/systemd/system/alloydbomni17.service.d
        Active: active (running) since Wed 2025-11-19 07:37:31 UTC; 1 day 6h ago "
      Process: 120228 ExecStartPre=/usr/lib/postgresql/17/bin/alloydbomni17-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/alloydbomni17.service
               ├─120231 /usr/lib/postgresql/17/bin/postgres -D /var/lib/postgresql/17/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 "
   

次のステップ

• AlloyDB Omni を実行して接続します。