JBPM之安装配置_JAVA_程序员俱乐部

您所在的位置：程序员俱乐部 > 编程开发 > JAVA > JBPM之安装配置

JBPM之安装配置

2014/4/22 12:18:43 actuutuu 程序员俱乐部我要评论(0)

摘要：第2章安装配置2.1.发布只需要把jBPM(jbpm-4.X.zip)下载下来，然后解压到你的硬盘上的什么地方。你将看到下面的子目录：doc:用户手册，javadoc和开发指南examples:用户手册中用到的示例流程install:用于不同环境的安装脚本lib:第三方库和一些特定的jBPM依赖库src:源代码文件jbpm.jar:jBPM主库归档migration:参考开发指南2.2.必须安装的软件jBPM需要JDK（标准java）5或更高版本。http://java.sun
标签：安装配置 BPM

class="title" style="font-weight: 500; margin-top: 10px; padding-top: 15px; font-size: 22px;">第?2?章?安装配置

2.1.?发布

只需要把jBPM (jbpm-4.X.zip) 下载下来，然后解压到你的硬盘上的什么地方。你将看到下面的子目录：

doc: 用户手册，javadoc和开发指南
examples: 用户手册中用到的示例流程
install: 用于不同环境的安装脚本
lib: 第三方库和一些特定的jBPM依赖库
src: 源代码文件
jbpm.jar: jBPM主库归档
migration: 参考开发指南

2.2.?必须安装的软件

jBPM需要JDK （标准java）5或更高版本。

http://java.sun.com/javase/downloads/index.jsp

为了执行ant脚本，你需要1.7.0或更高版本的apache ant：

http://ant.apache.org/bindownload.cgi

2.3.?快速上手

这个范例安装是最简单的方式开始使用jBPM。这一章介绍了完成范例安装的步骤。

如果你之前下载过jboss-5.0.0.GA.zip，你可以把它放到?${jbpm.home}/install/downloads目录下。否则脚本会为你下载它，但是它会消耗一些时间（与你的网络情况有关）。 eclipse-jee-galileo-win32.zip也一样（或者eclipse-jee-galileo-linux-gtk(-x86_64).tar.gz在linux平台下和eclipse-jee-galileo-macosx-carbon.tar.gz在Mac OSX平台下）。

打开命令控制台，进入目录${jbpm.home}/install。然后运行

ant demo.setup.jboss

或者

ant demo.setup.tomcat

这将

把JBoss安装到${jbpm.home}/jboss-5.0.0.GA目录
把jBPM安装到JBoss中。
安装hsqldb，并在后台启动。
创建数据库结构
在后台启动JBoss
根据示例创建一个examples.bar业务归档，把它发布到jBPM数据库中
从${jbpm.home}/install/src/demo/example.identities.sql，读取用户和组。
安装eclipse到${jbpm.home}/eclipse
启动eclipse
安装jBPM web控制台
安装Signavio web建模器

当这些都完成后，JBoss（或Tomcat，根据demo.setup脚本中的选择）会在后台启动。一旦eclipse完成启动，你可以继续执行下面的教程?第?3?章?流程设计器（GPD）来开始编码你的jBPM业务流程。

或者你可以启动建模流程，通过?Signavio web设计器。

或者使用jBPM控制台。你可以使用下面用户之一进行登陆：

表?2.1.?示例控制台用户：

用户名密码 alex password mike password peter password mary password
break">

目前存在的问题：现在，对于一些比较慢的机器，在初始化报表时，控制台的失效时间太短了，所以当你第一次请求报表时，会出现超时，控制台会崩溃。注销，然后再次登录，就可以避过这个问题。这个问题已经提交到JIRA中了?JBPM-2508

2.4.?安装脚本

jBPM下载包中包含了一个install目录，目录中有一个ant的build.xml文件，你可以使用它来把jBPM安装到你的应用环境中。

最好严格按照这些安装脚本，进行安装和发布jBPM配置文件。我们可以自定义jBPM配置文件，但这是不被支持的。

要想调用安装脚本，打开命令行，进入${jbpm.home}/install目录。使用ant -p你可以看到这里可以使用的所有脚本。脚本的参数都设置了默认值，可以快速执行，下面列表给出了可用脚本的概况：

demo.setup.jboss：安装jboss，把jbpm安装到jboss中，启动jboss，创建jbpm数据库表结构，部署实例，加载实例身份认证信息，安装并启动eclipse
demo.setup.tomcat：安装tomcat，把jboss安装到tomcat中，启动tomcat，创建jbpm数据库表结构，部署实例，加载实例身份认证信息，安装并启动eclipse
clean.cfg.dir：删除${jbpm.home}/install/generated/cfg?文件夹。
create.cfg：创建一个配置在?${jbpm.home}/install/generated/cfg下，基于当前的参数。
create.jbpm.schema：在数据库中创建jbpm表
create.user.webapp创建一个基本的webapp在?${jbpm.home}/install/generated/user-webapp中
delete.jboss：删除安装的jboss
delete.tomcat：删除安装的Tomcat
demo.teardown.jboss：删除jbpm数据库的表并停止jboss
demo.teardown.tomcat：停止tomcat和hsqldb服务器（如果需要）
drop.jbpm.schema：从数据库中删除jbpm的表
get.eclipse：下载eclipse如果它不存在
get.jboss：下载一个JBoss AS，已经测试过当前的jBPM版本，如果它不存在
get.tomcat：下载一个Tomcat，已经测试过当前的jBPM版本，如果它不存在
hsqldb.databasemanager：启动hsqldb数据库管理器
install.eclipse：解压eclipse，下载eclipse如果它不存在
install.jboss：下载JBoss如果它不存在，并解压
install.jbpm.into.jboss：把jBPM安装到JBoss中
install.tomcat：把tomcat下载到${tomcat.distro.dir}如果tomcat不存在，并解压tomcat
install.jbpm.into.tomcat：把jBPM安装到tomcat中
install.examples.into.tomcat：部署所有的实例流程
install.signavio.into.jboss：把signavio安装到jboss中
install.signavio.into.tomcat把signavio安装到tomcat中
load.example.identities：读取实例用户和用户组数据到数据库
reinstall.jboss：删除之前的jboss安装，并重新安装jboss
reinstall.jboss.and.jbpm：删除之前的jboss安装，并重新安装jboss并把jbpm安装到它里面
reinstall.tomcat：删除之前的tomcat安装，并重新安装tomcat
reinstall.tomcat.and.jbpm：删除之前的tomcat安装，并重新安装tomcat并把jbpm安装到它里面
start.eclipse：启动eclipse
start.jboss：启动jboss，等待到jboss启动完，然后让jboss在后台运行
start.tomcat：启动Tomcat，等待到Tomcat启动完，然后让Tomcat在后台运行
stop.jboss：通知jboss停止，但是不等到它完成
stop.tomcat通知Tomcat停止，但是不等到它完成
upgrade.jbpm.schema：更新数据库中的jBPM表到当前版本

要想指定你的配置文件，使用上面的脚本（比如DB表结构生成），最简单的方法是修改对应的配置文件，在目录${jbpm.home}/install/jdbc。对应的配置文件会被脚本加载，根据对应的DB。

下面的参数也可以自定义。

database?: 默认值是hsqldb。可选值为mysql,?oracle和postgresql
jboss.version?: 默认值是5.0.0.GA。可选值是5.1.0.GA

如果想要自定义这些值，只需要像这样使用-D

ant -Ddatabase=postgresql demo.setup.jboss

作为可选方案，你可以在${user.home}/.jbpm4/build.properties?中设置自定义的参数值

2.5.?依赖库和配置文件

我们提供了自动安装jBPM的ant脚本。这些脚本会将正确的依赖库和正确的配置文件为你安装到正确的位置。如果你想在你的应用中创建自己的jBPM，可以参考开发指南获得更多信息。

2.6.?JBoss

install.jbpm.into.jboss任务会把jBPM安装到你的JBoss 5中。进入安装目录下，执行ant -p可以获得更多信息。这个安装脚本会把jBPM安装为一个JBoss的服务，因此所有应用都可以使用同一个jBPM的流程引擎。

可以指定-Djboss.home=PathToYourJBossInstallation?来修改你的JBoss的安装路径。

在JBoss中，ProcessEngine可以通过JNDI获得，?new InitialContext().lookup("java:/ProcessEngine")，相同的流程引擎可以通过Configuration.getProcessEngine()获得。

2.7.?Tomcat

install.jbpm.into.tomcat任务会把jBPM安装到你的Tomcat中。

2.8.?Signavio基于web的流程编辑器

使用install.signavio.into.jboss和?install.signavio.into.tomcat任务可以将Signavio基于web 的流程编辑器安装到JBoss或Tomcat中。

2.9.?用户web应用

如果你希望把jBPM部署为你的web应用的一部分，可以使用?create.user.webapp这个安装任务。这会创建一个包含jBPM的web应用，在${jbpm.home}/install/generated/user-webapp目录下。

如果你在JBoss上或其他包含jta.jar的应用服务器上部署了你的应用，你需要把${jbpm.home}/install/generated/user-webapp/WEB-INF/lib/jta.jar删除。

2.10.?数据库

安装脚本也包含了执行数据库的操作比如创建表，如果你是第一次安装jBPM，或者更新数据库使用之前版本的表结构。删除表也是可选的。

使用任何数据库操作的前提条件是在${jbpm.home}/install/jdbc中指定你的连接参数。

2.10.1.?创建或删除表结构

要想创建表结构，执行create.jbpm.schema任务在${jbpm.home}/install目录下。作为创建表、约束的一部分，涉及的任务会初始化?JBPM4_PROPERTY表，使用当前的引擎版本（key?db.version）和ID生成器版本（keynext.dbid）。

要想删除表结构，只要执行drop.jbpm.schema任务。注意这个操作会删除jBPM表中的所有数据。

2.10.2.?更新已存在的数据库

要想更新，执行upgrade.jbpm.schema任务在${jbpm.home}/install目录下。

更新是一个两步操作。前一步是添加额外的表，列或者约束这些是在新版本中的。下一步，插入种子数据。

从4.0到4.1，表JBPM4_VARIABLE添加了一个新列?CLASSNAME_用来支持设置流程变量的值的自定义类型，hibernate的类型映射。这个列是可为null的，因为这个功能在4.0中没有支持，所以没有初始值。

从4.1到4.2，更新过程更有趣一些。

一个新表?JBPM4_PROPERTY?被用来保存引擎范围的数据。
jBPM版本保存在JBPM4_PROPERTY表中使用key?db.version用来在未来发布中精确指定标示符。
ID生成策略是完全跨数据库的。下一个有效的ID是通过搜索所有包含主键列的表计算出的，保存在key?next.dbid中在JBPM4_PROPERTY表中。
流程语言设置为jpdl-4.0?用于所有已经存在的流程定义，对应key?langid?在表JBPM4_DEPLOYPROP中。jPDL解析器对应?langid属性来读取流程文档以此支持向后的兼容。