DEE(数据交换引擎)
可视化配置工具
安装维护手册
(V4.5)
产品研发中心
2024/7/17
# 目 录 {#目-录 ._Style-3}
# 前 言 {#前-言 .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环境(不包含虚拟机环境)上,通过网络设备与其他计算机连接。
Dee可视化配置工具采用独立安装程序,为正常使用,请先确保需要进行数据交换的服务器访问正常。
如遇到360拦截提示,请忽略;
# 工具安装
安装步骤:
- 将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"}
- 完成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可视化配置工具
- 打开安装目录:
{width="3.0001541994750656in"
height="3.458511592300962in"}
- 双击Uninstall/uninstallDEETool.bat文件
{width="3.5487937445319333in"
height="2.069550524934383in"}
- 点击"卸载",稍等片刻完成卸载,若有无法删除项,可以手工删除。
<!-- -->
本版本不能直接升级,需新安装再重新获取授权,并从原中间件导出drp,部署到本版本中;
本版本兼容以前版本的drp文件导入;
# A8+升级
<!-- -->
- A8+升级后原先导入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
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/下即可
# 金蝶部署:
# 说明:
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>
快速跳转
← 常见问题 DEE数据交换中间件安装维护手册 →
