快速安装

1. 部署的架构

CLup程序分两个模块：

clup-server: 通常需要一台单独的机器安装此模块，此管理模块提供WEB界面以及其他的管理功能，高可用功能也是由此模块完成。clup-server从这台机器上去探测各个数据库是否正常，如果不正常，会执行相应的高可用切换动作。要求这台机器可以访问所有的数据库主机。clup-server本身也支持三节点部署，即管理平台自身也有高可用功能。
clup-agent: 每台数据库主机上都需要安装此模块，clup-server模块是通过向每台数据库主机上的clup-agent程序发送命令来完成对每台机器上的数据库的控制。

部署的架构图：

2. 机器的规划

部署CLup我们使用4台虚拟机，操作系统使用CentOS7.6，其中一台机器部署clup-server，其它3台机器上跑数据库并安装部署clup-agent程序。

主机名	IP	作用
clup0	10.197.160.2	部署clup-server
clup1	10.197.166.36	数据库机器，部署clup-agent
clup2	10.197.166.37	数据库机器，部署clup-agent
clup3	10.197.166.38	数据库机器，部署clup-agent

注意

对于企业版未注册时会有CPU的核数限制(Agent端合计20核心)，可以选择使用2核心虚拟机9台或者4核心虚拟机5台，这样就不会超过试用版的CPU核数限制。如果测试需要更多核心、解锁更多功能，可以电话0571-87603386，申请一个试用的license。

3. 安装部署

3.1 安装clup-server

我们使用安装脚本进行安装。如果想了解更详细的安装方法，请阅读后续章节《安装详解》中的内容。

安装openjdk（需要使用jdbc驱动来连接部分数据库，如Oracle、达梦、崖山等）

# 检查当前的java版本
java -version
# 如果版本低于11，则需要安装
yum -y install java-11-openjdk java-11-openjdk-devel

选择java的版本

update-alternatives --config java
# 输入openjdk-11对应的序号，然后回车即可
# 再次检查java的版本
java -version

下载安装包
```
wget https://csudata.oss-cn-hangzhou.aliyuncs.com/clup/6.0.2/clup-server6.0.2.x86_64.bin
```
如需下载指定的版本，替换链接中的两处”6.0.2”为目标版本号即可。

创建用户

groupadd -g 1910 clup
useradd -g clup -u 1910 -s /bin/bash -m clup
# 部分Linux发行版适用以下命令
addgroup -g 1910 clup
adduser -u 1910 -G clup -s /bin/bash -D clup

移动文件并修改文件属主

mv clup-server*.bin /home/clup/. && chown clup:clup /home/clup/clup-server*.bin

登录clup用户，运行bin文件

su - clup
bash clup-server6.0.2.x86_64.bin

重新登录下用户使.bashrc文件中的环境变量生效

# 1.重新登录用户
exit
su - clup
# 2.生成crontab任务
$HOME/clup-server/bin/clup-server auto_start
## 如果默认不允许普通用户创建crontab任务的话，需要在root用户下执行：echo "clup" >> /etc/cron.allow
# 3.启动服务
cd $HOME/clup-server/bin
./clup-server start

如果需要使用到虚拟机、LXC管理功能，还需要启动clup-dhcpd和clup-webvnc服务

# root下为clup-dhcpd服务开放1000以下端口的访问权限
setcap 'cap_net_bind_service=+ep' /home/clup/clup-server/bin/clup-dhcpd
su - clup
cd $HOME/clup-server/bin
# 启动相关服务
./clup-dhcpd start
./clup-webvnc start

然后我们在浏览器输入 http://10.197.160.2:8090 ，打开WEB界面：

默认的用户名为：admin
默认密码为：cstech

输入后就可以登陆CLup的管理界面了。WEB界面中可以管理的数据库当前都是空的，还需要在数据库主机中安装clup-agent后，才能进一步的操作。

3.2 安装clup-agent

在需要部署数据库的主机上安装clup-agent。在本示例是在10.197.166.36、10.197.166.37、10.197.166.38机器上安装clup-agent。

下载clup-agent安装包

cd /opt
wget https://csudata.oss-cn-hangzhou.aliyuncs.com/clup/6.0.2/clup-agent6.0.2.x86_64.bin

如需下载指定的版本，替换链接中的两处”6.0.2”为目标版本号即可。

执行命令安装

bash clup-agent6.0.2.x86_64.bin

输入clup服务端的IP地址10.197.160.2然后回车继续：

Enter Clup Server IP Addr: 10.197.160.2
Clup Server ip is  10.197.160.2!
==== register systemd service ...
2022-10-08 11:11:47,287 INFO clup-agent v4.4.8 Copyright (c) 2018-2022 CSUDATA.COM All rights reserved.
already register systemd service!
==== register systemd service ok.
==== Installation is complete.

4. 创建一个虚拟机

上传操作系统的iso镜像文件
网络管理->网络列表->编辑，配置下主机IP地址范围
主机管理
3.1 主机列表->修改机器类型为虚拟机宿主机(可以同时选择LXC宿主机)

3.2 选择“从iso光盘镜像文件安装”

3.3 填写相关信息，设置虚拟机资源，点击创建

3.4 在主机列表中找到新建的虚拟机，然后点击登录

3.5 根据操作系统的安装步骤，安装配置虚拟机的操作系统

5. 创建一个数据库

我们在上面的虚拟机中先安装clup-agent程序，然后在此虚拟机中安装一个PostgreSQL数据库。
安装PostgreSQL数据库可以使用PostgreSQL官方提供的方法安装，也可以使用我们提供的快速安装的PostgreSQL数据库的方法，先下载安装包：

wget https://gitee.com/csudata/csupg/releases/download/csupg_el7/csupg-14.9.el7.x86_64.bin

执行安装：

bash csupg-14.9.el7.x86_64.bin
# 数据库软件的目录会生成在/usr下

上面给出的示例是el7下的PostgreSQL14.9的版本，我们还提供了PG10~PG14的版本和el8的版本，请移步此处查看下载：csupg 发行版 - Gitee.com

登录

修改密码