开发者社区

文档建议反馈控制台

文章/答案/技术大牛

发布

社区首页 >专栏 >在 Ubuntu 24.04 上安装 OpenTenBase：从「报告成功」到真的跑起来

在 Ubuntu 24.04 上安装 OpenTenBase：从「报告成功」到真的跑起来

peaunt

发布于 2026-09-29 21:08:02

发布于 2026-09-29 21:08:02

690

举报

概述

作为一名有着开源精神的学生，装 OpenTenBase 纯粹是为了学习分布式数据库，但这一次的安装版本与以往不同，本次的分享内容基于我自己的安装过程的一些报错和感悟。

文章被收录于专栏：开源社团技术日记开源社团技术日记

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

目录

写在前面

一、先搞清楚要装的是什么：OpenTenBase 的三个角色

二、我的环境

三、整体路线图

第一部分：准备工作（步骤 1–3）
- 步骤 1：环境预检
- 步骤 2：认清集群架构
- 步骤 3：选定安装方式

第二部分：装包（步骤 4–7）
- 步骤 4：配置官方 APT 源
  - 一个我差点误判的安全细节
- 步骤 5：安装 opentenbase
- 步骤 6：补 libssl1.1 —— 最关键的一步
  - 为什么不能用系统自带的 OpenSSL 3.0？
    - 先把三个版本号拆开
    - 为什么 1.1 不能换成 3.0
    - 那我把 3.0 软链成 1.1 骗过去呢？
    - 那我这样算给系统降级了吗？
    - 如果非要用 3.0，唯一的正解
- 步骤 7：修复 libpqxx / libreadline
  - 7.1 libpqxx-7.9.so —— 软链就够了
  - 7.2 libreadline.so.7 —— 也可以软链
  - 7.3 全量检查

第三部分：踩坑实录 —— 一次「报告成功」的失败
- 第一次部署：六个步骤全绿
- 启动：三个节点全挂
- 排查一：日志里的端口是垃圾值
- 排查二：数据目录里没有 PG_VERSION
- 排查三：initdb 的命令里有个黑洞
- 手动复现：真凶现身
- 因果链复盘

第四部分：依赖补齐后部署（步骤 8–11）
- 步骤 8：用户与 SSH 免密
  - 为什么要手动建 .bashrc
- 步骤 9：打包 tar.gz
- 步骤 10：生成 config.ini
- 步骤 11：执行部署
  - 三条我认为最值钱的经验