Chapter 8. Integrating JBoss BRMS and JBoss BPM Suite with JBoss Fuse
Red Hat JBoss Fuse integration allows users of JBoss Fuse to complement their integration solution with additional features provided by JBoss BPM Suite and JBoss BRMS. Integration is provided by two
features.xml files: one providing core JBoss BPM Suite and JBoss BRMS features, and the other providing additional support for integration with SwitchYard and Camel.
Important
SwitchYard integration is a Technical Preview in JBoss Fuse 6.2, and is therefore not currently supported.
Note
For users of JBoss Fuse 6.1, only the core JBoss BPM Suite and JBoss BRMS features, provided by the following features file, are supported. Customers who are using an earlier version of this file must update it.
Core JBoss BPM Suite and JBoss BRMS features are provided by
drools-karaf-features-6.2.0.Final-redhat-6-BZ1232486-features.xml:
- drools-common
- drools-module
- drools-templates
- drools-decisiontable
- drools-jpa
- kie
- kie-ci
- kie-spring
- kie-aries-blueprint
- jbpm-commons
- jbpm-human-task
- jbpm
- droolsjbpm-hibernate
- h2
This features file (and supporting repositories) is currently provided as a patch —
Integration Pack contains references related to non-supported jars — that you can download from the Red Hat Customer Portal under JBoss BRMS or JBoss BPM Suite.
The following table lists some sample use cases and the corresponding features that are required to support them.
| Use Case | Feature(s) |
|---|---|
| I need to use Drools engine for rules evaluation. I do not need persistence, processes, nor decision tables. | Install drools-module. |
| I need to use Drools engine for rules evaluation with persistence and transactions. I do not need processes, nor decision tables. | Install drools-jpa (which includes drools-module). You might also want to install the droolsjbpm-hibernate feature, or ensure there is a compatible hibernate bundle installed. |
| I need to use Drools engine with decision tables. | Install drools-decisiontable (which includes drools-module). If you need persistence, install drools-jpa as well. |
| I need to use jBPM engine (or Drools engine with processes). | Install jbpm feature (which includes drools-module and drools-jpa). You might also want to install droolsjbpm-hibernate feature, or ensure there is a compatible hibernate bundle installed. |
| I need to use jBPM engine (or Drools engine with processes) with Human Task. | Install jbpm and jbpm-human-task. |
| I need to use Drools/jBPM with KieScanner (KIE-CI) to be able to download kJARs from a Maven repository. | Install required core engine jars (see row above) and kie-ci. |
| I need to use KIE-Spring integration. | Install kie-spring. |
| I need to use KIE-Aries-Blueprint integration. | Install kie-spring and kie-aries-blueprint. |
The following additional features for integration with SwitchYard and Camel on JBoss Fuse are provided by
org/jboss/integration/fuse/karaf-features/1.0.0.redhat-620137/karaf-features-1.0.0.redhat-620137-features.xml:
- fuse-bxms-switchyard-common-knowledge
- fuse-bxms-switchyard-rules
- fuse-bxms-switchyard-bpm
- kie-camel
- jbpm-workitems-camel
This file (and supporting repositories) is located in http://repository.jboss.org/nexus/content/repositories/public/ which is already configured for use on JBoss Fuse 6.2 out of the box in
installDir/etc/org.ops4j.pax.url.mvn.cfg.
8.1. Install Core JBoss BRMS and JBoss BPM Suite Features
Use the following procedure to add core features for JBoss BRMS and JBPM Suite.
Procedure 8.1.
- The lastest supported version of these features are provided as a patch —
Integration Pack contains references related to non-supported jars— that you can download from the Red Hat Customer Portal under JBoss BRMS or JBoss BPM Suite. Download and install this patch.- Download the patch and unzip it.
- Navigate to the unzipped
BZ-1232486directory. - Run the following console command:
$ mvn org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file -Dfile=drools-karaf-features-6.2.0.Final-redhat-6-BZ1232486-features.xml -DgroupId=org.drools -DartifactId=drools-karaf-features -Dversion=6.2.0.Final-redhat-6-BZ1232486 -Dpackaging=xml -Dclassifier=features
- Configure the required repositories.
- Edit the
installDir/etc/org.ops4j.pax.url.mvn.cfgfile in your JBoss Fuse installation and add the following entry to theorg.ops4j.pax.url.mvn.repositoriesvariable, noting that entries are separated by ‘, \’:- http://maven.repository.redhat.com/techpreview/all/@id=bxms-product-repo
- Start JBoss Fuse:
$ ./installDir/bin/fuse
- Add a reference to the core features file by running the following console command:
JBossFuse:karaf@root> features:addurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-6-BZ1232486/xml/features
- You can now install the features provided by this file by running, for example, the following console command:
JBossFuse:karaf@root> features:install drools-module
