DEE数据交换中间件
安装维护手册
产品研发中心
2024/7/19
# 目 录 {#目-录 ._Style-3}
# 前言
欢迎您使用致远软件DEE数据交换中间件
目前致远软件Dee数据交换中间件已经达成了可独立部署运行,实现零代码构建多个同构、异构系统之间的数据交互。为用户构建系统之间的通信提供了简单、方便的操作模式。
Dee数据交换中间件操作简单,特附帮助文档和应用实例,用户可快速掌握;采用独立的安装程序,帮助用户实现轻松安装。
本手册是针对Dee数据交换中间件的快速安装手册,供系统管理人员或维护人员使用,期望它能给您的工作带来更高的效率和更高的品质。有任何问题或好的建议,也欢迎您及时提出,谢谢!
# 安装篇
本章节介绍Dee数据交换中间件运行的环境要求,版本匹配及如何安装并启动Dee数据交换中间件。
配置要求
版本匹配
本版本数据交换中间件(V4.5)仅适配A8+ V9.0版本的连接和DEE V4.5可视化配置工具制作的任务。
每个版本都有匹配的dee数据交换中间件
- 安装及网络部署说明:
Dee数据交换中间件基于B/S(浏览器/客户端)模式,支持在Windows和linux环境(不包含虚拟机环境)上安装,通过网络设备与其他计算机连接。
Dee数据交换中间件采用独立安装程序,为正常使用,请先确保需要进行数据交换的服务器访问正常。
安装过程中如遇到360拦截提示,请点击忽略,否则会导致安装失败;
DEE数据交换中间件,又叫做DEE独立引擎。
# 工具安装
# 1.1.1 Windows版安装
安装步骤:
将Dee数据交换中间件安装到Windows环境(不包含虚拟机环境)上。
第1步:解压安装包DEEV4.3Install.zip后的结构如下:
{width="2.5973556430446196in" height="1.9723239282589675in"}
双击SeeyonDEEServiceInstall.bat,安装程序开始安装,安装执行如图:
{width="6.385416666666667in" height="4.28125in"}
第2步:选择接受按照提示依次点击"下一步"即可完成安装 ,点击"完成"结束安装;
第3步:可点击安装目录中的"启动"startup.bat来运行;
第4步:启动完成后会自动打开浏览器进入中间件配置工具界面;
{width="4.541666666666667in" height="3.4583333333333335in"}
# 1.1.2 Linux版安装
安装步骤:
将Dee数据交换中间件安装到Linux环境上。
注意:请使用root权限账号进行以下操作。
第1步:解压安装包DEEV4.5Install.zip
解压缩命令: unzip DEEV4.5Install.zip
解压后在此目录下会生成DEEV4.5Install的文件夹,如下所示:
[root@localhost dee]# ls
DEEV4.5Install DEEV4.5Install.zip
解压缩后,先授权,命令:chmod -R 777 DEEV4.5Install
启动安装程序,注意,此步骤需要在linux的可视化界面进行操作,若环境没有安装可视化界面,请提前安装可视化界面。
在linux桌面上运行命令: sh SeeyonDEEServiceInstall.sh,安装程序开始安装
[root@localhost dee]# cd DEEV4.3Install/
[root@localhost DEEV4.5Install]# ls
data java SeeyonDEEServiceInstall.sh
[root@localhost DEEV4.5Install]# sh SeeyonDEEServiceInstall.sh
首先会弹出安装程序的启动页面,如下所示:
{width="6.385416666666667in" height="4.28125in"}
第2步:选择接受按照提示依次点击"下一步"即可完成安装 ,点击"完成"结束安装;
第3步:在启动前,先对安装后的文件夹进行授权。
命令: chmod -R 777 DEEServiceV4.3
进入安装路径,然启动运行脚本,命令: sh startup.sh
[root@localhost dee]# cd DEEServiceV4.5
[root@localhost DEEServiceV4.5 ]# ls
DEE_HOME docs jdk shutdown.sh Uninstall
DEE_Service images Logs startup.sh
[root@localhost DEEServiceV4.5 ]# sh startup.sh
第4步:启动完成后会自动打开浏览器进入中间件配置工具界面;
# 完成Dee数据交换中间件授权
第1步:登陆Dee数据交换中间件,访问地址: http://IP (opens new window)地址:8087(默认密码为123456,默认访问端口8087),会自动弹出未授权界面;
第2步:联系致远公司并提供安装服务器MAC地址,用户购买Dee可视化配置工具后,由致远公司提供授权文件,将授权文件放入安装目录下DEE_HOME\licence即可激活授权。
# 维护篇
本章节介绍系统目录,并说明如何进行数据备份和恢复。
# 系统目录说明
安装目录如:"D:\DEEServiceVx.x"下(根据自己本地实际安装查找)。
\DEE_HOME\conf文件夹:存放Dee数据交换中间件的配置文件。
\DEE_HOME\data文件夹:存放Dee数据交换中间件使用的H2数据库。
\DEE_HOME\hotdeploy文件夹:此文件夹是Dee数据交换中间件上传drp配置包的文件夹。
\DEE_HOME\codelib文件夹:存放用户代码库。
\DEE_HOME\logs文件夹:存放Dee数据交换中间件日志。
# 数据备份与恢复
Dee数据交换中间件的所有数据均存于 \DEE_HOME\data文件夹中的H2数据库中,只需备份H2数据库及恢复,即可完成数据备份与恢复。
# 卸载篇
本章节介绍如何卸载DEEServiceV4.5
# 3.1 Windows版本卸载
打开安装目录,如D:\ DEEServiceV4.5
选择D:\ DEEServiceV4.5\Uninstall_DEEService\uninstallDEEService.sh
点击"卸载",稍等片刻完成卸载
# 3.2 Linux版本卸载
打开安装目录,进入DEEServiceV4.5的卸载目录
运行uninstallDEEService.Sh卸载程序
命令:sh uninstallDEEService.sh
- 点击"卸载",稍等片刻完成卸载
点击完成按钮,卸载程序提出,卸载完毕!
本版本不能直接升级,需新安装再重新获取授权,并从原中间件导出drp,部署到本版本中;
本版本兼容以前版本的drp文件导入;
# A8+升级
<!-- -->
- 无;
需要A8+加密狗中含有DEE插件;
进入A8+的group-admin(企业版admin)账户(中间件具体服务配置,请参考《DEE V4.5用户操作手册》,如图:
{width="6.764583333333333in" height="4.567361111111111in"}
# 国产化-信创环境部署
DEE中间件信创环境目前支持东方通(Tongweb)和金蝶(AAS)
# 适配的信创环境如下:
产品版本 支持范围
V8.0SP1 CPU 龙芯、飞腾、华为鲲鹏
服务端操作系统 中标麒麟、银河麒麟、UOS(统信)
中间件 东方通7.0
金蝶9.0
数据库 达梦8.0
人大金仓8.0
客户端操作系统 银河麒麟、UOS(统信)
操作系统建议安装图形化界面,操作系统、中间件、数据库的安装参考其提供的手册,本文不做阐述。
# 硬件配置
根据系统实际在线诉求,最低硬件配置参考如下:
CPU类型 内存
ARM(鲲鹏/飞腾) 2G
# MIPS(龙芯) 2G
DEE_Service-N.zip为DEE国产化版本的制作工具的部署包。
注意:为了说明方便将DEE_Service-N路径记作${DEE_Service-N_HOME};东方通的安装目录路径为${TongWeb_Home},如果未安装东方通,请先安装。
# 部署步骤:
# 第一步:
- 上传DEE_Service-N.zip到信创环境,并解压到${DEE_Service-N_HOME},比如:unzip DEE_Service -N.zip -d DEE_Service-N
{width="4.034930008748907in" height="2.9862642169728786in"}
# 第二步:
- 进入${TongWeb _HOME}/bin/下,在external.vmoptions文件添加DEE_HOME的配置:-DDEE_HOME= ${DEE_Service-N-HOME}/DEE_HOME
{width="5.768055555555556in" height="2.5006944444444446in"}
- 进入${ TongWeb _HOME}/conf/下,修改environment.conf文件的JAVA_HOME配置为环境的jdk目录,如:
JAVA_HOME= /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.242.b08-1.h5.ky10.aarch64/jre
{width="5.768055555555556in" height="2.5861111111111112in"}
# 第三步:
进入${TongWeb_Home}/conf/tongweb.xml,在路径tongweb/apps中添加如下片段(注意:添加位置靠前紧跟web-app之后):
<web-app name="DEE_Service" original-location="${DEE_Service-N_HOME}/DEE_Service" location="${DEE_Service-N_HOME}/DEE_Service" context-root="/" vs-names="server" is-directory="true" enabled="true" description="dee service" deploy-order="100" object-type="user" jsp-compile="false" dtd-validate="false" is-autodeploy="false" version="" retire-state="none" retire-strategy="nature" retire-timeout="0" version-serial-number="1" delegate="false" cache-max-size="10240"/>
{width="5.768055555555556in" height="2.0555555555555554in"}
# 第四步:
进入${TongWeb_Home}/conf/tongweb.properties,修改tongweb.util.scan.StandardJarScanFilter.jarsToSkip属性,根据已有格式在最后添加扫描过滤:
jwycbjnoyees-*.jar,\
picocli-*.jar
{width="5.768055555555556in" height="3.308333333333333in"}
# 启动东方通:
# 第一步:
进入${TongWeb_Home}/bin运行启动命令:./startserver.sh
{width="5.768055555555556in" height="0.7388888888888889in"}
# 第二步:
登录东方通管理界面: http://IP:9060/console/rest (默认端口是9060)
创建HTTP通道管理,端口设置为8087,然后登录dee中间件服务(http://IP:8087 (opens new window))
{width="5.768055555555556in" height="2.658333333333333in"}
{width="5.768055555555556in" height="2.4340277777777777in"}
<http-listener name="deeConfig-http-listener" port="8085" address="0.0.0.0" io-mode="nio2" ssl-enabled="false" redirect-port="8443" uri-encoding="UTF-8" use-body-encoding-for-uri="false" max-post-size="-1" parse-body-methods="GET,POST" default-virtual-host="server" create-time="2021-03-16 16:24:13">
<ssl/>
<protocol async-timeout="10000" backlog="100" connection-timeout="60000" keep-alive-timeout="60000" max-threads="200" min-spare-threads="10" processor-cache="200" tcp-no-delay="true">
<property name="threadPriority" value="5"/>
</protocol>
<http-options compression="off" disable-upload-timeout="true" max-keep-alive-requests="100"/>
<advance oom-parachute="1048576"/>
</http-listener>
{width="5.768055555555556in" height="1.6458333333333333in"}
{width="4.847471566054243in" height="4.021040026246719in"}
{width="5.768055555555556in" height="2.620138888888889in"}
备注:登录后需要申请授权,则将服务器的mac地址给研发,研发给授权文件(dee.lic), 然后上传到${DEE_Service-N_HOME}/licence/下即可
# 金蝶部署:
# 说明:
DEE_Service-N.zip为DEE国产化版本的制作工具的部署包。
注意:为了说明方便将DEE_Service-N路径记作${DEE_Service-N_HOME};金蝶的安装目录路径为${AAS_Home},如果未安装金蝶中间件,请先安装并创建域,如:${AAS_Home}/domains/dee
# 部署步骤:
# 第一步:
上传DEE_Service-N.zip到信创环境,并解压到${DEE_ Service-N_HOME},比如:
unzip DEE_ Service-N.zip -d DEE_ Service-N
{width="4.055764435695538in" height="2.6876377952755908in"}
# 第二步:
进入${AAS_HOME}/bin下,修改setenv文件的JAVA_HOME配置为环境的jdk目录,如:
JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.242.b08-1.h5.ky10.aarch64/jre
{width="5.768055555555556in" height="3.102777777777778in"}
# 第三步:
进入域${AAS_HOME}/domains/dee/config/vm.options添加DEE_HOME配置如下:
DEE_HOME=${DEE_Service-N_HOME}/DEE_HOME
{width="5.768055555555556in" height="3.058333333333333in"}
# 第四步:
进入域${AAS_HOME}/domains/dee/config/server.xml添加项目部署配置如下:
<server>
<application name="DEE_Service" base="${DEE_ Service-N_HOME}/DEE_Service" base-context="/" start="auto"/>
</server>
{width="5.768055555555556in" height="2.173611111111111in"}
# 第五步:
打开${AAS_HOME}/domains/dee/config/apusic.conf文件, 在标签
<SERVICE CLASS="com.apusic.net.Muxer" >中修改port属性6888 为 8087
<ATTRIBUTE NAME="Port" VALUE="8087"/>
{width="5.768055555555556in" height="3.2243055555555555in"}
# 第六步:
修改文件:${AAS_HOME}/domains/dee/config/web.xml,添加文件上传配置:
<context-param>
<param-name>apusic.allowCasualMultipartParsing</param-name>
<param-value>true</param-value>
</context-param>
{width="5.768055555555556in" height="3.408333333333333in"}
# 第七步:
将${DEE_Service-N_HOME}/DEE_Service/WEB-INF/lib/下的javax.ws.rs-api-2.1.jar 拷贝到金蝶${AAS_HOME}/lib/endorsed下
{width="6.535057961504812in" height="1.5348009623797025in"}
# 启动金蝶:
# 第一步:
进入${AAS_Home} /domains/dee/bin运行启动命令:./startapusic
{width="7.8615146544181975in" height="1.3889599737532807in"}
# 第二步:
登录金蝶管理界面: http://IP:8087/admin (默认端口是6888)
登录dee制作工具:http://IP:8087
{width="5.768055555555556in" height="0.9208333333333333in"}{width="4.507176290463692in" height="3.777972440944882in"}
{width="5.768055555555556in" height="2.473611111111111in"}
备注:登录后需要申请授权,则将服务器的mac地址给研发,研发给授权文件(dee.lic), 然后上传到${DEE_Service-N_HOME}/licence/下即可
------注意9.0版本的OA(4.5的中间件)不在使用服务器的mac地址作为授权机制了,使用了加密狗信息