一键安装

1. 一键安装及部署架构

CLup目前支持PostgreSQL9.6及以上的版本，不支持PostgreSQL9.6以下的版本。

安装CLup有两种方法：

1. 使用一键安装脚本进行安装。
2. 使用后续的 安装详解 中的内容一步一步安装CLup。

本文会详细介绍如何使用一键安装脚本安装CLup。一键安装脚本会从CLup官方网站中自动下载安装包，自动完成整个安装过程。

提示

使用一键安装脚本要求服务器能连接到互联网。如果您的服务器不能连接互联网，请使用安装详解中的方法安装CLup。
一键安装脚本需要wget和tar 命令，如果没有此工具请先安装wget tar。

CLup程序分两个模块：

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

部署的架构图：

2. 安装规划

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

提示

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

对于部署clup-server模块的机器，如果是生产系统磁盘空间最好大于200GB，这样便于保存更久的监控数据。如果只是想测试一下CLup，则对于空间没有什么特殊的要求。

开源CLup的Server端(clup)和Agent端(clup-agent)服务需要Python3.9的环境,我们在一些主流平台上直接提供了编译好的Python3.9的模块，此模块我们称之为csupy，是否提供了csupy的平台说明如下：

我们的开源版本的一键安装命令需要使用csupy，对于没有提供csupy的平台，则不能使用一键安装脚本安装CLup，需要参照文档(开源版本的安装)自建Python3的虚拟环境和手动一步一步安装CLup。

3. 安装clup-server

3.1 企业版的安装方法

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

在clup0主机上运行下面脚本即可一键安装，可以使用--clup-version参数或者设置CLUP_VERSION环境变量来指定安装的版本，支持的系统架构和版本请参照CLup简介-3. 平台支持。

安装最新版本：

wget -qO /tmp/clup.sh --no-check-certificate https://get.csudata.com/csuinst/clup.sh && bash /tmp/clup.sh clup install

安装指定版本(5.0.3)的clup:

wget -qO /tmp/clup.sh --no-check-certificate https://get.csudata.com/csuinst/clup.sh && bash /tmp/clup.sh clup install --clup-version=5.0.3

然后我们在浏览器输入 http://IP:8090 （IP: 单网卡主机为当前主机的IP，多网卡主机则是安装过程中所选择的IP地址），打开WEB界面：

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

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

如果安装出错了，可以运行下面的命令卸载CLup管理端：

wget -qO /tmp/clup.sh --no-check-certificate https://get.csudata.com/csuinst/clup.sh && bash /tmp/clup.sh clup remove

3.2 开源版的安装方法

CLup需要运行在Python3.9以上的Python环境中，而有些操作系统没有相适配的Python3，而这时可以用我们准备了好的Python3.9的软件包，这个软件包称为csupy。注意CLup企业版的运行不需要Python3环境，因为企业版CLup已经打包成独立运行的程序了。

目前开源版本支持的系统架构和版本请参照CLup简介-3.2 开源版支持平台。部分未提供csupy的环境，请参照文档开源版本的安装自行准备Python3的虚拟环境，Python的版本要求为3.9.16或者更高。

clup0主机上运行下面脚本即可一键安装

wget -qO /tmp/clup.sh --no-check-certificate https://get.csudata.com/csuinst/clup.sh && bash /tmp/clup.sh openclup install

然后我们在浏览器输入 http://IP:8090 （IP: 单网卡主机为当前主机的IP，多网卡主机则是安装过程中所选择的IP地址），打开WEB界面：

• 默认的用户名为：admin
• 默认密码为：openclup

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

4. 安装clup-agent

4.1 企业版的安装方法

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

使用以下命令一键安装clup-agent，可以使用--clup-agent-version参数或者设置CLUP_AGENT_VERSION环境变量来指定安装的版本，目前支持的系统架构和版本请参照CLup简介-3.1 企业版支持平台。

安装最新版本：

wget -qO /tmp/clup.sh --no-check-certificate https://get.csudata.com/csuinst/clup.sh && bash /tmp/clup.sh clup-agent install

安装指定版本的clup-agent(5.0.3):

wget -qO /tmp/clup.sh --no-check-certificate https://get.csudata.com/csuinst/clup.sh && bash /tmp/clup.sh clup-agent install --clup-gent-version=5.0.3

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

Enter Clup Server IP Addr: 10.197.166.35
Clup Server ip is  10.197.166.35!
==== 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.

如果安装出错了，可以运行下面的命令卸载clup-agent：

wget -qO /tmp/clup.sh --no-check-certificate https://get.csudata.com/csuinst/clup.sh && bash /tmp/clup.sh clup-agent remove

4.2 开源版的安装方法

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

clup-agent需要运行在Python3.9以上的Python环境中，而有些操作系统没有相适配的Python3，而这时可以用我们准备了好的Python3.9的软件包，这个软件包称为csupy。注意clup-agent企业版的运行不需要Python3环境，因为企业版已经打包成独立运行的程序了。

目前开源版本支持的系统架构和版本请参照CLup简介-3.2 开源版支持平台。部分未提供csupy的环境，请参照文档开源版本的安装自行准备Python3的虚拟环境，Python的版本要求为3.9.16或者更高。

可以使用一键安装脚本快速安装体验:

在主机上运行下面脚本即可一键安装

wget -qO /tmp/clup.sh --no-check-certificate https://get.csudata.com/csuinst/clup.sh && bash /tmp/clup.sh openclup-agent install

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

1) 10.197.166.35
2) 172.16.1.1
What is your ip? 1

5. 附录：一键安装脚本的使用说明

安装clup服务端的方法：

wget -qO /tmp/clup.sh --no-check-certificate https://get.csudata.com/csuinst/clup.sh && bash /tmp/clup.sh clup install

安装clup-agent的方法：

wget -qO /tmp/clup.sh --no-check-certificate https://get.csudata.com/csuinst/clup.sh && bash /tmp/clup.sh clup-agent install

卸载clup服务端的方法：

wget -qO /tmp/clup.sh --no-check-certificate https://get.csudata.com/csuinst/clup.sh && bash /tmp/clup.sh clup remove

卸载clup-agent的方法：

wget -qO /tmp/clup.sh --no-check-certificate https://get.csudata.com/csuinst/clup.sh && bash /tmp/clup.sh clup-agent remove

为了方便大家快速创建数据库来测试使用，我们提供了一键安装PostgreSQL11-14以及PolarDB数据库的方法，执行下面的命令后，选择对应的数据库安装即可，目前支持的系统架构和版本见下表。

PostgreSQL 支持：

PolarDB For PG v11 支持：

PolarDB For PG v15 支持：

安装命令

wget -qO /tmp/clup.sh --no-check-certificate https://get.csudata.com/csuinst/clup.sh && bash /tmp/clup.sh db install

如果需要在其他系统版本上安装数据库来测试使用，可以通过PostgreSQL官方方式来安装，安装文档如下：

https://www.postgresql.org/download/