Java快速安装-window

1 系统安装

1.1 系统介绍

本系统分为Engine端与Portal端，Portal端负责与用户进行交互，Engine负责数据的操作。目前版本Portal与Engine既可以单机部署，也可以分机部署。

1.2 服务器安装必备软件

在使用该工作流软件之前，有以下一些软件是必须安装：

l JDK 8.0以上版本(必须，安装包已自带，无须再次安装)

l Tomcat 7(必须，安装包已自带，无须再次安装)

l 数据库二选其一即可：1、SQL SERVER 2008及以上版本 2、Oracle11g及以上版本，ODAC 112.3.0 版本（安装Oracle时必选） 3、MYSQL5.7及以上版本

l Nginx(必须，安装包已自带，无须再次安装)

l Zookeeper（双引擎必备，安装包已自带，无需再次安装）

1.3 客户端必备软件

l 浏览器：Chrome浏览器；IE9以上

1.4 注意事项

l 数据库请勿使用8.x或之前版本的H3数据库；

l 如果要与原版本共存，那么此版本引擎端口号请勿与旧版本引擎端口号相同，旧版本端口号默认为8212，此版本引擎端口号可在配置文件中更改，具体更改步骤请看下章节提示说明；

l 如使用oracle数据库，确保数据库编码为AL32UTF8，确保数据库最大游标数大于1000

l 如使用mysql数据库，确保数据库编码为UTF-8，设置表名不区分大小写，设置允许远程访问，设置允许数据包大小大于10M。（lower_case_table_names=1，max_allowed_packet=10M）

l nginx配置文件http{}里面添加client_max_body_size 10m

2 系统安装

2.1 安装过程

将JAVA版的H3 BPM压缩包解压到对应的目录，解压后的效果如下图：

其中h3bpm-engine为Engine端所在目录，h3bpm-portal为Portal端所在目录，jdk1.8.0_172为jdk所在目录，dist是移动端静态文件，nginx代理服务安装包，zookeeper为注册中心。

解压dist.zip文件至当前目录。

2.1.1 引擎端配置

进入h3bpm-engine目录，编辑h3bpm_db_config.xml文件，此文件为配置H3BPM的数据库信息，用户需自行指定SharedService节点下相应的信息，注意：只有在SqlServer数据库情况下才需配置H3CloudName与H3CloudLogName，其中H3CloudName为业务数据库名称，H3CloudLogName为日志记录库名称，配置它们名称时需确保名称不与原实例中其他数据库名重复即可。

名称	说明
DBServer	数据库服务器ip，默认为127.0.0.1
DBName	数据库名称
DBUser	连接数据库的用户名
DBPassword	连接数据库的密码
DBType	数据库类型，可选项（大小写严格区分）：1, Oracle; 2, SqlServer; 3,MySql
DBConnString	数据库连接url, 1, Oracle：jdbc:oracle:thin:@数据库ip:端口号:数据库名称， 2, SqlSever: jdbc:sqlserver://数据库ip:端口号;DatabaseName=数据库名称 3, MySql: jdbc:mysql:// 数据库ip:端口号;DatabaseName=数据库名称
H3CloudName	业务数据库名称，SqlServer情况下才需配置，不与数据库中实例中其他数据库名称相同即可
H3CloudLogName	业务日志数据库名称，SqlServer情况下才需配置，不与数据库中实例中其他数据库名称相同即可

SqlServer、Oracle和MySql参考配置如下图：

Oracle:

SqlServer：

MySql:

配置完相应信息后保存即可。

最后编辑h3bpm_engine.properties文件，此文件为Engine配置文件，如下图，

如果是单引擎，可以不使用注册中心，只需配置BPMEngine为Engine机器所在IP与端口，格式为：引擎ip地址:端口;即可，单引擎也可使用注册中心。

如果是双引擎，则需要使用注册中心，除了单引擎所需的配置外，同时须配置registry.center.enable为true，registry.center.address注册中心地址，zookeeper服务器ip：端口，默认端口为2181。

注意：如果数据库端口不是默认端口，此文件也需要作相应修改。

2.1.2 Portal 端配置

修改配置文件前，请先查看application.yml文件中spring.profiles.active配置了哪个配置文件，如下图，配置了local，则默认会查找后缀为local的application.yml，即application-local.yml,若没有找到则默认使用application.yml配置文件。

1、单引擎，并且没有使用注册中心

进入Portal端所在目录，修改application-xx.yml文件，注意：请确保Tomcat端口唯一并不被占用并且防火墙规则中允许对外开放此端口，如下图：

引擎连接地址，默认修改引擎ip和端口就可以了，密码使用MD5加密

名称
说明
引擎地址信息
格式为：Servers=引擎ip地址:端口;User=用户名;Password=密码;Engine=引擎编码
注意：这里的信息需要与引擎端h3bpm_engine.properties文件配置的地址信息保持一致。
Tomcat端口
用户打开BPM管理系统时URL中的端口号，请确保端口唯一并不被占用并且防火墙规则中允许对外开放此端口
注意：请不要将此端口与引擎端口配置成一样。

2、双引擎，或者使用了注册中心
修改application-xx.yml文件
H3.engine.server无需配置，必须得配置zookeeper.enable为true，zookeeper.server注册中心地址，zookeeper服务器ip：端口，默认端口为2181，与引擎端配置同步
2.1.3 前端部署
前端代码使用nginx部署，请求后台接口通过nginx转发。
转发规则是：只转发非静态资源和服务端生成的图片。
部署需要修改nginx.conf 文件:
1. root 改成前端代码根目录。
2. 修改接口代理地址 proxy_pass为portal 的访问地址（2处）
2.1.4 Nginx配置
1、修改nginx/conf/nginx.conf文件，参考安装包自带的配置，根据当前服务器配置修改以下红色标注的地方
2.修改dist目录下serverConfig.json文件，修改为nginx当前监听使用的ip:端口
2.1.5 新版移动端
安装包默认使用了老版本移动端，要使用新版本需要修改配置
使用新版本配置：
修改application.yml

注释掉老版的接口扫描，使用新版本的接口扫描