安装企业版本clup-agent

1. 安装

每台数据库主机上都需要安装clup-agent模块，clup-agent模块安装包的名称类似如下：

clup-agent5.1.5.el7.x86_64.bin

可以在下面的中启乘数科技官方提供的下载地址上获取最新版本的安装包：

序号	操作系统	x86_6架构	Arm64架构
1	RHEL/CentOS 7	clup-agent5.1.5.el7.x86_64.bin	❌
2	RHEL/CentOS/RockyLinux/AlmaLinux 8	clup-agent5.1.5.el8.x86_64.bin	clup-agent5.1.5.el8.aarch64.bin
3	RHEL/CentOS/RockyLinux/AlmaLinux 9	clup-agent5.1.5.el9.x86_64.bin	clup-agent5.1.5.el9.aarch64.bin
4	Debian11	clup-agent5.1.5.deb11.x86_64.bin	clup-agent5.1.5.deb11.aarch64.bin
5	Debian12	clup-agent5.1.5.deb12.x86_64.bin	clup-agent5.1.5.deb12.aarch64.bin
6	OpenEuler20.03	clup-agent5.1.5.euler2003.x86_64.bin	❌
7	OpenEuler22.03	clup-agent5.1.5.euler2203.x86_64.bin	clup-agent5.1.5.euler2203.aarch64.bin
8	OpenEuler24.03	clup-agent5.1.5.euler2403.x86_64.bin	clup-agent5.1.5.euler2403.aarch64.bin
9	银河麒麟v10(ky10)	clup-agent5.1.5.ky10.x86_64.bin	clup-agent5.1.5.ky10.aarch64.bin
10	Ubuntu22.04	clup-agent5.1.5.ubuntu2204.x86_64.bin	clup-agent5.1.5.ubuntu2204.aarch64.bin
11	Ubuntu24.04	clup-agent5.1.5.ubuntu2404.x86_64.bin	clup-agent5.1.5.ubuntu2404.aarch64.bin
12	Alpine	clup-agent5.1.5.alpine.x86_64.bin	clup-agent5.1.5.alpine.aarch64.bin

下面的示例环境是x86_64架构下的RockyLinux 8，其需要安装el8.x86_64版本的程序包。

可以将安装包下载到主机上的任意一个目录下，执行安装：

wget https://csudata.oss-cn-hangzhou.aliyuncs.com/clup/5.1.5/clup-agent5.1.5.el8.x86_64.bin
bash clup-agent5.1.5.el8.x86_64.bin

此安装包安装后会生成以下目录：

/opt/clup-agent：软连接，指向当前实际使用的clup-agent所在目录；
/opt/clup-agent5.1.5：实际的clup-agent主程序目录。

2. 配置clup-agent

clup-agent配置文件为/opt/clup-agent/conf/clup-agent.conf，这个配置文件比较简单，主要是配置了连接主程序的IP地址和密码，内容如下：

# 格式为 key = value
# 如果机器有多个IP得知，需要指定使用哪个网段的IP地址，如果只有一个网段IP，则不需要指定mgr_network。
# mgr_network = 192.168.160.0
# CLup服务地址和端口
server_address = 10.197.168.50:4242
# agent与CLup服务器之间通信的密码
internal_rpc_pass = clup_pass_pwd

3. 一些问题的解决

检查clup-agent是否能正常工作，如果报如下错误：

[root@CLup opt/clup-agent]# ./clup-agent --help
/lib64/libcrypto.so.10: version `OPENSSL_1.0.2' not found (required by xxxxx)

这是因为openssl的版本太旧，查看版本：

[root@CLup opt]# rpm -qa |grep ssl
openssl-1.0.2k-8.el7.x86_64
openssl-libs-1.0.2k-8.el7.x86_64
openssl-devel-1.0.2k-8.el7.x86_64

openssl版本应该是1.0.2以上的版本。
如果不是上面的版本，请运行：

yum update
yum install openssl-devel

4. 注册服务

安装过程会自动把clup-agent注册成一个服务，这个服务可以实现开机自启动的功能。

当然我们也可以手工用/opt/clup-agent/bin/clup-agent reg_service命令把clup-agent注册成系统的服务，如下所示：

[root@CLup-Server02 ~]# /opt/clup-agent/bin/clup-agent reg_service
2024-08-22 03:16:00,324 INFO clup-agent v5.1.5 Copyright (c) 2018-2023 CSUDATA.COM All rights reserved.
register service clup-agent sucessfully.

注意

可能会因为防火墙的原因或者端口开放而连接不到CLup Server端，导致注册失败，请在防火墙上开放相关端口或关闭防火墙。

5. 启动服务

安装完后，clup-agent会自动启动。如果没有启动，我们可以使用下面的管理命令手工启动clup-agent，如下所示：

systemctl start clup-agent

如果我们不把clup-agent注册成系统服务，则手工启动clup-agent的方法为：

/opt/clup-agent/bin/clup-agent start

在一台机器上成功启动clup-agent之后，在web管理界面中就可以看到这台机器上的agent状态为up了：

6. 停止服务

使用systemctl命令

systemctl stop clup-agent

没有注册系统服务，则需要使用下面的命令

/opt/clup/bin/clup-agent stop