达梦数据复制软件DMDRS数据分发搭建部署示例：DM8到DSS到DM8/DM8（同时一对多分发）

说明
运行DMDRS前，请确保源DMDRS与目标DMDRS服务器上已安装正确版本的数据库驱动。

1 场景规划

业务规划

数据分发场景中已部署三个数据库，包括源数据库DM8（192.168.20.24）、目标数据库A DM8（192.168.20.21）和目标数据库B DM8（192.168.20.22），该场景中同时搭建部署源数据库到目标数据库A和B的同步，将源数据库RESOURCES和PERSON模式下所有表的全量数据和增量数据同时分发复制到目标数据库A和B。

数据分发（DM8DSSDM8）.png

源DMDRS：捕获源数据库的数据，将捕获到的数据发送到DMDSS。
DMDSS：缓存数据流并向目标DMDRS A和目标DMDRS B分发数据。
目标DMDRS A：将接收的数据复制到目标数据库A。
目标DMDRS B：将接收的数据复制到目标数据库B。

网络规划

DMDRS服务	IP地址和端口	连接数据库	说明
源DMDRS	192.168.20.24:5345	源数据库 DM8 192.168.20.24:5236	源DMDRS服务器需要安装DMDPI驱动与源数据库DM8连接。
DMDSS	192.168.20.23:5345	/	/
目标DMDRS A	192.168.20.21:5345	目标数据库A DM8 192.168.20.21:5236	目标DMDRS A服务器需要安装DMDPI驱动与目标数据库A DM8连接。
目标DMDRS B	192.168.20.22:5345	目标数据库B DM8 192.168.20.22:5236	目标DMDRS B服务器需要安装DMDPI驱动与目标数据库B DM8连接。

目录规划

源数据库、源DMDRS服务、DMDSS服务、目标DMDRS A服务和目标DMDRS B服务相关的目录规划如下表所示。

目录类型	目录名	目录示例
源数据库	数据库归档文件目录	/dm8/data/arch
源数据库	数据库DDL同步脚本目录	/home/dmdrs/dmdrs5/bin/scripts
源DMDRS	安装目录	/home/dmdrs/dmdrs5
	执行程序目录	/home/dmdrs/dmdrs5/bin
	配置文件路径	/home/dmdrs/dmdrs5/bin/cpt.xml
	服务脚本模板目录	/home/dmdrs/dmdrs5/bin/service_template
	服务脚本目录	/home/dmdrs/dmdrs5/bin
	console远程控制工具	/home/dmdrs/dmdrs5/bin
DMDSS	安装目录	/home/dmdrs/dmdrs5
	执行程序目录	/home/dmdrs/dmdrs5/bin
	配置文件路径	/home/dmdrs/dmdrs5/bin/dss.xml
	服务脚本模板目录	/home/dmdrs/dmdrs5/bin/service_template
	服务脚本目录	/home/dmdrs/dmdrs5/bin
	日志流的存储路径	/home/dmdrs/dmdrs5/bin/logfile
目标DMDRS A	安装目录	/home/dmdrs/dmdrs5
	执行程序目录	/home/dmdrs/dmdrs5/bin
	配置文件路径	/home/dmdrs/dmdrs5/bin/exec.xml
	服务脚本模板目录	/home/dmdrs/dmdrs5/bin/service_template
	服务脚本目录	/home/dmdrs/dmdrs5/bin
	console远程控制工具	/home/dmdrs/dmdrs5/bin/drcsl
目标DMDRS B	安装目录	/home/dmdrs/dmdrs5
	执行程序目录	/home/dmdrs/dmdrs5/bin
	配置文件路径	/home/dmdrs/dmdrs5/bin/exec.xml
	服务脚本模板目录	/home/dmdrs/dmdrs5/bin/service_template
	服务脚本目录	/home/dmdrs/dmdrs5/bin
	console远程控制工具	/home/dmdrs/dmdrs5/bin/drcsl

2 设置DMDRS运行用户

设置源DMDRS服务的运行用户对服务所在目录及子目录的读、写和执行权限，并设置运行用户同数据库归档文件所在目录属同一用户组，此用户组应对归档文件所在目录及子目录有读权限。
设置DMDSS、目标DMDRS A和目标DMDRS B服务的运行用户对各自服务所在目录及子目录的读、写和执行权限。

3 设置环境变量

在源DMDRS、目标DMDRS A和目标DMDRS B服务器的环境变量中添加DMDPI驱动文件路径。

打开.bash_profile配置文件。
```
$ vi ~/.bash_profile
```

在.bash_profile配置文件末尾增加DMDPI驱动路径。

export LD_LIBRARY_PATH=<DMDPI驱动路径>:$LD_LIBRARY_PATH

保存并退出vi编辑器，使环境变量生效。
```
$ source ~/.bash_profile
```
查看环境变量是否设置成功。
```
$ echo $LD_LIBRARY_PATH
```

4 开启源数据库的归档和逻辑日志

使用动态配置的方式开启源数据库的归档和逻辑日志。

挂载源数据库。
```
SQL> alter database mount;
```

源数据库添加归档日志配置项。

SQL> alter database add archivelog 'DEST=/dm8/data/arch,TYPE=LOCAL,FILE_SIZE=512,SPACE_LIMIT=10240';

源数据库应用配置项修改。
```
SQL> alter database archivelog;
```
开启源数据库。
```
SQL> alter database open;
```

配置源数据库逻辑日志。

SQL> call sp_set_para_value(1,'RLOG_APPEND_LOGIC',1);

5 配置DDL同步

使用触发器方式配置DDL同步。

注意

创建DDL触发器和辅助表时，请使用具有DBA权限的用户。

如果触发器或辅助表无效或缺失，会导致DDL同步失败，甚至会影响数据库。

在源数据库执行“ddl_sql_dm8.sql”脚本创建触发器和辅助表，脚本默认位置在DMDRS执行程序目录下的scripts子目录中。

SQL> set define off;
SQL> start ddl_sql_dm8.sql

6 启动源库到目标库A和B的装载和同步

按照DMDRS服务运行的先后顺序，依次启动DMDSS服务、源DMDRS服务、目标DMDRS A服务和目标DMDRS B服务。

说明
以下DMDRS服务的配置文件仅为示例，在实际应用场景中，请根据实际搭建环境修改配置文件中的参数配置，具体的参数说明和其他功能参数配置请参见《DMDRS参考手册》。

6.1 配置和启动DMDSS服务

在DMDSS服务的配置文件目录，打开并修改dss.xml配置文件，修改后配置文件如下所示。

注意
配置文件中的siteid为必配参数，配置时请确保源DMDRS、DMDSS和目标DMDRS服务站点号的唯一性，如果重复，会造成链路中数据复制的混乱。

<?xml version="1.0" encoding="GB18030"?>
<drs>
    <base>
        <mgr_port>5345</mgr_port>
        <siteid>站点号</siteid>
    </base>
    <dss>
        <name>dss_dm8</name>
        <dir>/home/dmdrs/dmdrs5/bin/logfile</dir>
    </dss>
</drs>

将服务脚本模板TemplateService拷贝到服务脚本目录并修改服务脚本的名称为DssService。
```
$ cp TemplateService ../DssService
```

打开并修改DssService服务脚本中的相关配置参数。

$ vi DssService

INSTALL_HOME=/home/dmdrs/dmdrs5
PROG_DIR=/home/dmdrs/dmdrs5/bin
CONF_PATH=/home/dmdrs/dmdrs5/bin/dss.xml
EXEC_PROG_NAME=dssvr
SERVICE_TYPE_NAME="dss server"

启动DMDSS服务。
```
$ ./DssService start
```

6.2 配置和启动源DMDRS服务

在源DMDRS服务的配置文件目录，打开并修改cpt.xml配置文件，修改后配置文件如下所示。

注意
配置文件中的siteid为必配参数，配置时请确保源DMDRS、DMDSS和目标DMDRS服务站点号的唯一性，如果重复，会造成链路中数据复制的混乱。

<?xml version="1.0" encoding="GB18030"?>
<drs>
    <base>
        <mgr_port>5345</mgr_port>
        <siteid>站点号</siteid>
    </base>
    <cpt>
        <name>cpt_dm8</name>
        <login>
            <dbtype>dm8</dbtype>
            <server>192.168.20.24</server>
            <user>DMDRS</user>
            <pwd>DMDRS</pwd>
            <port>5236</port>
        </login>
        <send>
            <ip>192.168.20.23</ip>
            <port>5345</port>
            <target_name>dss_dm8</target_name>
            <map>
                <item>RESOURCES.*==RESOURCES.*</item>
                <item>PERSON.*==PERSON.*</item>
            </map>
        </send>
    </cpt>
</drs>

将服务脚本模板TemplateService拷贝到服务脚本目录并修改服务脚本的名称为DrsService。
```
$ cp TemplateService ../DrsService
```

打开并修改DrsService服务脚本中的相关配置参数。

$ vi DrsService

INSTALL_HOME=/home/dmdrs/dmdrs5
PROG_DIR=/home/dmdrs/dmdrs5/bin
CONF_PATH=/home/dmdrs/dmdrs5/bin/cpt.xml
EXEC_PROG_NAME=drsvr
SERVICE_TYPE_NAME="drs server"

启动源DMDRS服务。
```
$ ./DrsService start
```
启动控制台。
```
$ ./drcsl cpt.xml
```
连接源DMDRS服务。
```
 CSL> connect
```
设置数据库当前最新的日志LSN作为日志解析的起始位置。如需指定归档文件作为起始位置，请参考《DMDRS控制台命令手册》进行设置。
```
CSL> alter cpt_dm8 set lsn
```
启动源DMDRS服务中的CPT模块。
```
CSL> start
```

6.3 配置和启动目标DMDRS A服务

在目标DMDRS A服务的配置文件目录，打开并修改exec.xml配置文件，修改后配置文件如下所示。

注意
配置文件中的siteid为必配参数，配置时请确保源DMDRS、DMDSS和目标DMDRS服务站点号的唯一性，如果重复，会造成链路中数据复制的混乱。

<?xml version="1.0" encoding="GB18030"?>
<drs>
    <base>
        <mgr_port>5345</mgr_port>
        <siteid>站点号</siteid>
    </base>
    <exec>
        <name>exec_dm8</name>
        <dss>
            <item>
                <name>dss_dm8</name>
                <ip>192.168.20.23</ip>
                <port>5345</port>
                <topic>cpt_dm8</topic>
                <map>
                    <item>RESOURCES.*==RESOURCES.*</item>
                    <item>PERSON.*==PERSON.*</item>
                </map>
            </item>
        </dss>
        <login>
            <dbtype>dm8</dbtype>
            <server>192.168.20.21</server>
            <user>DMDRS</user>
            <pwd>DMDRS</pwd>
            <port>5236</port>    
        </login>
        <group>
            <item>
                <id>35</id>
                <exec_policy>0</exec_policy>                    
                <desc>
                    <table>*.*</table>
                </desc>
            </item>
        </group>
    </exec>
</drs>

将服务脚本模板TemplateService拷贝到服务脚本目录并修改服务脚本的名称为DrsService。
```
$ cp TemplateService ../DrsService
```

打开并修改DrsService服务脚本中的相关配置参数。

$ vi DrsService

INSTALL_HOME=/home/dmdrs/dmdrs5
PROG_DIR=/home/dmdrs/dmdrs5/bin
CONF_PATH=/home/dmdrs/dmdrs5/bin/exec.xml
EXEC_PROG_NAME=drsvr
SERVICE_TYPE_NAME="drs server"

启动目标DMDRS A服务。
```
$ ./DrsService start
```

6.4 配置和启动目标DMDRS B服务

在目标DMDRS B服务的配置文件目录，打开并修改exec.xml配置文件，修改后配置文件如下所示。

注意
配置文件中的siteid为必配参数，配置时请确保源DMDRS、DMDSS和目标DMDRS服务站点号的唯一性，如果重复，会造成链路中数据复制的混乱。

<?xml version="1.0" encoding="GB18030"?>
<drs>
    <base>
        <mgr_port>5345</mgr_port>
        <siteid>站点号</siteid>
    </base>
    <exec>
        <name>exec_dm8</name>
        <dss>
            <item>
                <name>dss_dm8</name>
                <ip>192.168.20.23</ip>
                <port>5345</port>
                <topic>cpt_dm8</topic>
                <map>
                    <item>RESOURCES.*==RESOURCES.*</item>
                    <item>PERSON.*==PERSON.*</item>
                </map>
            </item>
        </dss>
        <login>
            <dbtype>dm8</dbtype>
            <server>192.168.20.22</server>
            <user>DMDRS</user>
            <pwd>DMDRS</pwd>
            <port>5236</port>    
        </login>
        <group>
            <item>
                <id>35</id>
                <exec_policy>0</exec_policy>                    
                <desc>
                    <table>*.*</table>
                </desc>
            </item>
        </group>
    </exec>
</drs>

将服务脚本模板TemplateService拷贝到服务脚本目录并修改服务脚本的名称为DrsService。
```
$ cp TemplateService ../DrsService
```

打开并修改DrsService服务脚本中的相关配置参数。

$ vi DrsService

INSTALL_HOME=/home/dmdrs/dmdrs5
PROG_DIR=/home/dmdrs/dmdrs5/bin
CONF_PATH=/home/dmdrs/dmdrs5/bin/exec.xml
EXEC_PROG_NAME=drsvr
SERVICE_TYPE_NAME="drs server"

启动目标DMDRS B服务。
```
$ ./DrsService start
```

6.5 添加目标库A和B的同步表

将源数据库中RESOURCES模式和PERSON模式下所有的表添加同步，添加后将源数据库的全量数据装载到目标数据库A和B，并将增量数据同步到目标数据库A和B。

根据不同需求可以使用不同的数据装载掩码，掩码说明具体请参见《DMDRS控制台命令手册》的添加同步表章节。

CSL> alter cpt_dm8 add table "sch.name='RESOURCES' or sch.name='PERSON'"

7 验证同步结果

在源数据库中RESOURCES模式和PERSON模式下所有的表中分别插入数据，如果插入的数据能正确地同步到目标数据库A和目标数据库B，则表示数据同步成功。