Chapitre 9. Intégrer Red Hat JBoss BPM Suite dans Red Hat JBoss Fuse

L'intégration de Red Hat JBoss Fuse permet aux utilisateurs de JBoss Fuse de complémenter leur solution d'intégration avec les fonctionnalités supplémentaires fournies par JBoss BPM et JBoss BRMS. L'intégration de Red Hat JBoss BPM Suite est assurée par deux fichiers features.xml : un fichier fournissant des fonctionnalités de base de JBoss BPM Suite et de JBoss BRMS, qui définissent les fonctionnalités d'OSGi pouvant être déployées dans JBoss Fuse et un autre fichier fournissant un support supplémentaires à l'intégration à SwitchYard et Camel.

Note

Pour les utilisateurs de JBoss FUse 6.1, les fonctionnalités de base uniquement de JBoss BPM et de JBoss BRMS fournies dans le fichier de fonctionnalités suivant sont prises en charge. Les clients qui utilisent une ancienne version de ce fichier doivent le mettre à jour.

Important

L’intégration SwitchYard est un aperçu technologique de JBoss Fuse 6.2, et n'est donc pas actuellement prise en charge.
Les fonctionnalités de base de JBoss BPM Suite et de JBoss BRMS sont fournies par 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
Ce fichier de fonctionnalités (et ses référentiels dépendants) est actuellement fourni sous forme de correctif dans Red Hat Customer Portal.
Le tableau suivant donne un exemple de cas d'utilisation de certaines fonctionnalités listées ci-dessus.

Tableau 9.1. Exemples de fonctionnalités et de cas d'utilisation

FonctionnalitéCas d'utilisation
drools-moduleUtiliser le moteur JBoss BRMS pour l'évaluation de règles, sans avoir besoin de tables de décisions, processus ou persistances.
drools-jpaUtiliser le moteur de JBoss BRMS pour l'évaluation de règles de persistance ou de transactions, sans exiger de tables de décision ou de processus. La fonctionnalité drools-jpa contient déjà drools-module, mais vous devrez peut-être également installer la fonctionnalité droolsjbpm-hibernate, ou vous assurer qu'il y ait un package Hibernate compatible installé.
drools-decisiontableUtiliser le moteur JBoss BRMS avec des tables de décision.
jbpmUtiliser JBoss BPM Suite (ou le moteur JBoss BRMS avec les processus). La fonctionnalité jbpm contient déjà drools-module, et drools-jpa. Vous devrez peut-être également installer la fonctionnalité droolsjbpm-hibernate, ou vous assurer qu'il y ait un package Hibernate compatible installé.
jbpm et jbpm-human-taskUtiliser JBoss BPM Suite (ou le moteur JBoss BRMS avec des processus) avec Human Task.
Jars de moteurs de base et kie-ci.Utiliser JBoss BRMS ou JBoss BPM Suite avec KieScanner (KIE-CI) pour télécharger les kJARs d'un référentiel Maven.
kie-springUtiliser l'intégration KIE-Spring.
kie-spring et kie-aries-blueprint.Utiliser l'intégration KIE-Aries-Blueprint.
Les fonctionnalités supplémentaires suivantes pour l'intégration de SwitchYard et Camel dans JBoss Fuse sont fournies par 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
Ce fichier ( et les référentiels dépendants) se situe dans http://repository.jboss.org/nexus/content/repositories/public, qui est déjà configuré pour être utilisé dans JBoss Fuse 6.2 out of the box dans installDir/etc/org.ops4j.pax.url.mvn.cfg.
Le fichier peut également être téléchargé de la page produits de JBoss Fuse 6.2 ou JBoss BPM Suite à partir du portail clients de Red Hat.

9.1. Installer / Mettre à jour les fonctionnalités d'intégration principales

Si vous avez déjà installé une ancienne version des fonctionnalités de base de JBoss BPM Suite et de JBoss BRMS (par exemple, drools-karaf-features-6.2.0.Final-redhat-6-features.xml), vous devrez les supprimer, ainsi que tous les fichiers associés avant d'installer le fichier features.xml plus récent.

Procédure 9.1. Supprimer une installation drools-karaf-features existante

  1. Démarrer la console Fuse par : 
    $ ./installDir/bin/fuse
  2. Retirer l'installation d'anciennes fonctionnalités/apps qui utilisaient l'ancien fichier features.xml. Par exemple : 
    JBossFuse:karaf@root> features:uninstall drools-module
JBossFuse:karaf@root> features:uninstall jbpm
JBossFuse:karaf@root> features:uninstall kie-ci
  3. Chercher des références de lots en utilisant drools/kie/jbpm et les supprimer : 
    list -t 0 -s | grep drools
list -t 0 -s | grep kie
list -t 0 -s | grep jbpm
    Pour supprimer les lots : 
    karaf@root> osgi:uninstall <BUNDLE_ID>
  4. Supprimer l'ancien url drools-karaf-features : 
    karaf@root> features:removeurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-<VERSION>/xml/features
  5. Redémarrer Fuse
  6. Ajouter le fichier de nouvelles fonctionnalités : 
    karaf@root> features:addurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-6-BZ1232486/xml/features
  7. Installer les fonctionnalités : 
    karaf@root> features:install ...
Pour installer drools-karaf-features :

Procédure 9.2. Installer les fonctionnalités de base de JBoss BPM Suite et de JBoss BRMS

  1. Télécharger et Installer le correctif.
    1. Télécharger jboss-brms-6.1.1-BZ-1232486.zip.
    2. Le décompresser.
    3. Naviguer dans le répertoire BZ-1232486.
    4. Exécuter la commande de console suivante : 
      $ 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. Configurer les référentiels demandés
    1. Modifier le fichier installDir/etc/org.ops4j.pax.url.mvn.cfg dans votre installation JBoss Fuse et ajouter la variable org.ops4j.pax.url.mvn.repositories, et notez que les entrées sont séparées par ‘, \’ :
      • http://maven.repository.redhat.com/techpreview/all/@id=bxms-product-repo
  3. Démarrer JBoss Fuse : 
    $ ./installDir/bin/fuse
  4. Ajouter un référence au fichier de fonctionnalités de base en exécutant la commande de console suivante : 
    JBossFuse:karaf@root> features:addurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-6-BZ1232486/xml/features
  5. Vous pouvez installer les fonctionnalités fournies dans ce fichier en exécutant, par exemple, la commande de console suivante : 
    JBossFuse:karaf@root> features:install drools-module