客服微信
本文为云贝教育 刘老师 原创，请尊重知识产权，转发请注明出处，不接受任何抄袭、演绎和未经注明出处的转载。
前言：什么是OpenTenBase
OpenTenBase 是一个提供写可靠性，多主节点数据同步的关系数据库集群平台。你可以将 OpenTenBase 配置一台或者多台主机上， OpenTenBase 数据存储在多台物理主机上面。数据表的存储有两种方式， 分别是 distributed 或者 replicated ，当向OpenTenBase发送查询 SQL时， OpenTenBase 会自动向数据节点发出查询语句并获取最终结果。
OpenTenBase 采用分布式集群架构（如下图）， 该架构分布式为无共享(share nothing)模式，节点之间相应独立，各自处理自己的数据，处理后的结果可能向上层汇总或在节点间流转，各处理单元之间通过网络协议进行通信，并行处理和扩展能力更好，这也意味着只需要简单的x86服务器就可以部署 OpenTenBase 数据库集群
下面简单解读一下OpenTenBase的三大模块
• Coordinator：协调节点（简称CN）
业务访问入口，负责数据的分发和查询规划，多个节点位置对等，每个节点都提供相同的数据库视图；在功能上CN上只存储系统的全局元数据，并不存储实际的业务数据。
• Datanode：数据节点（简称DN）
每个节点还存储业务数据的分片在功能上，DN节点负责完成执行协调节点分发的执行请求。
• GTM:全局事务管理器(Global Transaction Manager)
负责管理集群事务信息，同时管理集群的全局对象，比如序列等。
本文将详细介绍如何从源码开始，完成 OpenTenBase V2.6 的编译和安装过程。
一、安装准备及规划
1.1 环境要求
在开始编译之前，请确保你的系统满足以下要求：
• 操作系统：TencentOS 2, TencentOS 3, OpenCloudOS, CentOS 7, CentOS 8, Ubuntu
• 内存：至少 4GB RAM
• 磁盘空间：至少10GB，足够的磁盘空间用于源码下载、编译和安装
1.2 软件环境
1.3 集群规划
• 集群规划
下面以两台服务器上搭建1GTM主，1GTM备，2CN主（CN主之间对等，因此无需备CN），2DN主，2DN备的集群，该集群为具备容灾能力的最小配置
集群规划如下：
二. 安装依赖
根据你的操作系统，使用以下命令安装必要的依赖包：
对于基于 Red Hat 的系统（如 CentOS）：
对于基于 Debian 的系统（如 Ubuntu）：
三. 创建 OpenTenBase 用户
所有需要安装 OpenTenBase 集群的机器上都需要创建 opentenbase 用户，并设置相应的目录权限。
四. 获取安装包
4.1 git获取源码
• 创建软件目录
• 使用 git 克隆 OpenTenBase 的源码仓库：
克隆源码(root用户)
git clone https://github.com/OpenTenBase/OpenTenBase
4.2 下载源码包
登录git，下载最新的v2.6.0版本
五. 编译源码
5.1 配置安装环境变量
所有节点都要操作
5.2 编绎安装
• 将源码包移动到源码目录
• 进入源码目录并进行编译：
六、集群初始化
6.1 禁用 SELinux 和 防火墙 (可选)
6.2. 配置 SSH
互信为了方便后续操作，建议配置opentenbase机器间的 SSH 互信：
6.3. 配置opentenbase环境变量
集群所有机器都需要配置
6.4. 配置root环境变量
集群所有机器都需要配置,把opentenbase用户的$PATH环境变量添加到 /etc/environment
6.5. 初始化pgxc_ctl.conf文件
如下，是结合上文描述的IP，端口，数据库目录，二进制目录等规划来写的pgxc_ctl.conf文件。
pgxc_ctl.conf配置如下：
6.6. 分发二进制包
在一个节点上配置好配置文件后，使用 pgxc_ctl 工具将二进制包部署到所有节点：
分发日志
注：以下指令均在pgxc_ctl终端命令行中
6.6. 初始化集群
使用 pgxc_ctl 工具初始化集群：
初始化日志
6.7. 查看集群状态
日志如下
6.8. 安装错误处理
1）日志查看
一般init集群出错，终端会打印出错误日志，通过查看错误原因，更改配置即可，或者可以通过/data/opentenbase/pgxc_ctl/pgxc_log路径下的错误日志查看错误，排查配置文件的错误
2）清理集群重新安装
通过运行 pgxc_ctl 工具，执行clean all命令删除已经初始化的文件，修改pgxc_ctl.conf文件，重新执行init all命令重新发起初始化。
3) 常见问题
• 执行inti all时，提示pg_ctl命令找不到
这样的问题，通常是环境变量的问题，通过root用户配置/etc/environment 解决
• 执行inti all时，提示无法创建目录
这样的问题，通常是分发节点上，没有创建对应的目录
解决方案：检查所有节点的目录配置，如果没有创建，创建即可。
七、集群访问
访问OpenTenBase集群和访问单机的PostgreSQL基本上无差别，我们可以通过任意一个CN访问数据库集群：例如通过连接CN节点select pgxc_node表即可查看集群的拓扑结构（当前的配置下备机不会展示在pgxc_node中），在Linux命令行下通过psql访问的具体示例如下
7.1 登录cn主节点
7.2 使用数据库前需要创建default group以及sharding表
OpenTenBase使用datanode group来增加节点的管理灵活度，要求有一个default group才能使用，因此需要预先创建；一般情况下，会将节点的所有datanode节点加入到default group里 另外一方面，OpenTenBase的数据分布为了增加灵活度，加了中间逻辑层来维护数据记录到物理节点的映射，我们叫sharding，所以需要预先创建sharding，命令如下：
7.3 创建数据库，用户，创建表，增删查改等操作
八、集群启停
8.1 停止集群
停止日志
8.2 启动集群
九、结语
通过以上步骤，你已经成功地从源码编译并安装了 OpenTenBase V2.6。现在你可以开始使用 OpenTenBase 来管理你的分布式数据库集群。
想了解更多相关的学习资料(技术文章和视频)，可以微信公众号或B站搜索《云贝教育》，免费获取。
需要课程资料的同学可以私聊课程顾问：19941464235（微信同号）
