2020-双十一-培训手册
页面树结构
转至元数据结尾
转至元数据起始

DWF部署支持三种模型模式：离线单机部署、在线云端部署、支持容器化的微服务部署。为帮助用户快速搭建简易开发演示环境，我们准备了完整的安装包和配套脚本，只需在Linux服务器中下载并运行即可。推荐使用Ubuntu 18.04版服务器，如果在其它Linux版本或其它操作系统的服务器上安装。

1.安装准备

1.1  硬件要求与操作系统


使用设备硬件配置操作系统备注
服务器（生产环境）

最低配置：4核i5-CPU，8GB内存，20G硬盘，1000Mb网卡，的PC机即可

推荐配置：E5-2620 v4*2，4*16G，2*300G , X520DP+I350含SFP+，H730P，750W交直流冗余电源,滑轨

Linux操作系统(推荐使用Ubuntu18.04)

应用服务器和数据库服务器可以独立部署。

用户终端设备（PC、便携机 ）i3或同等配置品牌机均可Windows 7 或 Windows 10

注：上述配置为推荐配置，实际情况下根据用户数的多少可以考虑单独部署在诸如：台式机、虚拟机、容器等环境下

1.2  服务器软件环境要求

DWF应用开发平台对软件环境要求如下：

  • JDK 1.8, 后端jar包运行依赖。
  • Node 10.16或者以上版本，前端控件开发依赖。
  • Python 3或者以上版本，高级开发配套脚本依赖。
  • tomcat 8 或者以上版本，通用Web服务,作为前端war包运行依赖。
  • PostgreSQL 9.5数据库服务器或者以上版本，DWF模型存放和应用运行后客户数据管理维护。

1.3 终端设备浏览器要求

DWF应用开发平台对浏览器要求如下:

  • Firefox/52.0以上
  • Edge 44.17以上
  • Chrome 70.0.3538.77

2. 一键部署安装

为方便用户快速安装，提供了一键部署安装的脚本，用户仅需准备1台安装完毕Ubuntu 18.04的裸系统，设置IP和添加用户dwf即可。

2.1 安装过程

<演示>下载安装包，一键部署安装过程如下

  • 下载一键安装脚本setup.sh与安装包setupfiles.tar.gz到同一目录下；
  • 在终端中增加setup.sh文件可执行权限；
  • 执行setup.sh文件（详细操作参考以下内容）
    • 解压setupfiles.tar.gz
    • 检测当前服务器JAVA环境，未安装则移动解压包内JAVA文件夹到opt文件内；设置java命令环境变量；
    • 移动解压包内Tomcat[webapps文件夹下已包含dwf前端war包]文件夹到opt文件内；修改启动端口为8180，并启动相关服务；
    • 移动解压包内Node文件夹到opt文件内；设置Node命令环境变量；
    • 安装解压包内pgsql文件夹下deb包。完成postgres安装并修改相关变量。创建初始化用户并导入dwf初始化数据库；
    • 移动解压包内dwf3.0-deploy文件夹到opt文件内。运行java -jar命令启动后端三个服务进程。

注意：安装目录路径不要有空格！

setup.sh和setupfiles.tar.gz文件同一目录中打开终端，执行代码：

1
2

chmod 755 setup.sh
./setup.sh

安装过程：

注意：在确认是否安装Pg数据库[重置数据]时，请输入大写的Y或N！

数据库启动成功：

服务器部署完毕：

出现上图PostgreSQL创建表成功提示和服务器部署完毕提示，代表部署成功。

注意：一键部署脚本仅适用于全新的Ubuntu 18.04系统，如系统已安装有DWF需要的组件，例如PG等可能会产生安装冲突。

2.2 产生的安装文件

系统安装完毕，会产生系统运行要求的文件，其中包含运行需要2个WEB文件夹、3个jar包和1个PostgreSQL数据库等，产生的文件见下表。

序号

文件夹名

文件（夹）名

文件类型

存放位置

说明

1jdk1.8.0_211
应用程序/opt/jdk1.8.0_211java文件夹
2node-v10.16.0
应用程序/opt/node-v10.16.0nodejs和npm文件夹
3postgresql
应用程序/etc & /var系统级安装分布于系统etc和var文件夹
     4apache-tomcat
应用程序/opt/apache-tomcattomcat文件夹
     5modeler-web
运行程序文件/opt/apache-tomcat/webapps建模端web页面程序，用于启动模型定制工具
     6app-web
运行程序文件/opt/apache-tomcat/webapps应用端web页面程序，用于解释后台定制的模型，在前端产生业务应用功能。一般由终端用户使用。
     7helps
帮助手册/opt/apache-tomcat/webapps帮助手册文件夹
     8code空代码存放文件夹/opt/apache-tomcat/webapps空文件夹，用户使用和创建超级控件时代码存放文件夹
     9  

dwf3.0-deploy

application.properties

配置文件

/opt/dwf3.0-deploydwf3.0-deploy
dwf-monitor-1.0-SNAPSHOT.jar运行程序文件/opt/dwf3.0-deployMonitor后台接口，用于系统监控

dwf-app-1.0-SNAPSHOT.jar

运行程序文件

/opt/dwf3.0-deploy

APP后来接口，和app前端配套，用于操作用户数据。

dwf-modeler-1.0-SNAPSHOT.jar运行程序文件/opt/dwf3.0-deployModeler后台接口，和modeler前端配套，用于控制模型数据。
dwf_sdkSDK文件夹/opt/dwf3.0-deploydwf依赖python脚本和SDK源码


3. 启动DWF

3.1 重启DWF

使用重启命令即可启动：

./restart.sh

3.2 手动启动DWF

DWF服务的运行需要以下步骤（除PG启动任务必须优先于后端服务启动任务之前外其他无排序）。

（1）启动PG数据库DWF

sudo -u postgres /usr/lib/postgresql/10/bin/pg_ctl restart -D /var/lib/postgresql/10/main

（2）启动tomcat

cd /opt/apache-tomcat/bin
sudo nohup ./startup.sh &

（3）启动DWF后端进程（modeler、app、monitor）

cd /opt/dwf3.0-deploy
nohup java -Dlogging.file=/opt/dwf3.0-deploy/dwf-modeler.log -jar /opt/dwf3.0-deploy/*dwf-modeler*.jar --server.port=6060 --spring.config.location=/opt/dwf3.0-deploy/application.properties > /dev/null 2>&1 &

nohup java -Dlogging.file=/opt/dwf3.0-deploy/dwf-monitor.log -jar /opt/dwf3.0-deploy/*dwf-monitor*.jar --server.port=7070 --spring.config.location=/opt/dwf3.0-deploy/application.properties > /dev/null 2>&1 &

nohup java -Dlogging.file=/opt/dwf3.0-deploy/dwf-app.log -jar /opt/dwf3.0-deploy/*dwf-app*.jar --server.port=9090 --spring.config.location=/opt/dwf3.0-deploy/application.properties > /dev/null 2>&1 &

3.3 运行环境检查

一键安装脚本在结束前会将DWF系统的整体运行命令执行一遍，所以脚本执行结束后可直接采用在客户端浏览器访问以下链接验证服务是否运行和启动：

安装成功后，可通过浏览器访问以下链接不同端口查看后端服务是否正常启动，具体地址为：

确认后端服务正常启动后，可通过浏览器访问以下链接8180端口访问并登陆前端服务，具体地址为：

  • 模型前端：http://[IP]:8180/modeler-web 验证前端modeler-web服务是否启动，后端dwf-modeler.jar是否正常访问。
  • 对象前端：http://[IP]:8180/app-web 验证前端app-web服务是否启动，后端dwf-modeler.jar与dwf-app.jar是否正常访问。

其中，模型前端（modeler-web）是建模工具，提供组织模型，数据模型，表单模型，功能模型和权限模型等模型数据的编辑能力，一般由系统管理员使用；对象前端（app-web）是提供解释模型的应用支撑引擎，包括认证引擎、对象管理框架、表单引擎、主界面引擎和规则引擎等，一般由终端用户使用。

如需查询本机ip地址，可在任意终端输入ip addr命令：


DWF安装完成后，系统提供一个默认用户admin，密码为123456，该用户可以登录建模工具（modeler）和应用前端（app）。

访问modeler-web页面：

图-modeler-web建模工具页面


点击登录后进入建模工具首页：

图- modeler-web建模工具主界面

目前DWF还没有定制任何功能，在应用前端显示空白界面。访问app-web页面：

图-DWF应用端空白界面

4. 备份与更新升级

需要更新升级DWF应用开发平台时，可参考本节内容。本节基于仅平台代码更新而数据库无变化，但更新前也请对数据库做好相应备份工作。通过DWF界面右上角用户名处可以查看当前版本，如下：

图-查看DWF当前版本

更新前，建议先对当前系统进行备份。如果没有在系统中开发过超级控件，则只需要对数据库进行简单备份。DWF将所有建模和对象都存储在postgres本机（localhost:5432）的dataway数据库中。备份方法：

  • 通过pgadmin备份dataway数据库。具体方法请自行搜索pgadmin备份和还原数据库方法。
  • 通过终端备份dataway数据库，代码如下：

1

pg_dump -h localhost -p 5432 -U postgres dataway > [本地路径]/[文件名].sql

对DWF平台的更新升级步骤如下：

  • 下载更新脚本upgrade.sh与更新包upgradefile.tar.gz到同一目录下
  • 在终端中增加upgrade.sh文件可执行权限
  • 执行upgrade.sh文件


另外，如果想了解DWF生产环境配置步骤细节，进一步解读DWF配置过程，可参阅：系统安装手册。



  • 无标签