dm8dmhs安装

dmhs源端安装
dmhs和操作系统版本，数据库版本都有关系，需选择对应的版本进行安装。源端操作系统、目标端操作系统都要安装上dmhs。建议采用dmdba用户安装，无需新建用户，否则还得给新用户授一堆权限。
1.1.软件安装
[dmdba@lf07ffdbqpvb-M3/home/dmdba]$./dmhs_V4.3.06_dm8_rev124224_rh6_64_veri_20230214_sp2.bin -i
Extract install files..........

1.English(English)
2.Simplified Chinese(简体中文)
Select the language to install[2.Simplified Chinese(简体中文)]:2
/tmp/DMHSInstall/install.log
1.免费试用达梦数据实时同步
2.使用已申请的Key文件
验证许可证文件[1.免费试用达梦数据实时同步]:1
1.精简版
2.完整版(web客户端)
3.自定义
安装类型[1.精简版]:1
1.实时同步软件服务器
2.远程部署工具
3.实时同步软件配置助手
4.手册
所需磁盘空间:536 MB
安装目录: [/home/oracle/dmhs]/home/dmdba/dmhs
1.统一部署
2.现在初始化
是否初始化达梦数据实时同步系统[1.统一部署]:1
正在安装
default start ... default finished.
server start ... server finished.
hs_agent start ... hs_agent finished.
hsca start ... hsca finished.
doc start ... doc finished.
postinstall start ... postinstall finished.
正在创建快捷方式
安装成功
远程部署工具配置
远程部署工具名称[HsAgent]:
主机Ip(外网)xx.xxx.xxx.xxx:
远程部署工具管理端口5456:
内置数据库轮询间隔3:
内置数据库IP[]:
输入有误，请重新输入!
内置数据库IP[]:xx.xxx.xxx.xxx
内置数据库端口15236:
内置数据库用户名[SYSDBA]:
内置数据库密码[SYSDBA]:
服务脚本环境变量设置
依赖库路径
提示：此配置项供用户配置源或目的数据库依赖库路径和odbc依赖库路径, 多个路径以":"隔开(例:/opt/dmdbms/bin:/usr/local/lib),此配置项会添加到服务脚本的NEED_LIB_PATH的变量值中。
请配置依赖库路径:
Oracle字符集
提示：注意此处配置为ORACLE数据库的NLS_LANG，此配置项由源端数据库字符集编码格式决定，需与源端字符集编码适配。
1.SIMPLIFIED CHINESE_CHINA.ZHS32GB18030
2.SIMPLIFIED CHINESE_CHINA.AL32UTF8
3.TRADITIONAL CHINESE_TAIWAN.ZHT16BIG5
4.TRADITIONAL CHINESE_TAIWAN.AL32UTF8
5.AMERICAN_AMERICA.AL32UTF8
6.AMERICAN_AMERICA.WE8ISO8859P1
7.AMERICAN_AMERICA.WE8ISO8859P15
8.AMERICAN_AMERICA.ZHS16GBK
9.不设置
请配置Oracle字符集[9.不设置]:
远程控制服务
1.自动
2.手动
启动方式:[2.手动]
正在创建远程控制服务
达梦数据实时同步V4.0安装完成
更多安装信息，请查看安装日志文件:
/home/dmdba/dmhs/log/install.log
2. 源端配置
2.1. 源端数据库配置
2.1.1. 开启逻辑附加日志
DM8源端需要开启附加日志参数"RLOG_APPEND_LOGIC"以支持数据实时同步，使用如下语句查询DM8数据库中该参数是否启用：

SQL> SELECT PARA_VALUE FROM V$DM_INI WHERE PARA_NAME='RLOG_APPEND_LOGIC';
行号 PARA_VALUE

1 2
已用时间: 12.834(毫秒). 执行号:10000.
PARA_VALUE结果大于0，则说明该功能已开启。如果取值为0，需要启用该参数功能。调用系统过程开启该参数或者手动更改dm.ini配置文件中的‘RLOG_APPEND_LOGIC’参数值。目前该参数支持动态修改，具体可参考管理员手册说明。
SQL> call sp_set_para_value(1, 'RLOG_APPEND_LOGIC', 2);
PL/SQL executed successfully
used time: 6.362(ms). Execute id is 127.
以上sp_set_para_value调用表示修改dm.ini文件中的’RLOG_APPEND_LOGIC’参数值为1。该系统过程的定义可参见《DM8_SQL语言使用手册》。
注意：
(1) 该参数取值说明如下：
取值为1：如果有主键列，记录UPDATE和DELETE操作时只包含主键列信息；若没有主键列则包含所有列信息；
取值为2：不论是否有主键列，记录UPDATE和DELETE操作时都包含所有列的信息；
取值为3：：记录UPDATE时包含更新列的信息以及ROWID，记录DELETE时只有ROWID。
在Kafka执行端，对于主键表，如果在更新和删除时需要显示全列信息，则需要设置该值为2，保证源端日志中记录有全列信息，否则无法显示全列。
（2）启用该参数后，源端DM8的归档日志量比不启用该参数会有所增加，需要知悉。

2.1.2. 开启数据库归档
DMHS同步源端数据库需要开启归档模式，使用如下语句检查DM8归档是否开启：
SQL> select arch_mode from v$database;

LINEID ARCH_MODE

1 Y
used time: 3.236(ms). Execute id is 123.
如果ARCH_MODE字段查询结果为“N”，则DM8数据库归档未开启，使用如下系列命令开启归档模式。开启归档模式，需要确定归档类型、归档路径、归档文件大小、归档空间大小限制参数，根据实际情况进行设置。具体可参阅《DM8系统管理员手册》。
SQL> alter database mount;
executed successfully
used time: 00:00:01.144. Execute id is 0.
SQL> alter database add archivelog 'DEST=/dmdb/dmdata/arch,TYPE=LOCAL,FILE_SIZE=512,SPACE_LIMIT=20480';
executed successfully
used time: 7.437(ms). Execute id is 0.
SQL> alter database archivelog;
executed successfully
used time: 10.277(ms). Execute id is 0.
SQL> alter database open;
executed successfully
used time: 00:00:01.262. Execute id is 0.
注意：
在数据库运行过程中，若需要开启归档模式，需要与DBA进行沟通。
2.1.3. DDL同步配置
DMHS支持DDL同步功能，但是默认不启用该功能。对于同步源端为DM8数据库，有两种方式启用DDL同步功能：
（1）无触发器方式：启用DM8数据库系统参数“RLOG_APPPEND_SYSTAB_LOGIC”，该参数启用在日志中记录系统表逻辑操作功能。该参数默认取值为0，即不启用；设置为1时，启用该功能。
（2）触发器方式：在源端DM8数据库中以SYSDBA用户执行DDL同步脚本，在SYSDBA模式下创建相关DMHS系统表及触发器。
同步脚本位于DMHS安装目录的scripts子目录下，命名为：ddl_sql_dm8.sql
--进入数据库执行以下脚本，如遇到需要输入值，可直接回车继续：
start /home/dmdba/dmhs/scripts/ddl_sql_dm8.sql
2.2. 创建DMHS用户并赋权
创建用户DMHS作为连接用户，授权若不能以dba角色授予以下权限：
dm- dm dmhs用户需要权限：
grant PUBLIC to dmhs;
grant select on SYS.V$rlog to dmhs;
grant select on SYS.V$DM_INI to dmhs;
grant select on SYS.V$RLOGFILE to dmhs;
grant select on SYS.V$DM_ARCH_INI to dmhs;
grant select on SYS.V$VERSION to dmhs;
grant select on SYS.V$ARCH_FILE to dmhs;

--待装载的表或序列的查询权限：
select 'grant select on '||owner||'.'||table_name||' to "DMHS"' from dba_tables where owner='SYSDBA';
本文档使用SYSDBA做的功能验证，若没有管理员权限则使用以上权限
2.3. 源端环境变量
查看源端是否已配置以下环境变量（本次dmhs安装包会自动添加如下两条环境变量）：
$ vim ~/.profile （aix）
$ vim ~/.bash_profile (linux)
export DMHS_HOME=/home/dmdba/dmhs
export LD_LIBRARY_PATH=LD_LIBRARY_PATH:/home/dmdba/dmhs/bin

注意：AIX下用LIBPATH，HP及Linux下用LD_LIBRARY_PATH。
使profile生效，
AIX下：. ~/.profile
Linux下：source ~/.bash_profile
2.4. dci文件导入
将libdmoci.so放置$DM_HOME/bin下
Tips：dmhs软件安装需要安装源端和目的端，确认好同步系统环境版本；准备好与DM数据库版本号匹配的libdmoci.so（原厂提供）并放入$DM_HOME/bin
2.5. 检查dmhs是否缺so包
若dci文件已放入$DM_HOME/bin下，则以下检测不会出现缺包现象，否则会显示libdmoci.so缺包
cd $DMHS_HOME/bin
ldd ./libdmhs_ld_dm8.so
3. dmhs目标端安装
dmhs和操作系统版本，数据库版本都有关系，需选择对应的版本进行安装。源端操作系统、目标端操作系统都要安装上dmhs。建议采用dmdba用户安装，无需新建用户，否则还得给新用户授一堆权限。

3.1.软件安装
[dmdba@lf07ffdbqpvb-M3/home/dmdba]$./dmhs_V4.3.06_dm8_rev124224_rh6_64_veri_20230214_sp2.bin -i
Extract install files..........

1.English(English)
2.Simplified Chinese(简体中文)
Select the language to install[2.Simplified Chinese(简体中文)]:2
/tmp/DMHSInstall/install.log
1.免费试用达梦数据实时同步
2.使用已申请的Key文件
验证许可证文件[1.免费试用达梦数据实时同步]:1
1.精简版
2.完整版(web客户端)
3.自定义
安装类型[1.精简版]:1
1.实时同步软件服务器
2.远程部署工具
3.实时同步软件配置助手
4.手册
所需磁盘空间:536 MB
安装目录: [/home/oracle/dmhs]/home/dmdba/dmhs
1.统一部署
2.现在初始化
是否初始化达梦数据实时同步系统[1.统一部署]:1
正在安装
default start ... default finished.
server start ... server finished.
hs_agent start ... hs_agent finished.
hsca start ... hsca finished.
doc start ... doc finished.
postinstall start ... postinstall finished.
正在创建快捷方式
安装成功
远程部署工具配置
远程部署工具名称[HsAgent]:
主机Ip(外网)xx.xxx.xxx.xxx:
远程部署工具管理端口5456:
内置数据库轮询间隔3:
内置数据库IP[]:
输入有误，请重新输入!
内置数据库IP[]:xx.xxx.xxx.xxx
内置数据库端口15236:
内置数据库用户名[SYSDBA]:
内置数据库密码[SYSDBA]:
服务脚本环境变量设置
依赖库路径
提示：此配置项供用户配置源或目的数据库依赖库路径和odbc依赖库路径, 多个路径以":"隔开(例:/opt/dmdbms/bin:/usr/local/lib),此配置项会添加到服务脚本的NEED_LIB_PATH的变量值中。
4. 目标端配置
4.1. 源端环境变量
查看源端是否已配置以下环境变量（本次dmhs安装包会自动添加如下两条环境变量）：
$ vim ~/.profile （aix）
$ vim ~/.bash_profile (linux)
export DMHS_HOME=/home/dmdba/dmhs
export LD_LIBRARY_PATH=LD_LIBRARY_PATH:/home/dmdba/dmhs/bin

注意：AIX下用LIBPATH，HP及Linux下用LD_LIBRARY_PATH。
使profile生效，
AIX下：. ~/.profile
Linux下：source ~/.bash_profile
4.2. dci文件导入
将libdmoci.so放置$DM_HOME/bin下
Tips：dmhs软件安装需要安装源端和目的端，确认好同步系统环境版本；准备好与DM数据库版本号匹配的libdmoci.so（原厂提供）并放入$DM_HOME/bin
4.3. 检查dmhs是否缺so包
若dci文件已放入$DM_HOME/bin下，则以下检测不会出现缺包现象，否则会显示libdmoci.so缺包
cd $DMHS_HOME/bin
ldd ./libdmhs_ld_dm8.so

配置文件准备
5.1. dm源端
在$DMHS_HOME/bin下添加dmhs.hs文件：
5.1.1. dmhs.hs
<?xml version="1.0" encoding="GB2312" standalone="no"?>
<dmhs>
<base>
<lang>en</lang>
<mgr_port>5345</mgr_port>
<ckpt_interval>60</ckpt_interval>
<siteid>1</siteid>

</base>
<cpt>
<enable>1</enable>
<name>yuanduan</name>
<db_type>DM8</db_type>
<db_server>xx.xxx.xxx.xxx</db_server>
<db_user>SYSDBA</db_user>
<db_pwd>SYSDBA</db_pwd>
<db_port>15236</db_port>
<idle_time>300</idle_time>
<ddl_mask>TABLE:INDEX:VIEW:CHECK:OP:REC</ddl_mask>
<parse_thr>1</parse_thr>
<send_lst>2</send_lst>
<rec_heap_size>16</rec_heap_size>
<vpool_size>8</vpool_size>
<supplement_log>0</supplement_log>
<enable_mview>0</enable_mview>
<check_date>0</check_date>
<nvarchar>8</nvarchar>
<trx_delay_second>10</trx_delay_second>
<send_delay_second>20</send_delay_second>
<arch>
<clear_flag>0</clear_flag>
<clear_interval>60</clear_interval>
</arch>
<send>
<ip>xx.xxx.xxx.xxx</ip>
<mgr_port>5345</mgr_port>
<data_port>5346</data_port>
<trigger>0</trigger>
<filter>
<enable>
<item>SYSDBA.</item>
</enable>
</filter>
<map>
<item>SYSDBA. == TEST_DMHS.*</item>
</map>
</send>
</cpt>
</dmhs>
注：同步用户需根据实际修改；
5.2. dm目标端
在$DMHS_HOME/bin下添加dmhs.hs文件：
5.2.1. dmhs.hs
<?xml version="1.0" encoding="GB2312" standalone="no"?>
<dmhs>
<base>
<lang>en</lang>
<version>2.0</version>
<mgr_port>5345</mgr_port>
<chk_interval>3</chk_interval>
<ckpt_interval>60</ckpt_interval>
<siteid>2</siteid>
</base>
<exec>
<recv>
<mgr_port>5345</mgr_port>
<data_port>5346</data_port>
</recv>
<db_type>dm8</db_type>
<db_server>127.0.0.1</db_server>
<db_user>test_dmhs</db_user>
<db_pwd>test_dmhs</db_pwd>
<db_port>15236</db_port>
<level>0</level>
<exec_mode>0</exec_mode>
<exec_thr>16</exec_thr>
<exec_sql>1024</exec_sql>
<exec_trx>5000</exec_trx>
<exec_rows>250</exec_rows>
<enable_rowid>0</enable_rowid>
</exec>
</dmhs>
配置服务启动
6.1. 配置dmhs服务
源端：
1)cd $DMHS_HOME/bin/service_template

cp –r DmhsService ../
mv DmhsService DmhsServicesNPS
vi DmhsServiceNPS
#REPLACE DMHS_HOME path
DMHS_HOME=/home/dmdba/dmhs --DMHS_HOME
#REPLACE program dir
PROG_DIR=/home/dmdba/dmhs/bin --DMHS_HOME执行bin目录
#REPLACE program config path
CONF_PATH=/home/dmdba/dmhs/bin/dmhs.hs --配置文件dmhs.hs 绝对路径
目标端：
1)cd $DMHS_HOME/bin/service_template
cp –r DmhsService ../
vi DmhsService
#REPLACE DMHS_HOME path
DMHS_HOME=/home/dmdba/dmhs --DMHS_HOME
#REPLACE program dir
PROG_DIR=/home/dmdba/dmhs/bin --DMHS_HOME执行bin目录
#REPLACE program config path
CONF_PATH=/home/dmdba/dmhs/bin/dmhs.hs --配置文件dmhs.hs 绝对路径
6.2. 启动目标端
目的端服务启动：
cd /home/dmdba/dmhs/bin
/DmhsService start
执行启动命令：
cd /home/dmdba/dmhs/bin
./dmhs_console
DMHS>connnect xx.xxx.xxx.xxx:5345 ###本机ip及mgr端口
DMHS>start exec

connect连接的是目的端DMHS服务的地址以及目的端DMHS配置文件中的管理端口号（BASE中的MGR_PORT）。
start exec后会在$DMHS_HOME/bin目录下生成dmhs_exe.tmp文件。下次启动dmhs服务会根据该文件判断是否需要启动执行器，如果存在该文件，则直接启动dmhs执行器；如果该文件不存在，则需要执行start exec命令启动执行器。
6.3. 启动源端
源端服务启动：
cd /home/dmdba/dmhs/bin
./DmhsService start
执行启动命令：
cd /home/dmdba/dmhs/bin
./dmhs_console
DMHS>connnect xx.xxx.xxx.xxx:5345
DMHS>clear exec lsn
DMHS>copy 0 "SCH.NAME='SYSDBA'" DICT|CREATE|INSERT|DROP|THREAD|8
DMHS>start cpt

start cpt后会在dmhs/bin目录下生成dmhs_cpt.tmp文件。下次启动dmhs服务会根据该文件判断是否需要启动捕获服务，如果存在该文件，则直接启动dmhs捕获器；如果该文件不存在，则需要执行start cpt命令启动捕获器。
装载字典或者装载数据只能在cpt停止的时候进行，因此，hs同步过程中如果需要进行字典或者数据的装载，要先执行stop cpt后再进行copy装载。
6.4. 查看dmhs节点拓扑关系

查看dmhs拓扑关系（源端和目标端均可）：
cd $DMHS_HOME/bin
./dmhs_console
DMHS>all_link
6.5. 查看目标端dmhs日志
cd /home/dmdba/dmhs/bin/log
tail -200f dmhs_202304.log

作者