单机部署
1 概述
本文档中操作的示例: 操作系统为JDK 1.8、Mysql5.7数据库
windows、linux等环境步骤及命令一样。
【注】 提供的产品包默认为JDK11以下的,所以要求JDK1.6及以上版本,JDK11以下,推荐使用1.8。 如需要使用JDK17,需单独申请JDK17的产品包。
2 数据库准备
修改数据库配置信息不区分大小写。
使用数据库工具创建一个新的数据库,后边初始化数据库需要使用,字符集utf8。
【注】 产品jar包默认只有mysql5、oracle、达梦的驱动包
mysql8或其他数据库需要单独增加数据库驱动,参考 JAR包部署:修改数据库驱动文件的办法
3 启动服务
将jar包拷贝到安装目录下(注意不能含有中文),在DOS模式下进入安装目录所在的文件夹。
执行命令:java -jar <jar包名>(需要根据实际文件名进行调整)。
执行命令后,后台会自动启动内嵌的Tomcat中间件服务器,所以不需要自己准备Tomcat。
启动命令示例:java -jar horizon-workflowformengine-boot-8.2.3.jar

启动服务之后,出现以下内容就表示启动成功。

4 访问服务
启动成功后,在浏览器中访问工作流,可以通过IP地址,也可以通过localhost。
例如本文访问:http://localhost:8080/horizon-workflowformengine-boot
产品配置文件中默认的端口号:8080
上下文地址:horizon-workflowformengine-boot
从后台日志输出,也可以找到端口号和上下文的信息:
访问成功后,出现以下界面:

- 数据库类型选择:Mysql
- 修改数据库连接地址中的ip、端口、数据库名称。
- 修改数据库名称、密码。
- 信息填写成功后,执行"测试链接"。
如果执行测试链接失败,需要确认以下信息是否正常,结合后台日志分析问题:
- 网络情况。应用所在服务器与数据库所在服务器网络连接情况、应用服务器能不能连通mysql的端口号
- 数据库链接信息、数据库名称、密码。
- 驱动版本
- 测试链接通过后,执行"初始化",等待"初始化"成功提示。
如果报错,可参考此处排查原因: 部署报错常见问题(测试链接数据库异常、初始化失败)
5 上传License
初始化成功后,系统会自动跳转到上传License界面,系统给出License编码,请将编码发给软件提供商。
获取license文件后,点击上传按钮,完成系统License上传。

上传完成后,系统提示完成操作,可以点击完成按钮,也可以等待3秒自动关闭。

License上传成功,并且验证通过,系统会自动跳转到登录界面。
注明:
- 如果生成的License文件与产品参数不符合,仍然会跳转到上传License界面。
- 如果超过一分钟还未跳转到登录页,查看后台报错。
6 登录工作流
用户名:admin
密码:1234

7 数据库配置文件说明
jar包工程启动后,会在服务所在服务器/电脑的磁盘上生成配置文件。
下次再次启动不会再重新生成,除非每次启动之前把原先已生成的配置文件删掉。
部署后配置文件默认生成位置:
- Windows系统:C:\Users\当前用户\workflow/properties
- linux:/Use/当前用户/workflow/properties
配置文件路径修改规则:
BOOT-INF\classes\workflow-conf\properties\horizon.properties
如果horizon.name有值,这个路径作为配置文件生成路径,下面会自动产生 workflow 文件夹;
如果没有值,则为默认生成位置,使用操作系统当前用户的根目录
如果对配置文件有修改,建议重新更新到 Jar 包内。
【注意】
- 授权文件也会生成到这个目录下。
- 页面上初始化的数据库连接信息,也是写到这个目录下,可以复制内容更新到jar包内
- 即便之后磁盘里文件被删掉或者更换配置文件生成路径,也不需要重新配置数据库链接信息了。
8 如何修改数据库配置
数据库配置文件说明
在【7 配置文件说明】的基础上,数据库配置文件会生成到磁盘里。
如果horizon.properties文件中horizon.name路径下的properties\dbconfig.properties存在,就不会重新再生成。
dbconfig.properties中horizon.identifier=
这个参数就是系统启动时判断有没有初始化数据库的标志。
- 如果有值:系统判定已初始化过,工程启动时会按照配置文件的数据库信息启动(默认system)
- 如果没有值:
- 系统判定还没有初始化数据库
- 启动成功后,在页面上访问http://localhost:8080/horizon-workflowformengine-boot
- 会跳转到数据库初始化界面。
想要重新初始化的两种修改方式
- 删除磁盘里的workflow\properties\dbconfig.properties中horizon.identifier= 的值,重新启动。
- 删除磁盘里的workflow\properties\dbconfig.properties文件,在jar包里找到BOOT-INF\classes\workflow-conf\properties\dbconfig.properties,删horizon.identifier= 的值,重新启动。
重启后,访问页面就会进入重新初始化页面(注:重新初始化要确保数据库里没有工作流的表,否则会初始化失败)
直接连接已有数据库的两种修改方式
- 按照重新初始化的修改方式修改后,进入初始化页面,但是不进行初始化,只修改数据库信息后点击测试连接,数据库信息就自动写入到dbconfig.properties文件里,然后重启服务,就会连接已配置的数据库信息启动。
- 直接修改已生成的dbconfig.properties文件里的数据库配置信息,horizon.identifier一定要有值。修改后重启服务,就会连接已配置的数据库信息启动。
