設定 AlloyDB Omni 以用於實際工作環境

選取說明文件版本：

本頁說明使用 AlloyDB Omni 處理正式版工作負載時的常見設定。

啟用巨型分頁

AlloyDB Omni 與 PostgreSQL 一樣，支援使用巨型頁面。這需要機器啟用巨型頁面，且您也需要啟用資料庫設定 huge_pages。

執行提供的指令碼，在機器上啟用巨型分頁：

Docker

      docker run --rm --privileged google/alloydbomni setup-host

Docker

      docker run --rm --privileged google/alloydbomni setup-host

Podman

      podman run --rm --privileged google/alloydbomni setup-host

Podman

      podman run --rm --privileged google/alloydbomni setup-host
在 postgresql.conf 中新增下列程式碼，啟用巨型頁面：

   huge_pages=on

啟用交換功能

在作業系統中進行交換，可讓您在隨機存取記憶體 (RAM) 和硬碟之間移動閒置的記憶體頁面，釋出 RAM 空間供執行中的程序使用，藉此擴充可用的實體記憶體。AlloyDB Omni 在高負載且需要額外記憶體時，會使用交換功能。

如要查看系統啟用的交換空間大小，請執行下列指令：

   cat /proc/meminfo | grep SwapTotal

輸出看起來類似以下內容：

   SwapTotal:      165748732 kB

如果輸出值為 0，請參閱下列內容，瞭解如何在作業系統上啟用交換功能：

啟用核心 dump

如果 AlloyDB Omni 發生無法復原的錯誤並當機，核心 dump 有助於分析問題。核心 dump 是 AlloyDB Omni 程序當機時的記憶體快照。

如要設定核心傾印，請按照下列方式設定 kernel.core_pattern：

  1. 使用 sysctl 指令設定執行階段核心參數。

  2. 如要立即設定 kernel.core_pattern，請使用：

    sysctl -w kernel.core_pattern="CORE_PATTERN"

    將 CORE_PATTERN 替換為核心檔案名稱模式，例如「%e-%t.core」。

    如要進一步瞭解核心檔案名稱模式，請參閱「如何設定程序核心檔案名稱」。

    systemd-coredump 處理常式可進一步設定 coredump 設定。RHEL 預設會安裝這項工具。在 Debian 和 Ubuntu 系統上，執行 sudo apt install coredumpctl 即可安裝工具。

啟動 AlloyDB Omni 時，請務必在 docker run 指令中傳遞 --ulimit=core:-1:-1 引數：

Docker

   docker run --name CONTAINER_NAME 

   -e POSTGRES_PASSWORD=NEW_PASSWORD 

   --ulimit=core:-1:-1 

   -p HOST_PORT:5432 -d google/alloydbomni

Docker

   docker run --name CONTAINER_NAME 

   -e POSTGRES_PASSWORD=NEW_PASSWORD 

   --ulimit=core:-1:-1 

   -p HOST_PORT:5432 -d google/alloydbomni

Podman

   podman run --name CONTAINER_NAME 

   -e POSTGRES_PASSWORD=NEW_PASSWORD 

   --ulimit=core:-1:-1 

   -p HOST_PORT:5432 -d google/alloydbomni

Podman

   podman run --name CONTAINER_NAME 

   -e POSTGRES_PASSWORD=NEW_PASSWORD 

   --ulimit=core:-1:-1 

   -p HOST_PORT:5432 -d google/alloydbomni

更改下列內容：

  - `CONTAINER_NAME`: the name of a new
    AlloyDB Omni container—for example, `my-omni-1`.
  - `NEW_PASSWORD`: the password assigned to the new
    container's `postgres` user after the password creation.

啟用內部記錄功能

除了常規 PostgreSQL 記錄外，AlloyDB Omni 還會提供更多訊息。這些訊息屬於技術性質，適用於 AlloyDB for PostgreSQL 支援。不過，額外資訊有助於偵錯資料庫問題。

如要啟用內部記錄功能，請完成下列步驟：

  1. 將資料庫參數 enable_alloydb_internal_log 設為 on：

    ALTER SYSTEM SET enable_alloydb_internal_log=on;

    如要進一步瞭解如何修改 AlloyDB Omni 設定，請參閱「設定 AlloyDB Omni 資料庫參數」。

  2. 重新啟動 AlloyDB Omni 服務：

Docker

   docker restart CONTAINER_NAME

Docker

   docker restart CONTAINER_NAME

Podman

   podman restart CONTAINER_NAME

Podman

   podman restart CONTAINER_NAME

如要進一步自訂內部記錄，例如設定記錄檔名稱和輪替政策，請使用 PostgreSQL 參數。

例如，log_directory 參數指定儲存記錄檔的目錄，log_filename 參數則定義個別記錄檔的名稱。

AlloyDB Omni 會合併 log_directory 和 log_filename 參數，並依下列方式儲存內部記錄：

LOG_DIRECTORY/LOG_FILENAME.internal

設定 systemd 單位，自動執行作業

如果您在專屬伺服器上執行 AlloyDB Omni，可能需要設定某些作業，在伺服器啟動時自動啟動。其中一種做法是使用 systemd 單位。

舉例來說，下列步驟會設定 systemd，以便在伺服器啟動時自動啟用巨型頁面。

在 /etc/systemd/system/alloydb-setup-env.service 中建立檔案：

   [Unit]
   Description=Setup huge pages for AlloyDB Omni

   [Service]
   Type=oneshot

   ExecStart=/usr/bin/docker run --rm --privileged google/alloydbomni setup-host

   [Install]
   WantedBy=multi-user.target

請按照下列步驟啟用服務：

   sudo systemctl enable alloydb-setup-env.service

後續步驟