DEE数据交换中间件

安装维护手册

产品研发中心

2024/7/19

# 目 录 {#目-录 ._Style-3}

前 言 3

第一章 安装篇 4

工具安装 4

1.1.1 Windows版安装 4

1.1.2 Linux版安装 6

完成Dee数据交换中间件授权 7

第二章 维护篇 9

2.1. 系统目录说明 9

2.2. 数据备份与恢复 9

第三章 卸载篇 10

3.1 Windows版本卸载 10

3.2 Linux版本卸载 10

第四章 升级篇 11

4.1. 数据交换中间件升级 11

4.2. A8+升级 11

第五章 DEE插件启动 12

5.1. A8+插件配置 12

第六章 国产化-信创环境部署 13

6.1. 适配的信创环境如下: 13

6.2. 硬件配置 13

6.3. 东方通部署: 13

6.3.1 说明: 13

6.3.2 部署步骤: 13

6.3.3 启动东方通: 16

6.4. 金蝶部署: 18

6.4.1 说明: 18

6.4.2 部署步骤: 19

6.4.3 启动金蝶: 22

# 前言

欢迎您使用致远软件DEE数据交换中间件

目前致远软件Dee数据交换中间件已经达成了可独立部署运行,实现零代码构建多个同构、异构系统之间的数据交互。为用户构建系统之间的通信提供了简单、方便的操作模式。

Dee数据交换中间件操作简单,特附帮助文档和应用实例,用户可快速掌握;采用独立的安装程序,帮助用户实现轻松安装。

本手册是针对Dee数据交换中间件的快速安装手册,供系统管理人员或维护人员使用,期望它能给您的工作带来更高的效率和更高的品质。有任何问题或好的建议,也欢迎您及时提出,谢谢!

# 安装篇

本章节介绍Dee数据交换中间件运行的环境要求,版本匹配及如何安装并启动Dee数据交换中间件。

  • 配置要求

  • 版本匹配

本版本数据交换中间件(V4.5)仅适配A8+ V9.0版本的连接和DEE V4.5可视化配置工具制作的任务。

每个版本都有匹配的dee数据交换中间件

  • 安装及网络部署说明:

Dee数据交换中间件基于B/S(浏览器/客户端)模式,支持在Windows和linux环境(不包含虚拟机环境)上安装,通过网络设备与其他计算机连接。

  1. Dee数据交换中间件采用独立安装程序,为正常使用,请先确保需要进行数据交换的服务器访问正常。

  2. 安装过程中如遇到360拦截提示,请点击忽略,否则会导致安装失败;

  3. 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版本卸载

  1. 打开安装目录,如D:\ DEEServiceV4.5

  2. 选择D:\ DEEServiceV4.5\Uninstall_DEEService\uninstallDEEService.sh

  3. 点击"卸载",稍等片刻完成卸载

# 3.2 Linux版本卸载

  1. 打开安装目录,进入DEEServiceV4.5的卸载目录

  2. 运行uninstallDEEService.Sh卸载程序

命令:sh uninstallDEEService.sh

  1. 点击"卸载",稍等片刻完成卸载

点击完成按钮,卸载程序提出,卸载完毕!

  1. # 升级篇

    1. # 数据交换中间件升级

  • 本版本不能直接升级,需新安装再重新获取授权,并从原中间件导出drp,部署到本版本中;

  • 本版本兼容以前版本的drp文件导入;

    1. # A8+升级

<!-- -->
  • 无;
  1. # DEE插件启动

    1. # 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

  1. # 东方通部署:

    1. # 说明:

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/下即可

# 金蝶部署:

  1. # 说明:

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地址作为授权机制了,使用了加密狗信息

创建人:wujhyf
修改人:wujhyf