Chapter 9. Integrating Red Hat JBoss BPM Suite with Red Hat 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. Red Hat JBoss BPM Suite integration is provided by two features.xml files: one providing core JBoss BPM Suite and JBoss BRMS features, which defines the OSGi features that can be deployed into JBoss Fuse, and the other providing additional support for integration with SwitchYard and Camel.

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.

Important

SwitchYard integration is a Technical Preview in JBoss Fuse 6.2, and is therefore not currently supported.
Core JBoss BPM Suite and JBoss BRMS features are provided by jboss-brms-bpmsuite<version>-redhat<version>fuse-features.zip:
  • 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
The following table provides example of use cases for some of the features listed above.

Table 9.1. Features and Use Case Examples

Feature Use Case
drools-module Use the JBoss BRMS engine for rules evaluation, without requiring persistence, processes, or decision tables.
drools-jpa Use the JBoss BRMS engine for rules evaluation with persistence and transactions, but without requiring processes or decision tables. The drools-jpa feature already includes drools-module, however you may also need to install the droolsjbpm-hibernate feature, or ensure there is a compatible hibernate bundle installed.
drools-decisiontable Use the JBoss BRMS engine with decision tables.
jbpm Use the JBoss BPM Suite (or JBoss BRMS engine with processes). The jbpm feature already includes drools-module and drools-jpa. You may also need to install the droolsjbpm-hibernate feature, or ensure that there is a compatible hibernate bundle installed.
jbpm and jbpm-human-task Use the JBoss BPM Suite (or JBoss BRMS engine with processes) with Human Task.
Core engine jars and kie-ci. Use JBoss BRMS or JBoss BPM Suite with KieScanner (KIE-CI) to download kJARs from a Maven repository.
kie-spring Use KIE-Spring integration.
kie-spring and kie-aries-blueprint. Use KIE-Aries-Blueprint integration.
The following additional features for integration with SwitchYard and Camel on JBoss Fuse are provided by the integration pack:
  • 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.
The file can also be downloaded from either the JBoss Fuse 6.2 or JBoss BPM Suite product page in the Red Hat Customer Portal.

9.1. Install/Update Core Integration Features

Note

This section refers to features in the jboss-brms-bpmsuite<version>-redhat<version>fuse-features.zip file. For additional integration features, refer to Section 9.2, “Install Additional Integration Features”.
If you have already installed an older version of the core JBoss BPM Suite and JBoss BRMS features (for example, drools-karaf-features-6.2.0.Final-redhat-6-features.xml), you need to remove them and all associated files before installing the most recent features.xml file.

Procedure 9.1. Removing an Existing drools-karaf-features Installation

  1. Start the Fuse console using: 
    $ ./installDir/bin/fuse
  2. Unistall old features/apps that used the previous features.xml file. For example: 
    JBossFuse:karaf@root> features:uninstall drools-module
JBossFuse:karaf@root> features:uninstall jbpm
JBossFuse:karaf@root> features:uninstall kie-ci
  3. Search for references of bundles using drools/kie/jbpm and remove them: 
    list -t 0 -s | grep drools
list -t 0 -s | grep kie
list -t 0 -s | grep jbpm
    To remove the bundles: 
    karaf@root> osgi:uninstall <BUNDLE_ID>
  4. Remove the old drools-karaf-features url: 
    karaf@root> features:removeurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-<old-version>/xml/features
  5. Restart Fuse
To install the drools-karaf-features:

Procedure 9.2.  Install core JBoss BPM Suite and JBoss BRMS features

  1. Configure required repositories
    1. Edit the installDir/etc/org.ops4j.pax.url.mvn.cfg file in your JBoss Fuse installation and add the following entry to the org.ops4j.pax.url.mvn.repositories variable, noting that entries are separated by ‘, \’:
      • http://maven.repository.redhat.com/ga/@id=bxms-product-repo
  2. Start JBoss Fuse: 
    $ ./installDir/bin/fuse
  3. 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-<version>/xml/features
  4. 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