本章节介绍LightDB多发比对服务的安装。分为手动安装方式，和一键部署方式。

10.4.1. 手动部署方式

10.4.1.1. 下载比对服务(comparison)

从官网下载最新的统一sql比对服务包：下载使用-LightDB中间件-多发比对-比对服务下载
比对服务的jar包(可独立启动) comparison-xx.xx.xx.jar，在比对服务包中路径为：LightDB1.0-comparison-Vxxxxxx-xx-xxx/comparison-xx.xx.xx.jar。
解压到目标服务器的自定义目录下

10.4.1.2. 执行比对服务数据库初始化

1.安装LightDB数据库(版本号需<=23.4) LightDB数据库下载

首先获取<=LightDB 23.4 版本的安装包，解压后，参考 LightDB安装手册，在机器上安装一个单机版实例。

为了便于操作，安装程序会在 ~/.bashrc 中写入LightDB相关的环境变量，可以重新登录一下shell，或者执行 source ~/.bashrc 使得环境变量生效。

我们演示环境把数据库实例安装在 /data/lightdb 目录下，您在具体操作时可以安装到其他目录下，只要lightdb用户有对应目录的权限即可。

安装完成后，可以查看 LTHOME 和 LTDATA 环境变量确定实际安装目录和实例目录:
```
[lightdb@0b3770c2d30a ~]$ echo $LTHOME
/data/lightdb/lightdb-x/13.8-22.4
[lightdb@0b3770c2d30a ~]$ echo $LTDATA
/data/lightdb/lightdb-x/13.8-22.4/data/defaultCluster/
```

2.数据库初始化

在LightDB安装服务器上执行 comparison_init.sh 脚本即可完成比对服务数据库的初始化，数据库IP可通过-h选项指定，数据库端口可通过-p选项指定。

[lightdb@hadoop2 multiplex]$ unzip LightDB1.0-comparison-V202501-00-000.zip
[lightdb@hadoop2 multiplex]$ cd LightDB1.0-comparison-V202501-00-000/scripts/
[lightdb@hadoop2 scripts]$ chmod +x *.sh
[lightdb@hadoop2 scripts]$ ./comparison_init.sh -h 10.20.47.203 -p 5432

10.4.1.3. 消息队列安装(可选)

10.4.1.3.1. 下载消息队列(Pulsar)

从官网下载 apache-pulsar-2.10.5-bin.tar.gz

10.4.1.3.2. 启动消息队列(Pulsar)

上传apache-pulsar-2.10.5-bin.tar.gz包到指定linux服务器进行解压安装，服务器需要预先安装1.8或以上版本JDK环境:

[lightdb@hs-10-20-30-217 ~]$tar -xzvf apache-pulsar-2.10.5-bin.tar.gz -C /usr/local/
[lightdb@hs-10-20-30-217 ~]$cd /usr/local/
[lightdb@hs-10-20-30-217 ~]$mv apache-pulsar-2.10.5/ pulsar

[lightdb@hs-10-20-30-217 ~]$vi /root/.bashrc
  export PULSAR_HOME=/usr/local/pulsar
  export PATH=$PATH:$PULSAR_HOME/bin
[lightdb@hs-10-20-30-217 ~]$source /root/.bashrc
#后台服务运行
[lightdb@hs-10-20-30-217 ~]$pulsar-daemon start standalone

10.4.1.4. 多发消息通过http方式推送到比对服务

多发消息通过http方式推送到比对服务时 不需要安装消息队列 。如需使用该模式参考多发配置项 multi.send.change.data.http.url 多发配置管理

10.4.1.5. 修改比对服务配置文件(comparison)

修改微服务配置文件 LightDB1.0-comparison-Vxxxxxx-xx-xxx/config/jrescloud.properties

app.web.domain=${IP}                   //换成应用所在机器ip
app.web.home=http://${IP}:17333/em     //换成应用所在机器ip

dyn.spring.datasources[0].url=jdbc:postgresql://${IP}:${PORT}/comparison     //换成实际的lightdb数据库ip、端口
dyn.spring.datasources[0].username=${USERNAME}                       //换成实际的lightdb数据库用户名
dyn.spring.datasources[0].password=${PASSWORD}                       //换成实际的lightdb数据库密码

jrescloud.properties中除以上罗列的参数外，其余参数按照默认配置

修改统一sql配置文件 LightDB1.0-comparison-Vxxxxxx-xx-xxx/config/jrescloud.properties

multi.pulsarServiceUrl=pulsar://${IP}:${PORT}            //Pulsar服务端地址，样例数据：pulsar://10.20.47.203:6650
multi.topicName=persistent://public/default/${TOPIC}     //Pulsar的持久化主题，主题格式：persistent://<tenant>/<namespace>/<topic>，样例数据为：persistent://public/default/recordMonitorJingji
multi.subscriptionName=${SUBSCRIPTION}                   //在Pulsar中，订阅（Subscription）是用于消费主题消息的标识符。订阅名称是用来标识不同消费者或消费组在订阅相同主题时的唯一标识。合法字符串即可，比如jingjiTest
multi.dingding.accessToken=                              //钉钉机器人Webhook的accessToken
multi.dingding.secret=                                   //钉钉机器人消息的secret,安全设置选择加签时产生
multi.dingding.url=                                      //在消息中增加比对服务页面url方便跳转

10.4.1.6. 启动比对服务(comparison)

执行启动脚本 comparison_start.sh 启动比对服务
查看比对服务启动成功标志，日志文件comparison.log中包含关键字 server started

# 进入解压目录 LightDB1.0-comparison-Vxxxxxx-xx-xxx
[lightdb@hs-10-20-30-217 comparison]$ pwd
/home/lightdb/LightDB1.0-comparison-Vxxxxxx-xx-xxx
[lightdb@hs-10-20-30-217 comparison]$ sh comparison_start.sh  --help
修改多发配置文件jrescloud.properties中Pulsar消费者配置multi.pulsarServiceUrl(Pulsar服务端地址), multi.topicName(Pulsar的持久化主题), multi.subscriptionName(在Pulsar中客户端消费者订阅名称),multi.run.what(是否执行多发的总开关)
使用: sh comparison_start.sh 启动比对服务
[lightdb@hs-10-20-30-217 comparison]$ sh comparison_start.sh

10.4.2. 一键部署方式（推荐）

比对服务安装除了支持手动安装方式以外，还支持一键部署方式的方式进行安装。该安装模式的最大优点是，安装模式简单，初次使用的客户也可快速完成安装。下面介绍一键部署的操作步骤：

！！！以下操作，比对服务安装需要在lightdb用户下进行操作

从官网下载最新的比对服务安装包、lightdb-x数据库免安装版安装包：比对服务下载、 lightdb-x数据库免安装版lightdb-x-13.8-23.4-18236-el7.x86_64-noinstall.zip 。
解压 LightDB1.0-comparison-Vxxxx-xx-xxx.zip，切换到scripts目录：执行./install.sh命令

需要输入比对服务器地址、比对服务web端口号，如下
直至出现下面的提醒，LightDB数据库初始化完成，
下面提示输入钉钉秘钥消息，如不需要配置，选择n，跳过即可。
最后一步，启动比对服务成功，如下面所示

3.验证比对服务是否已经正常启动，可以登录比对服务页面http://10.20.30.193:17336/em/login.html