安裝 Linux 版 AlloyDB Omni

選取說明文件版本：

您可以在支援 RHEL 9 執行階段的任何 Linux 電腦或 Bare Metal 伺服器上，執行 AlloyDB Omni 的單一執行個體安裝作業。

如要開始使用這項部署模型，請提交這份表單來申請存取權。

事前準備

安裝 AlloyDB Omni 前，請先閱讀「規劃 AlloyDB Omni 安裝作業」。

建立 AlloyDB Omni 儲存資料的目錄

如果您使用的儲存系統會一併執行 AlloyDB Omni 和其他應用程式，可以在裝置的現有檔案系統中建立 AlloyDB Omni 目錄。否則，您可以在專屬裝置上建立新的檔案系統。

現有檔案系統

如要在現有檔案系統中建立目錄，請執行下列指令：

mkdir -p DATA_DIR

請替換下列變數：

  • DATA_DIR：儲存資料的主機目錄路徑。

專用裝置

如要在專屬檔案系統中建立目錄，請執行下列步驟：

  1. 在主機上建立磁碟掛接目錄。

    mkdir -p MOUNT_POINT

    請替換下列變數：

    • ：應包含 AlloyDB Omni 執行個體的頂層目錄路徑。MOUNT_POINT

  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 政策

安裝必要的 policycoreutils-python-utils 套件，以便在安裝 AlloyDB Omni RPM 套件時，將 SELinux 政策設為允許 AlloyDB Omni 資料庫服務。

安裝 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 網址。

  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

    您可以選擇在 POSTGRES_INITDB_ARGS 變數中，以單一字串形式傳遞標準 initdb 選項。

  4. 準備 AlloyDB Omni 資料庫。

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

  5. 選用。如要以最佳化方式執行 AlloyDB Omni 服務，請執行下列指令。

    sudo /usr/lib/postgresql/17/bin/alloydbomni17-setup-host

  6. 啟動 AlloyDB Omni systemd 服務。

    sudo systemctl enable alloydbomni17
$ sudo systemctl start alloydbomni17

  7. 檢查 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 "

後續步驟