安装clup-agent

1. 安装

clup-agent模块的安装包的名称类似如下：

clup-agent6.0.2.x86_64.bin

下载clup-agent安装包：

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

注意clup-agent版本与clup-server版本要对应，安装前请先检查clup-server的版本。

如需下载指定版本的clup-agent：

# 替换链接中两处"6.0.2"为目标版本号即可
# wget https://csudata.oss-cn-hangzhou.aliyuncs.com/clup/6.0.2/clup-agent6.0.2.x86_64.bin

root用户下执行下面的命令进行安装：

bash clup-agent6.0.2.x86_64.bin

安装后会产生以下目录：

/opt/clup-agent
/opt/clup-agent6.0.2

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

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-Server主程序中的RPC密码一致，否则Agent程序无法连接CLup-Server主程序，一般可以保持默认，如需修改请先修改CLup-Server端的配置。

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注册成一个服务，这个服务可以实现开机自启动的功能。

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

[root@pg01 ~]# /opt/clup-agent/bin/clup-agent reg_service
2023-05-11 06:34:16,725 INFO clup-agent v6.0.0 Copyright (c) 2019 HangZhou CSTech.Ltd. All rights reserved.
2023-05-11 06:34:16,726 INFO Start loading configuration ...
2023-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版本会显示当前安装的Agent的版本：

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

登录