Capítulo 9. Integración de Red Hat JBoss BPM Suite con Red Hat JBoss Fuse

La integración de Red Hat JBoss Fuse permite a los usuarios de JBoss Fuse complementar su solución de integración con funcionalidades provistas por JBoss BPM Suite y JBoss BRMS. La integración Red Hat JBoss BPM Suite consta de dos archivos features.xml: uno provisto por funcionalidades principales de JBoss BPM Suite y JBoss BRMS, las cuales definen las funcionalidades OSGi que pueden implementarse en JBoss Fuse, y otro que provee soporte adicional para la integración con SwitchYard y Camel.

Nota

Para los usuarios de Jboss Fuse 6.1, solamente las funcionalidades principales de JBoss BPM Suite and JBoss BRMS, provistas por el siguiente archivo, reciben soporte. Los clientes que utilizan una versión anterior de este archivo deben actualizarlo.

Importante

La integración de SwitchYard es una muestra de tecnología en JBoss Fuse 6.2, y por lo tanto no recibe soporte.
drools-karaf-features-6.2.0.Final-redhat-6-BZ1232486-features.xml provee las funcionalidades principales de JBoss BPM Suite y JBoss BRMS.
  • 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
Este archivo de funcionalidades (y los repositorios que lo soportan) se provee como un correctivo en Red Hat Customer Portal.
La siguiente tabla provee ejemplos de casos de uso para algunas de las funcionalidades listadas arriba:

Tabla 9.1. Funcionalidades y ejemplos de caso de uso

FuncionalidadCaso de uso
drools-moduleUse el motor JBoss BRMS para evaluación de reglas, sin requerir persistencia, procesos o tablas de decisión.
drools-jpaUse el motor JBoss BRMS para evaluación de reglas con persistencia y transacciones, pero sin las tablas de procesos o decisión. La funcionalidad drools-jpa ya existe incluye drools-module, sin embargo necesitará instalar la funcionalidad droolsjbpm-hibernate o verificar si está instalado un paquete Hibernate compatible.
drools-decisiontableUse el motor JBoss BRMS con tablas de decisión.
jbpmUse el motor JBoss BPM Suite (o el motor JBoss BRMS con procesos). La funcionalidad drools-jpa ya incluye drools-module drools-jpa. Usted deberá instalar la funcionalidad droolsjbpm-hibernate o verificar si está instalado un paquete Hibernate compatible.
jbpm and jbpm-human-taskUse the JBoss BPM Suite (o el motor JBoss BRMS con procesos) con Human Task..
Jars de motor de base y kie-ci.Use JBoss BRMS o JBoss BPM Suite con KieScanner (KIE-CI) para descargar los kJAR desde el repositorio Maven.
kie-springUse integración KIE-Spring.
kie-spring and kie-aries-blueprint.Use KIE-Aries-Blueprint integration.
Las siguientes funcionalidades adicionales para integración con SwitchYard y Camelon en JBoss Fuse son provistas por 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
Este archivo (y los repositorios que lo soportan) se encuentra en http://repository.jboss.org/nexus/content/repositories/public, el cual ya está configurado para se utilizado en JBoss Fuse 6.2 listo para utilizar en installDir/etc/org.ops4j.pax.url.mvn.cfg.
Este archivo también puede descargarse desde la página del producto JBoss Fuse 6.2 o JBoss BPM Suite en el Portal del cliente de Red Hat.

9.1. Instalación y actualización de funcionalidades de integración de base

Si ya tiene instada una versión anterior de las funcionalidades principales de JBoss BPM Suite y JBoss BRMS(por ejemplo, drools-karaf-features-6.2.0.Final-redhat-6-features.xml), necesita retirarlas y asociar los archivos antes de intalar el archivo features.xml más reciente.

Procedimiento 9.1. Retiro de una instalación drools-karaf-features

  1. Inicie la consola Fuse mediante: 
    $ ./installDir/bin/fuse
  2. Desinstale las funcionalidades anteriores o apps que utilizó en el archivo features.xml anterior. Por ejemplo: 
    JBossFuse:karaf@root> features:uninstall drools-module
JBossFuse:karaf@root> features:uninstall jbpm
JBossFuse:karaf@root> features:uninstall kie-ci
  3. Busque referencias de lotes utilizando drools/kie/jbpm y retírelos: 
    list -t 0 -s | grep drools
list -t 0 -s | grep kie
list -t 0 -s | grep jbpm
    Para retirar los lotes: 
    karaf@root> osgi:uninstall <BUNDLE_ID>
  4. Remueva la url drools-karaf-features anterior: 
    karaf@root> features:removeurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-<VERSION>/xml/features
  5. Reinicie Fuse
  6. Agregue el archivo de nuevas funcionalidades 
    karaf@root> features:addurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-6-BZ1232486/xml/features
  7. Instale las funcionalidades: 
    karaf@root> features:install ...
Para instalar drools-karaf-features:

Procedimiento 9.2. Instale las funcionalidades principales de JBoss BPM Suite y JBoss BRMS

  1. Descargue e instale la corrección.
    1. Descargue jboss-brms-6.1.1-BZ-1232486.zip.
    2. Descomprímalo.
    3. Navegue al directorio descomprimido BZ-1232486.
    4. Ejecute el siguiente comando de consola: 
      $ 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
  2. Configure los repositorios requeridos
    1. Modifique el archivo installDir/etc/org.ops4j.pax.url.mvn.cfg en su instalación JBoss Fuse y agregue la siguiente entrada a la variable org.ops4j.pax.url.mvn.repositories, tenga en cuenta que las entradas deben ir separadas por ‘, \’:
      • http://maven.repository.redhat.com/techpreview/all/@id=bxms-product-repo
  3. Inicie JBoss Fuse: 
    $ ./installDir/bin/fuse
  4. Agregue una referencia al archivo de funcionalidades de base al ejecutar el siguiente comando de consola: 
    JBossFuse:karaf@root> features:addurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-6-BZ1232486/xml/features
  5. Ahora podrá instalar las funcionalidades provistas por este archivo al ejecutar, por ejemplo, el siguiente comando de consola: 
    JBossFuse:karaf@root> features:install drools-module