10 分钟快速玩转 kunlun cluster

该文档仅供参考，详细请查看：

https://gitee.com/zettadb/kunlun_scripts/blob/main/cluster/README.cn.md

在安装完所有的库和依赖情况下，相比于手动安装 kunlun cluster 需要 30 分钟到一个小时的时间安装，一键快速安装只需要 10 分钟就可以玩起来。

在安装之前，要确保安装环境满足以下要求：

1、所有节点所在机器须为 Linux, 安装了 bash, sed, gzip, python2, python2-dev 等工具或者库。python 2 可执行程序设置为 python2。

2、 所有集群节点所在机器已经正确设置好用户，节点将以该用户启动，该用户能够运行 sudo 而不需要密码。

3、对于安装存储节点的机器，需要预先安装以下库(此处为 ubuntu 20.04): libncurses5 libaio-dev。

4、 对于安装计算节点的机器，需要预先安装以下库(此处为 ubuntu 20.04): libncurses5 libicu66 python-setuptools gcc。

5、对于安装动作，需要预先将二进制发布包 ( percona-8.0.18-bin-rel.tgz, postgresql-11.5-rel.tgz,cluster_mgr_rel.tgz ) 放入当前目录. 此外，工具运行机器和节点所在机器间网络不能太慢，因为需要将发布包传递到这些机器上。

以 ubuntu 为示例，可以通过 sudo apt-get install 的方式安装对应库，如安装 python2：

该环境下已经安装 python2，所以提示 python2 是最新的版本。

可以通过 apt list --installed 的方式查看已安装的库。

由于列出出来的已安装的库太多，用 grep 过滤指定库是一个比较好的办法。

完成上述要求后，就可以开始一键快速安装 kunlun cluster

以下安装是基于个人环境安装  kunlun cluster  （仅供参考）

1、通过 git clone 方式在 gitee 上拉 kunlun-scripts 包：

git clone https://gitee.com/zettadb/kunlun_scripts.git

2、cd 进入 kunlun_scripts/cluster 下:

cd kunlun_scripts/cluster

3、获取最新的版本的下载包：以 0.8.3 为例（近期就会推出 0.8.4 版本，敬请期待）

（1）进入泽拓官网http://downloads.zettadb.com/，点击产品下载。

（2）点击 releases/0.8.3/release-binaries,获取三个安装包的下载地址，可以通过右键--复制链接地址的方式获取：

（3）在 ubuntu 里面使用 wget 方式获取三个下载包到当前 cluster 目录下：

4、编辑修改配置文件 install.json：vi install.json（配置详情看第五步）

5、现在有三个服务器，通过配置文件 install.json 在这三个服务器上配置集群节点：192.168.0.1、 192.168.0.2、 192.168.0.3

 (1)  设置 machines：在该设置下，因为权限原因，某台服务器无法创建默认目录，或者某台服务器无法使用默认用户，则脚本会使用 machines 里面配置的 user、basedir

(2) 设置 Meta-node（mysql）：

（3）设置 Comp-node（Postgresql）：

（4）设置 Data-node（mysql）： 

（5）设置 clustermgr：（一般为 meta-node 的主节点）

我们在配置的过程要有：

• 三个 mysql 节点，用来构成一个 3 副本的 Meta Shard

  
  

• 加上六个 mysql 节点，用来构成两个 Data Shard，每个 Shard 有 3 副本

  
  

• 三个 postgresql 节点，用来构成三个各自独立的节点，用来处理客户端的请求

  
  

当然，如果只有一个电脑情况下也可以把所有节点都设置成一个 ip 地址，端口不同就行，每个节点的 data_dir 要在不同目录下。

6、一键安装集群：使用到 generate_scripts.py 生成脚本，action 为 install，config 为刚刚编辑的配置文件 install.json，defuser 设置为默认工作用户。

defuser: 大部分或者全部机器都可以使用该用户，如无该默认用户则使用配置文件里 machines 的 user（自己指定）

(1) sudo python2 generate_scripts.py action=install config=install.json defuser=kunlun

(2) bash install/commands.sh

如果在该步骤被要求输入密码，设置当前账户自动验证登录，设置完毕后 ssh severname.com

ubuntu 可以参考：https://www.iteye.com/blog/quanminchaoren-1700174

centos 可以参考:  https://blog.csdn.net/zyj493132456/article/details/79627511

(3) 耐心等待两三分钟，只要不出现  !!!FAILURES!!!  或者其它错误就代表安装成功了

7、一键停止集群 stop：defbase 为默认工作目录，Action 为 stop。

defbase: 大部分或者全部机器都可以创建该默认工作目录，如无法创建默认工作目录则使用配置文件里 machines 的 basedir（自己指定）

(1) python2 generate_scripts.py action=stop config=install.json defbase=/kunlun

(2) bash stop/commands.sh

8、一键启动集群 start：action 为 start。

(1) sudo python2 generate_scripts.py action=start config=install.json

(2) bash start/commands.sh

9、一键清除集群 clean：action 为 clean。

(1) sudo python2 generate_scripts.py action=clean config=install.json

(2) bash clean/commands.sh

使用该命令前，工作目录不可以先清除，否则脚本无法找到工作目录，无法执行该命令，使用完毕后再消除工作目录

需要技术支持可以微信搜索微信号（KunLunDB-Linda），添加客服，在线沟通即可。