安装clup-agent
1. 安装
您可以在下面的中启乘数科技官方Gitee仓库中获取最新版本的安装包:
在每台数据库主机上需要安装clup-agent模块。
clup-agent模块的安装包的名称类似如下:
- clup-agent5.0.3.el7.x86_64.bin
执行下面的命令进行安装:
bash clup-agent5.0.3.el7.x86_64.bin
安装后会产生以下目录:
- /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
2023-05-11 06:34:16,725 INFO clup-agent v5.0.3 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状态为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