安装clup-agent

1. 使用*.tar.gz的包手工安装

在每台数据库主机上需要安装clup-agentX.Y.Z.el7.x86_64.tar.xz。

拷贝clup-agentX.Y.Z.el7.x86_64.tar.xz软件包到/opt目录下并解压，会产生以下目录：

/opt/clup-agent
/opt/clup-agentX.Y.Z

其中/opt/clup-agent 为链接文件指向“/opt/clup-agentX.Y.Z”目录。

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 =XXXXXX

配置字段说明：

mgr_network = 192.168.160.0：当此台机器有多个不同网卡以及多个不同网段的IP地址时，此网络地址指定了内部通信走那个网段。
server_address = 10.197.163.30:4242 : 指定clup-server的IP地址和端口。如果时运行三个clup-server的情况下，这里需要配置三个clup-server的IP和端口，三个之间用逗号分隔。
agent_rpc_port = 4243：本Agent程序的监听端口。
internal_rpc_pass =XXXXXX：需要与CLup主程序中的RPC密码一致，否则Agent程序无法连接CLup主程序。

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@pg01 ~]# /opt/clup-agent/bin/clup-agent reg_service
2022-05-11 06:34:16,725 INFO clup-agent v1.0.0 Copyright (c) 2019 HangZhou CSTech.Ltd. All rights reserved.
2022-05-11 06:34:16,726 INFO Start loading configuration ...
2022-05-11 06:34:16,726 INFO Complete configuration loading.
Created symlink from /etc/systemd/system/multi-user.target.wants/clup-agent.service to /etc/systemd/system/clup-agent.service.
register service sucessfully.

注意：可能会因为防火墙的原因或者端口开放而连接不到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 stop clup-agent来停止clup-agent程序，当然我们也可以使用/opt/clup-agent/bin/clup-agent stop停止clup-agent程序：

[root@CLup0 ~]# /opt/clup-agent/bin/clup-agent stop
Wait 4 seconds for program stopped...
Wait 4 seconds for program stopped...
Wait 4 seconds for program stopped...
Wait 4 seconds for program stopped...
Wait 4 seconds for program stopped...
clup-agent force stopped