CLup产品文档

往前插入
往后插入
删除

安装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地址和密码,内容如下:

  1. # 格式为 key = value
  2. # 如果机器有多个IP得知,需要指定使用哪个网段的IP地址,如果只有 一个网段IP,则不需要指定mgr_network。
  3. # mgr_network = 192.168.160.0
  4. # CLUP服务地址和端口
  5. server_address = 10.197.168.50:4242
  6. #agent与CLUP服务器之间通信的密码
  7. 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是否能正常工作,如果报如下错误:

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

这是因为openssl的版本太旧,查看版本:

  1. [root@CLUP opt]# rpm -qa |grep ssl
  2. openssl-1.0.2k-8.el7.x86_64
  3. openssl-libs-1.0.2k-8.el7.x86_64
  4. openssl-devel-1.0.2k-8.el7.x86_64

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

  1. yum update
  2. yum install openssl-devel

4. 注册服务

通常我们需要让clup-agent配置成开机自启动,可以用/opt/clup-agent/bin/clup-agent reg_service命令把clup-agent注册成系统的服务,这样就能开机自启动,如下所示:

  1. [root@pg01 ~]# /opt/clup-agent/bin/clup-agent reg_service
  2. 2022-05-11 06:34:16,725 INFO clup-agent v1.0.0 Copyright (c) 2019 HangZhou CSTech.Ltd. All rights reserved.
  3. 2022-05-11 06:34:16,726 INFO Start loading configuration ...
  4. 2022-05-11 06:34:16,726 INFO Complete configuration loading.
  5. Created symlink from /etc/systemd/system/multi-user.target.wants/clup-agent.service to /etc/systemd/system/clup-agent.service.
  6. register service sucessfully.

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

5. 启动服务

当把clup-agent注册成系统服务后,我们就可以用服务的管理命令启动clup-agent,如下所示:

  1. systemctl start clup-agent

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

  1. /opt/clup-agent/bin/clup-agent start

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

web管理界面

6. 停止服务

如果注册成了服务,可以使用systemctl stop clup-agent来停止clup-agent程序,当然我们也可以使用/opt/clup-agent/bin/clup-agent stop停止clup-agent程序:

  1. [root@CLUP0 ~]# /opt/clup-agent/bin/clup-agent stop
  2. Wait 4 seconds for program stopped...
  3. Wait 4 seconds for program stopped...
  4. Wait 4 seconds for program stopped...
  5. Wait 4 seconds for program stopped...
  6. Wait 4 seconds for program stopped...
  7. clup-agent force stopped