# 基于腾讯云 OrcaTerm AI 快速部署 OpenTenBase 5.0：从零开始的实战记录
## 引言
在高校的技术社团里，我们经常需要在短时间内搭起一套数据库环境，用来做技术验证或项目练手。OpenTenBase 5.0 作为一款开源的分布式关系型数据库，其“GTM-CN-DN”架构设计非常清晰，很适合在校园场景下学习分布式数据库的核心思想。但问题在于——传统的手动编译部署流程实在太过繁琐，依赖多、步骤杂，对刚入门的同学来说，光是搞清楚哪一步该做什么就能劝退一半人。
这段时间我们刚好在折腾腾讯云的 **OrcaTerm AI** 终端助手，发现了一个很有意思的玩法：用自然语言跟它对话，让它来生成命令、分析报错、给出修复建议。于是就有了这篇实践记录——整个流程从源码编译到集群启动，从头到尾只花了大约30分钟（其中编译占了大部分时间，实际操作差不多15分钟）。直接说结论：**门槛确实降下来了**。
本文适合拿来当社团活动、个人学习或教学实验环境的参考。
> 阅读提示：每点下方的文本框中为 Prompt，以及对应的对话示范和执行结果。本教程已经过完整复现，保证能正确完成操作。当前 Prompt 还有优化空间，欢迎交流。
## 环境要求
先来看看硬件和系统要求：
| 项目 | 要求（截止 2026 年 6 月 6 日） |
|:----:|:----:|
| 操作系统 | TencentOS 2/3, OpenCloudOS 8.x, CentOS 7/8, Ubuntu 18.04 |
| 内存 | 最小 8G RAM |
| 磁盘空间 | 至少 20GB 可用空间 |
| 网络 | 需要访问外网下载依赖包和源码 |
| 工具 | 腾讯云 OrcaTerm（含 AI 助手功能）|
这次实际使用的是 **OpenCloudOS 9** 系统，配置如下：
## 一、OrcaTerm 环境接入与 AI 助手准备
### 1.1 登录 OrcaTerm
通过腾讯云控制台进入 OrcaTerm 终端，选择目标 CVM 实例一键登录。整个过程没什么特别的，重点是打开右上角的 OrcaTerm AI 助手——点击即可唤起。目前支持混元、DeepSeek、Kimi 等多个模型，默认的混元大模型就够用，这次用的是 Kimi。
### 1.2 AI 助手交互模式说明
OrcaTerm AI 有两种核心用法：
1. **AI 问答界面**：右侧边栏输入自然语言描述，AI 返回完整的命令步骤。
2. **AI 命令搜索**：在终端命令行右键选择“AI 命令搜索”，输入需求快速获取单条命令。
这次主要用的是 AI 问答界面做多轮对话式部署。额度方面，每天免费 50 次，完成本文全流程大概消耗 20~30 次，完全够用。
## 二、环境准备（AI 辅助）
### 2.1 关闭防火墙和 SELinux
直接向 AI 提问，这是最舒服的地方——不用去想命令怎么写，说清楚需求就行。
> 我想在 OpenCloudOS 上部署 OpenTenBase 5.0，需要关闭防火墙和 SELinux，给出命令。
AI 回应：
```
systemctl stop firewalld && systemctl disable firewalld && setenforce 0 && sed -i 's/^SELINUX=.*/SELINUX=disabled/' /etc/selinux/config
```
执行后发现，OpenCloudOS 默认没有装 firewalld，所以关闭 firewalld 的那条命令报了错，但 SELinux 已经成功关掉了。AI 还贴心地补充了备选方案：如果系统用的是 iptables 或 nftables，可以换用对应的关闭命令。
这一点其实很有用——传统方式下我们可能直接跳过报错，但 AI 会解释为什么报错、怎么处理。
### 2.2 安装系统依赖
> OpenTenBase 5.0 在 OpenCloudOS 上编译需要哪些依赖？给出完整的 dnf 安装命令，包括 gcc、cmake、readline、openssl、uuid、bison、flex、libxml2、libxslt 等。
AI 给出了完整命令：
```
dnf install -y gcc gcc-c++ cmake make readline-devel openssl-devel libuuid-devel bison flex libxml2-devel libxslt-devel zlib-devel perl-ExtUtils-Embed python3-devel libicu-devel pam-devel libevent-devel libyaml-devel lz4-devel
```
执行完毕后，AI 还列了一张完整的安装清单，21 个包的状态一目了然。如果遇到 `cli11-devel` 找不到的情况，可以用 `dnf search cli11` 确认包名，或者从源码编译安装。
### 2.3 创建用户与目录
> 创建 OpenTenBase 专用用户 opentenbase，家目录 /data/opentenbase，同时创建 /data/opentenbase 目录并设置正确权限。
```
mkdir -p /data/opentenbase && useradd -d /data/opentenbase -m -s /bin/bash opentenbase && chown -R opentenbase:opentenbase /data/opentenbase && chmod 755 /data/opentenbase && id opentenbase
```
这一步没什么难度，但 AI 会在执行后反馈每个步骤的状态——目录创建、用户创建、权限设置是否成功，完成后还会提示后续用 `su - opentenbase` 切换用户。
## 三、源码获取与编译
### 3.1 获取源码
> 从 GitHub 克隆 OpenTenBase 最新源码到 /data/opentenbase/OpenTenBase，要求加速下载。如果 GitHub 连不上，给出 Gitee 镜像地址。
```
git clone --depth=1 https://ghfast.top/https://github.com/OpenTenBase/OpenTenBase.git /data/opentenbase/OpenTenBase
```
这里用了加速镜像，`--depth=1` 只拉取最新版本，总共 8,419 个文件、32.44 MiB，速度还不错。如果加速镜像不好使，AI 也给出了 Gitee 镜像作为备用方案。
### 3.2 编译主程序
> 编译 OpenTenBase 5.0 主程序，源码在 /data/opentenbase/OpenTenBase，安装路径 /data/opentenbase/install/opentenbase_bin_v5.0。要求：启用 user-switch、libxml、openssl、ossp-uuid，关闭 license 检查，开启调试信息 CFLAGS="-g"。
```
cd /data/opentenbase/OpenTenBase && export CFLAGS="-g" && ./configure --prefix=/data/opentenbase/install/opentenbase_bin_v5.0 --enable-user-switch --with-libxml --with-openssl --with-ossp-uuid --disable-license-check
```
这里有两个重点参数：`--disable-license` 绕过了许可证检查（等价于编译时加 `-DNOLIC`），`CFLAGS="-g"` 开启调试符号，方便后续排查问题。AI 自动生成了完整的 configure 命令，后续执行 `make -j$(nproc)` 和 `make install` 即可。
### 3.3 编译扩展模块
> 编译 OpenTenBase 5.0 的 contrib 扩展模块，包括 pgxc_ctl 等，给出完整命令。
先设置 `make_signature` 的可执行权限，然后进入 contrib 目录编译安装。AI 会提示安装结果——包括二进制工具、库文件、扩展脚本和头文件的安装情况。
## 四、环境配置
### 4.1 环境变量
> OpenTenBase 安装路径是 /data/opentenbase/install/opentenbase_bin_v5.0，帮我生成需要写入 .bash_profile 的环境变量，包括 PATH、LD_LIBRARY_PATH、LC_ALL。
AI 生成的内容非常完整：
```
export OPENTENBASE_HOME=/data/opentenbase/install/opentenbase_bin_v5.0
export PATH=$OPENTENBASE_HOME/bin:$PATH
export LD_LIBRARY_PATH=$OPENTENBASE_HOME/lib:$LD_LIBRARY_PATH
export LC_ALL=C
```
执行 `source` 后，`pg_ctl --version` 和 `psql --version` 都能正确识别版本号。
### 4.2 配置 SSH 免密登录
> 为 opentenbase 用户配置 SSH 免密登录本机，要求非交互式生成密钥，自动配置 authorized_keys。
```
su - opentenbase -c 'mkdir -p ~/.ssh && chmod 700 ~/.ssh && ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa -N "" -C "opentenbase@localhost" && cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys'
```
AI 会自动测试 SSH 免密登录是否成功，如果失败还会给出排查建议。
## 五、集群初始化（集中式模式）
### 5.1 创建配置文件
> 我需要一份 OpenTenBase 集中式模式的配置文件 opentenbase_config.ini，单节点部署，IP 10.6.0.11，实例名 opentenbase_single，数据节点配置目录 /home/opentenbase/opentenbase_ctl/postgres.conf。
AI 直接生成了一份完整的 INI 配置文件，涵盖了 `[common]`、`[coordinator]`、`[datanode]`、`[gtm]`、`[gtm_proxy]`、`[cluster]` 等所有段。端口规划也很清晰：GTM(30001)、GTM Proxy(30002)、Coordinator(30004/30005)、DataNode(30006)。
### 5.2 准备 postgres.conf
> 从安装目录复制 postgresql.conf.sample 到目标位置，同时创建日志目录。
AI 自动完成了复制和目录创建，并提示了权限设置。
### 5.3 打包二进制
> 将安装目录打包成 tar.gz。
```
cd /data/opentenbase/install && tar -czf opentenbase-5.21.8-i.x86_64.tar.gz opentenbase_bin_v5.0
```
打包后文件大小为 28MB，还生成了 SHA256 校验码，方便后续分发。
### 5.4 使用 opentenbase_ctl 初始化集群
> 使用 opentenbase_ctl 初始化集中式集群。
这里有个小插曲：AI 生成的 ini 配置中部分参数需要调整，但整体不影响初始化结果。最终集群初始化成功后，GTM、Coordinator、DataNode 三个组件全部运行正常。
## 六、启动数据库
### 使用 pg_ctl 启动
> 使用 pg_ctl 启动 DataNode。
```
su - opentenbase -c "/data/opentenbase/install/opentenbase_bin_v5.0/bin/pg_ctl start -Z datanode -D /data/opentenbase/data/dn -l /data/opentenbase/data/dn/pg_ctl_start.log"
```
关键参数：必须加 `-Z datanode` 指定节点类型，这是 OpenTenBase 的硬性要求。
## 七、验证安装
### 7.1 检查进程和端口
> 查看 postgres 进程和监听端口。
```
ps aux | grep -E 'postgres|gtm' | grep -v grep
ss -tlnp | grep -E '30004|30006|30008|30001|30002'
```
三组件全部运行中，端口监听正常。
### 7.2 连接测试
> 使用 psql 连接，查看版本。
```
su - opentenbase -c "psql -h 10.6.0.11 -p 30004 -U opentenbase -d postgres -c 'SELECT version();'"
```
返回版本信息：
```
PostgreSQL 10.0 @ OpenTenBase_v5.0 (commit: b612d77cb)
```
### 7.3 查看节点信息
```sql
SELECT node_name, node_type, node_host, node_port, node_forward_port, nodeis_primary FROM pgxc_node ORDER BY node_type;
```
| 节点名 | 类型 | 主机 | 端口 | 主节点 |
|:----:|:----:|:----:|:----:|:----:|
| gtm | G | 10.6.0.11 | 30001 | 是 |
| coord1 | C | 10.6.0.11 | 30004 | 否 |
| dn1 | D | 10.6.0.11 | 30006 | 否 |
单节点集中式模式部署完成。
## 八、排障指南
大多数情况下 OrcaTerm AI 会自动排除故障，这部分作为参考。
**8.1 opentenbase_ctl install 报错**：检查配置文件中 `sla ve=` 是否为空，确认集中式模式不需要 sla ve。
**8.2 GTM 相关错误**：集中式模式无独立 GTM，检查 `postgresql.conf` 中的 `gtm_host` 和 `gtm_port` 配置。
**8.3 pg_ctl 启动失败**：必须加 `-Z datanode` 参数。
**8.4 连接被拒绝**：依次检查防火墙、SELinux、`pg_hba.conf`。
**8.5 环境变量不生效**：确认执行了 `source ~/.bash_profile`，检查 `.bashrc` 中是否有覆盖 PATH 的操作。
## 九、总结
通过这次实践，用 OrcaTerm AI 辅助部署 OpenTenBase 5.0 的提效点非常明显：
| 环节 | 传统方式 | AI 辅助方式 |
|:----:|:----:|:----:|
| 依赖安装 | 查文档逐个确认包名 | 描述需求，AI 生成完整 dnf 命令 |
| 编译配置 | 手动拼接 configure 参数 | AI 自动生成含关键参数的完整命令 |
| 配置文件 | 手写 INI/Shell 配置 | 描述场景，AI 直接生成 |
| 故障排查 | 搜索报错信息 | 粘贴日志，AI 分析原因并给出修复命令 |
**几个关键经验：**
- 集中式模式适合开发测试，部署步骤比分布式少很多。
- `--disable-license` 是绕过许可证检查的关键参数。
- `opentenbase_ctl install` 只执行 `initdb`，不会自动启动，启动需单独执行。
- `pg_ctl` 启动时必须加 `-Z datanode` 指定节点类型。
**目录结构速查：**
```
/data/opentenbase/
├── data/ # 数据目录
│ ├── coord/ # Coordinator 数据
│ ├── dn/ # DataNode 数据
│ └── gtm/ # GTM 数据
├── install/ # 安装目录
│ ├── opentenbase-5.21.8-i.x86_64.tar.gz
│ └── opentenbase_bin_v5.0/ # 二进制文件
├── log/ # 日志目录
├── OpenTenBase/ # 源码目录
├── opentenbase_config.ini/ # 配置文件
└── .ssh/ # SSH 密钥
