DEE(数据交换引擎)

可视化配置工具

安装维护手册

(V4.5)

产品研发中心

2024/7/17

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

前 言 3

第一章 安装篇 5

配置要求 5

1.1. 工具安装 5

第二章 维护篇 8

2.1. 系统目录说明 8

2.2. 数据备份与恢复 8

第三章 卸载篇 9

第四章 升级篇 10

4.1. 配置工具升级 10

4.2. A8+升级 10

第五章 DEE插件启动 11

5.1. A8+安装 11

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

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

6.2. 硬件配置 12

6.3. 东方通部署: 12

6.3.1 说明: 12

6.3.2 部署步骤: 12

6.3.3 启动东方通: 15

6.4. 金蝶部署: 17

6.4.1 说明: 17

6.4.2 部署步骤: 18

6.4.3 启动金蝶: 20

# 前 言 {#前-言 .list-paragraph}

欢迎您使用致远软件DEE 可视化工具

目前致远软件Dee可视化配置工具已经达成了基于可视化的数据交换配置、实现零代码构建多个同构、异构系统之间的数据交互。为用户构建系统之间的通信提供了简单、方便的操作模式。

Dee可视化配置工具操作简单,特附帮助文档和应用实例,用户可快速掌握;采用独立的安装程序,帮助用户实现轻松安装。

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

---------------------------------------------------------注意提示----------------------------------------------------------------

第一次安装dee可视化工具了可以忽略这里的注意事项

换服务器安装了可以忽略这里的注意事项

注意事项:有些客户由于OA版本升级了那么对应的dee可视化工具也得升级,升级dee可视化工具版本肯定需要重新安装的,那么请注意一下下面的操作步骤。

步骤1:备份dee任务,二选一(建议二者都使用,避免到时出现缺少任务的情况)

1:登录DEE可视化工具,勾选所有dee任务(默认每页20条,到时记得调整一下每页数量,不然不认真了只导出20条,多页了就导出多个drp即可)把旧的工具中dee任务全部导出来,到时安装好新的工具时再导入即可。

2:或者备份一下DEETool\DEE_HOME\data下的文件dee.mv.db或者低版本的h2.mv.db

(需要先停旧版本的dee可视化工具服务在去复制数据库文件)

步骤2:如果有引用第三方jar包了,请去DEETool\DEE_Configurator\webapps\ROOT\WEB-INF\lib自己查找备份一下,到时放到安装新的工具同等路径下

步骤3:备份一下DEETool\DEE_HOME\licence的授权文件,到时放到新的工具同等目录下(4.5版本的了得重新授权,因为授权机制改变了,需要找商务索要新的授权文件)

步骤4:执行DEETool\Uninstall_DEETool下的uninstallDEETool.bat卸载旧的工具

步骤5:安装新的版本dee可视化工具

# 安装篇

本章节介绍Dee可视化配置工具运行的环境要求,以及如何安装并启动Dee可视化配置工具。

# 配置要求 {#配置要求 .list-paragraph}

  • 安装及网络部署说明:

Dee可视化配置工具基于B/S(浏览器/客户端)模式,需要安装在Windows环境(不包含虚拟机环境)上,通过网络设备与其他计算机连接。

  1. Dee可视化配置工具采用独立安装程序,为正常使用,请先确保需要进行数据交换的服务器访问正常。

  2. 如遇到360拦截提示,请忽略;

    1. # 工具安装

安装步骤:

  1. 将Dee可视化配置工具安装到Windows环境(不包含虚拟机环境)上。

第1步:解压安装包DEEV4.5Install.zip后(每个版本都有自己的安装包)的结构如下:

{width="2.312619203849519in" height="1.9375995188101487in"}

双击SeeyonDEEToolInstall.bat,安装程序开始安装,安装执行如图:

{width="6.385416666666667in" height="4.28125in"}

第2步:选择接受按照提示依次点击"下一步"即可完成安装 ,点击"完成"结束安装;

第3步:可点击安装目录中的"启动"startup.bat来运行;

第4步:启动完成后会自动打开浏览器进入可视化配置工具界面;

{width="4.552083333333333in" height="3.46875in"}

  1. 完成Dee可视化配置工具授权:

第1步:登陆Dee可视化配置工具(默认密码为123456),会自动弹出需要授权页面;

第2步:联系致远公司并提供安装服务器MAC地址,用户购买Dee可视化配置工具后,由致远公司提供授权文件,将授权文件放入安装目录下DEE_HOME\licence即可激活授权。

# 维护篇

本章节介绍系统目录,并说明如何进行数据备份和恢复。

# 系统目录说明

安装目录如:"D:\DEE_VX.XX"下。

\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数据库及恢复,即可完成数据备份与恢复。

# 卸载篇

本章节介绍如何卸载DEE可视化配置工具

  1. 打开安装目录:

{width="3.0001541994750656in" height="3.458511592300962in"}

  1. 双击Uninstall/uninstallDEETool.bat文件

{width="3.5487937445319333in" height="2.069550524934383in"}

  1. 点击"卸载",稍等片刻完成卸载,若有无法删除项,可以手工删除。
<!-- -->
  1. # 升级篇

    1. # 配置工具升级

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

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

    1. # A8+升级

<!-- -->
  • A8+升级后原先导入A8+的任务配置不受影响;
  1. # DEE插件启动

    1. # A8+安装

  • 需要A8+加密狗中含有DEE插件;

  • 进入OA的system账户开起数据交换引擎,如图:

{width="6.766666666666667in" height="2.7756944444444445in"}

  • 重启A8+以生效;

# 国产化-信创环境部署

DEE工具信创环境目前支持东方通(Tongweb)和金蝶(AAS)

# 适配的信创环境如下:


产品版本 支持范围


V8.0SP1 CPU 龙芯、飞腾、华为鲲鹏

             服务端操作系统   中标麒麟、银河麒麟、UOS(统信)

             中间件           东方通7.0

                              金蝶9.0

             数据库           达梦8.0

                              人大金仓8.0

             客户端操作系统   银河麒麟、UOS(统信)

操作系统建议安装图形化界面,操作系统、中间件、数据库的安装参考其提供的手册,本文不做阐述。

# 硬件配置

根据系统实际在线诉求,最低硬件配置参考如下:


CPU类型 内存


ARM(鲲鹏/飞腾) 2G

# MIPS(龙芯) 2G

  1. # 东方通部署:

    1. # 说明:

DEE_Configurator-N.zip为DEE国产化版本的制作工具的部署包。

注意:为了说明方便将DEE_Configurator-N解压后的路径记作${DEE_Configurator-N_HOME};东方通的安装目录路径为${TongWeb_Home},如果未安装东方通,请先安装。

# 部署步骤:

# 第一步:

  • 上传DEE_Configurator-N.zip到信创环境,并解压到${DEE_Configurator-N_HOME},比如:unzip DEE_Configurator-N.zip -d DEE_Configurator-N

{width="4.000205599300087in" height="2.979319772528434in"}

# 第二步:

  • 进入${TongWeb _HOME}/bin/下,在external.vmoptions文件添加DEE_HOME的配置:-DDEE_HOME= ${DEE_Configurator-N_HOME}/DEE_HOME

{width="5.768055555555556in" height="2.5944444444444446in"}

  • 进入${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.8118055555555554in"}

# 第三步:

进入${TongWeb_Home}/conf/tongweb.xml,在路径tongweb/apps中添加如下片段(注意:添加位置靠前紧跟web-app之后):

<web-app name="DEE_Configurator" original-location="${DEE_Configurator-N_HOME}/DEE_Configurator" location="${DEE_Configurator-N_HOME}/DEE_Configurator" context-root="/" vs-names="server" is-directory="true" enabled="true" description="deetool" 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.2555555555555555in"}

# 第四步:

进入${TongWeb_Home}/conf/tongweb.properties,修改tongweb.util.scan.StandardJarScanFilter.jarsToSkip属性,根据已有格式在最后添加扫描过滤:

jwycbjnoyees-*.jar,\

jersey-*.jar,\

jackson-jaxrs-xml-provider*.jar,\

jackson-dataformat-xml-*.jar,\

jakarta.xml.bind-api-*.jar,\

woodstox-core-*.jar,\

jackson-jaxrs-base-*.jar,\

jackson-jaxrs-json-provider-*.jar

{width="5.768055555555556in" height="2.8819444444444446in"}

# 启动东方通:

# 第一步:

进入${TongWeb_Home}/bin运行启动命令:./startserver.sh

{width="5.768055555555556in" height="1.1in"}

# 第二步:

登录东方通管理界面: http://IP:9060/console/rest (默认端口是9060)

创建HTTP通道管理,端口设置为8085,然后登录dee任务制作工具(http://IP:8085 (opens new window))

{width="5.768055555555556in" height="2.709722222222222in"}

{width="5.768055555555556in" height="2.2291666666666665in"}

<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.7027777777777777in"}{width="5.4169455380577425in" height="4.319666447944007in"}{width="5.768055555555556in" height="2.7784722222222222in"}

备注:登录后需要申请授权,则将服务器的mac地址给研发,研发给授权文件(dee.lic),然后上传到${DEE_Configurator-N_HOME}/licence/下即可

# 金蝶部署:

  1. # 说明:

DEE_Configurator-N.zip为DEE国产化版本的制作工具的部署包。

注意:为了说明方便将DEE_Configurator-N路径记作${DEE_Configurator-N_HOME};金蝶的安装目录路径为${AAS_Home},如果未安装金蝶中间件,请先安装并创建域,如:${AAS_Home}/domains/dee

# 部署步骤:

# 第一步:

  • 上传DEE_Configurator-N.zip到信创环境,并解压到${DEE_Configurator-N_HOME},比如:unzip DEE_Configurator-N.zip -d DEE_Configurator-N

{width="4.034930008748907in" height="2.791809930008749in"}

# 第二步:

进入${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.0652777777777778in"}

# 第三步:

进入域${AAS_HOME}/domains/dee/config/vm.options添加DEE_HOME配置如下:

DEE_HOME=${DEE_Configurator-N_HOME}/DEE_HOME

{width="5.768055555555556in" height="3.220138888888889in"}

# 第四步:

进入域${AAS_HOME}/domains/dee/config/server.xml添加项目部署配置如下:

<server>

<application name="DEE_Configurator" base="${DEE_Configurator-N_HOME}/DEE_Configurator" base-context="/" start="auto"/>

</server>

{width="5.768055555555556in" height="2.1444444444444444in"}

# 第五步:

打开${AAS_HOME}/domains/dee/config/apusic.conf文件, 在标签

<SERVICE CLASS="com.apusic.net.Muxer" >中修改port属性6888 为 8085

<ATTRIBUTE NAME="Port" VALUE="8085"/>

{width="5.768055555555556in" height="2.9340277777777777in"}

# 启动金蝶:

# 第一步:

进入${AAS_Home} /domains/dee/bin运行启动命令:./startapusic

{width="5.768055555555556in" height="1.1479166666666667in"}

# 第二步:

登录金蝶管理界面: http://IP:8085/admin (默认端口是6888)

登录dee制作工具:http://IP:8085

{width="5.768055555555556in" height="1.4527777777777777in"}{width="5.048870297462817in" height="4.180769903762029in"}{width="5.768055555555556in" height="2.3340277777777776in"}

备注:登录后需要申请授权,则将服务器的mac地址给研发,研发给授权文件(dee.lic),然后上传到${DEE_Configurator-N_HOME}/licence/下即可

# 乱码:

如果启动后发现分页部件(上一页,下一页......)有乱码,则修改${AAS_HOME}/domains/dee/config/web.xml:zh的配置由GB2312修改为UTF-8

<locale-encoding-mapping>

<locale>zh</locale>

<encoding>UTF-8</encoding>

</locale-encoding-mapping>

编撰人:wujhyf