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

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）设置>

（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

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

推荐阅读

KunlunBase架构介绍
KunlunBase技术优势介绍
KunlunBase技术特点介绍
KunlunBase集群基本概念介绍

END

昆仑数据库是一个HTAP NewSQL分布式数据库管理系统，可以满足用户对海量关系数据的存储管理和利用的全方位需求。
应用开发者和DBA的使用昆仑数据库的体验与单机MySQL和单机PostgreSQL几乎完全相同，因为首先昆仑数据库支持PostgreSQL和MySQL双协议，支持标准SQL:2011的 DML 语法和功能以及PostgreSQL和MySQL对标准 SQL的扩展。同时，昆仑数据库集群支持水平弹性扩容，数据自动拆分，分布式事务处理和分布式查询处理，健壮的容错容灾能力，完善直观的监测分析告警能力，集群数据备份和恢复等 常用的DBA 数据管理和操作。所有这些功能无需任何应用系统侧的编码工作，也无需DBA人工介入，不停服不影响业务正常运行。
昆仑数据库具备全面的OLAP 数据分析能力，通过了TPC-H和TPC-DS标准测试集，可以实时分析最新的业务数据，帮助用户发掘出数据的价值。昆仑数据库支持公有云和私有云环境的部署，可以与docker，k8s等云基础设施无缝协作，可以轻松搭建云数据库服务。
请访问 http://www.kunlunbase.com/ 获取更多信息并且下载昆仑数据库软件、文档和资料。
KunlunBase项目已开源
【GitHub：】
https://github.com/zettadb
【Gitee：】
https://gitee.com/zettadb