鏡像描述

當前鏡像處于公測階段，您可在華東1資源池試用。如果您希望在其他資源池試用該鏡像，可以提交工單申請。

openGauss 是面向數據基礎設施的開源關系型數據庫。openGauss 調優鏡像由天翼云與 openGauss 社區聯合推出，基于 AI 學習自動優化數據庫參數，提供預裝 openGauss 并配置最優參數的 ECS 鏡像。使用該鏡像，用戶可快速部署 openGauss 數據庫，并獲得優于默認配置的性能表現。該鏡像采用 NUMA（Non-Uniform Memory Access，非統一內存訪問）分區優化、ARM 指令集加速等關鍵技術，并通過多輪測試數據訓練性能預測模型，最終實現接近真實業務場景的自動化最優調參。

配置要求

推薦配置：vCPU ≥ 4 核，內存 ≥ 16 GB；建議使用鯤鵬架構的云服務器。

免責說明

免責聲明：本鏡像中集成的 openGauss 數據庫來源于第三方開源社區，僅供用戶參考和使用。本公司不對因不當使用該鏡像所導致的任何損失或損害承擔法律責任。用戶應確保其使用行為符合相關法律法規，并遵守 openGauss 社區的相關協議。

實踐指南

數據庫鏡像使用指導

您可在華東1-云主機訂購頁-市場鏡像-服務器軟件分類 選擇試用openGauss調優專用鏡像。

自行安裝說明（若使用天翼云 openGauss 調優專用鏡像，可跳過此部分）。

極簡模式服務器單點參考：
//docs.opengauss.org/zh/docs/latest/docs/InstallationGuide/%E5%8D%95%E8%8A%82%E7%82%B9%E5%AE%89%E8%A3%85.html

下載數據庫安裝包(登錄 ，選擇對應平臺的最新安裝包下載。對于個人開發者或非企業級環境，下載極簡安裝包（不安裝OM等組件）即可)。

下載鏈接：//opengauss.org/zh/download/

考慮到 glibc 版本兼容性問題，CtyunOS操作系統需要下載 openEuler 22.03 對應的安裝版本：
x86_64:
//opengauss.obs.cn-south-1.myhuaweicloud.com/7.0.0-RC1/openEuler22.03/x86/openGauss-Server-7.0.0-RC1-openEuler22.03-x86_64.tar.bz2

arm64：
//opengauss.obs.cn-south-1.myhuaweicloud.com/7.0.0-RC1/openEuler22.03/arm/openGauss-Server-7.0.0-RC1-openEuler22.03-aarch64.tar.bz2

首次使用天翼云 openGauss 調優專用鏡像開通云主機后需要執行以下步驟：

# 禁用omm登錄
omm:x:1000:1000::/home/omm:/sbin/nologin
# omm用戶加入wheel組
wheel:x:10:omm
# 默認安裝目錄在/opt/openGauss

• 準備階段

  用戶可以直接root登錄創建一個自定義非root用戶，例如 dbuser：
  # 創建用戶，設置密碼
  useradd dbuser
  passwd dbuser
  # 加入wheel組
  usermod -aG wheel dbuser

• 設置數據庫文件句柄數（可選步驟，建議執行）

  系統默認的文件句柄數限制為 1024。當數據庫訪問的文件數量超過此限制時，將報錯“文件句柄數不足”。建議提前為自定義數據庫用戶（如 dbuser）將文件句柄數限制提升至 1,000,000。例如修改dbuser用戶文件句柄數1000000的腳本，之后需要重啟機器， 文件如下。

  #!/bin/bash
  # 檢查參數數量
  if [ $# -ne 2 ]; then
      echo "用法: $0 <用戶名> <文件句柄數限制>"
      echo "示例: $0 john 1024"
      exit 1
  fi
  
  # 獲取參數
  USER="$1"
  LIMIT="$2"
  CONFIG_FILE="/etc/security/limits.d/90-nofile.conf"
  # 檢查是否為root用戶
  if [ "$EUID" -ne 0 ]; then
      echo "錯誤: 請使用root權限運行此腳本"
      exit 1
  fi
  # 驗證限制值是否為數字
  if ! [[ "$LIMIT" =~ ^[0-9]+$ ]]; then
      echo "錯誤: 限制值必須為數字"
      exit 1
  fi
  # 檢查用戶是否存在
  if ! id "$USER" &>/dev/null; then
      echo "錯誤: 用戶 '$USER' 不存在"
      exit 1
  fi
  # 創建配置文件
  cat > "$CONFIG_FILE" << EOF
  # 文件句柄數限制配置
  # 創建時間: $(date)
  # 用戶: $USER, 限制: $LIMIT
  
  $USER soft nofile $LIMIT
  $USER hard nofile $LIMIT
  $USER soft nproc  $LIMIT
  $USER hard nproc  $LIMIT
  EOF
  
  # 檢查文件是否創建成功
  if [ $? -eq 0 ]; then
      echo "配置文件已創建: $CONFIG_FILE"
      echo "用戶 '$USER' 的文件句柄數限制已設置為: $LIMIT"
      
      # 顯示文件內容
      echo ""
      echo "配置文件內容:"
      echo "----------------------------------------"
      cat "$CONFIG_FILE"
      echo "----------------------------------------"
      
      echo ""
      echo "文件句柄數限制配置已完成"
      echo "注意: 用戶需要重新登錄才能使限制生效"
  else
      echo "配置文件創建失敗"
      exit 1
  fi

  使用root用戶執行修改命令。

  bash set_user_file_limit.sh dbuser 1000000

  使用dbuser重新登錄云服務器，檢查是否生效。

  ulimit -n  #查看當前文件句柄數是否修改成1000000

• 添加環境變量

  # dbuser 用戶登錄
  vi ~/.bashrc
  export GAUSSHOME=/opt/openGauss
  export PGDATA=${GAUSSHOME}/data
  export PATH=${GAUSSHOME}/bin:${PATH}
  export GAUSSLOG=${GAUSSHOME}/logs
  export LD_LIBRARY_PATH=${GAUSSHOME}/lib:${LD_LIBRARY_PATH}
  
  # 加載環境變量
  source ~/.bashrc

• 初始化數據庫

  # 初始化數據庫
  gs_initdb -D ${GAUSSHOME}/data --nodename=single_node -U dbuser -w <db_passwd>
  
  # 管理數據庫服務
  gs_ctl status # 查看數據庫狀態是否運行
  gs_ctl start -Z single_node   # 開始數據庫服務單點模式
  gs_ctl stop    # 停數據庫服務

  

   

  

• 測試數據庫

  # 創建測試數據庫
  gsql -c "CREATE DATABASE test;" -p5432 -U dbuser -d postgres
  gsql -p5432 -U dbuser -d test

  

  openGauss相關社區文檔

  關系型板塊	AI板塊

  補充說明

  鏡像制作時需要注意的幾個事項：

1. 如果數據庫配置文件需要修改，可以通過修改配置模版文件。

   /opt/openGauss/share/postgresql/postgresql.conf.sample

2. 制作鏡像前，刪除測試的數據庫和日志目錄。

   rm -rf /opt/openGauss/data/
   rm -rf /opt/openGauss/logs/
   chgrp wheel /opt/openGauss
   chmod -R 775 /opt/openGauss

3. CTyunOS的默認LC_TIME和LANG不一致，設置為一致。

   vi /etc/locale.conf
   LANG=en_US.UTF-8
   LC_TIME=en_US.UTF-8

4. 清理/etc/hosts 臨時虛機殘留內容。

   相關常見問題

   常見問題一：安裝過程如果通過安裝腳本install.sh會有"-bash: ulimit: open files: cannot modify limit: Operation not permitted"報錯

   sudo ulimit -n 1000000

   

   常見問題二：gs_ctl start服務提示"Failed to parse cgroup config file"

   該警告通常不影響數據庫正常運行，可忽略。若需消除，可安裝完整 cgroup 工具包或忽略日志。

   

   常見問題三：如何修改數據庫服務的監聽IP地址

   vim postgresql.conf
   #監聽所有地址
   listen_addresses = 'localhost' => listen_addresses = '*' 
   #重啟服務
   gs_ctl restart

   常見問題四：客戶端無法連接數據庫

   1. 先排查網絡是否可達，檢查安全組和iptables等規則。

   2. 如果前面檢查無任務問題，再檢查本地服務是否運行。

      gs_ctl status

   3. 服務端配置數據庫訪問白名單。

      vim pg_hba.conf
      最后添加（可以配置多條）
      host all all 0.0.0.0/0 sha256

   常見問題五：數據庫DBServer無法啟動

   請參考：。

   其他openGauss數據庫常見問題

   請參考：。