Skip to content

单机部署

1 概述

本文档中操作的示例: JDK 1.8、Mysql5.7数据库

不同操作系统步骤及命令一样。

【注】 提供的产品包默认为JDK11以下的,所以要求JDK1.6及以上版本,JDK11以下,推荐使用1.8。 如需要使用JDK17,需单独申请JDK17的产品包。

2 数据库准备

Mysql数据库:修改数据库配置信息不区分大小写。

使用数据库工具创建一个新的数据库,后边初始化数据库需要使用,字符集utf8。

【注】 产品jar包默认只有mysql5、oracle、达梦的驱动包

mysql8或其他数据库需要单独增加数据库驱动,参考 JAR包部署:修改数据库驱动文件的办法

3 启动服务

将jar包拷贝到安装目录下(注意不能含有中文),在DOS模式下进入安装目录所在的文件夹。

执行命令:java -jar <jar包名>(需要根据实际文件名进行调整)。

执行命令后,后台会自动启动内嵌的Tomcat中间件服务器,所以不需要自己准备Tomcat。

启动命令示例:java -jar horizon-workflow-boot-8.2.jar

img.png

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

img_1.png

4 访问服务

启动成功后,在浏览器中访问工作流,可以通过IP地址,也可以通过localhost。

例如本文访问:http://localhost:8080/horizon-workflow-boot

产品配置文件中默认的端口号:8080

上下文地址:horizon-workflow-boot

从后台日志输出,也可以找到端口号和上下文的信息:

img_2.png

访问成功后,出现以下界面:

img_3.png

  1. 数据库类型选择:Mysql
  2. 修改数据库连接地址中的ip、端口、数据库名称。
  3. 修改数据库名称、密码。
  4. 信息填写成功后,执行"测试链接"。

如果执行测试链接失败,需要确认以下信息是否正常,结合后台日志分析问题:

  • 网络情况。应用所在服务器与数据库所在服务器网络连接情况、应用服务器能不能连通mysql的端口号
  • 数据库链接信息、数据库名称、密码。
  • 驱动版本
  1. 测试链接通过后,执行"初始化",等待"初始化"成功提示。

如果报错,可参考此处排查原因: 部署报错常见问题(测试链接数据库异常、初始化失败)

5 上传License

初始化成功后,系统会自动跳转到上传License界面,系统给出License编码,请将编码发给软件提供商。

获取license文件后,点击上传按钮,完成系统License上传。

img_4.png

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

img_5.png

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)
  • 如果没有值:

想要重新初始化的两种修改方式

  1. 删除磁盘里的workflow\properties\dbconfig.properties中horizon.identifier= 的值,重新启动。
  2. 删除磁盘里的workflow\properties\dbconfig.properties文件,在jar包里找到BOOT-INF\classes\workflow-conf\properties\dbconfig.properties,删horizon.identifier= 的值,重新启动。

重启后,访问页面就会进入重新初始化页面(注:重新初始化要确保数据库里没有工作流的表,否则会初始化失败)

直接连接已有数据库的两种修改方式

  1. 按照重新初始化的修改方式修改后,进入初始化页面,但是不进行初始化,只修改数据库信息后点击测试连接,数据库信息就自动写入到dbconfig.properties文件里,然后重启服务,就会连接已配置的数据库信息启动。
  2. 直接修改已生成的dbconfig.properties文件里的数据库配置信息,horizon.identifier一定要有值。修改后重启服务,就会连接已配置的数据库信息启动。