Capítulo 9. Integrando o Red Hat JBoss BPM Suite ao Red Hat JBoss Fuse

A integração do Red Hat JBoss Fuse permite que os usuários do JBoss Fuse complementem a sua solução de integração com os recursos adicionais fornecidos pelo JBoss BPM Suite e JBoss BRMS. A integração do Red Hat JBoss BPM Suite é fornecida por dois arquivos features.xml: um fornecendo os recursos principais do JBoss BPM Suite e JBoss BRMS, o qual define os recursos OSGi que podem ser implantados no JBoss Fuse, e o outro fornecendo um suporte adicional à integração ao SwitchYard e Camel.

Nota

Para os usuários do JBoss Fuse 6.1, apenas os recursos principais do JBoss BPM Suite e JBoss BRMS, fornecidos pelo arquivo de recursos a seguir, possuem suporte. Os clientes que estão usando uma versão mais antiga desse arquivo devem atualizá-lo.

Importante

A integração do SwitchYard é uma Visualização Técnica no JBoss Fuse 6.2 e, portanto, não possui suporte atualmente.
Os recursos principais do JBoss BPM Suite e JBoss BRMS são fornecidos pelo 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
Esse arquivo de recursos (e repositórios de suporte) é fornecido atualmente como uma correção no Portal do Consumidor Red Hat.
A tabela a seguir fornece exemplos de casos de uso para alguns dos recursos listados acima.

Tabela 9.1. Exemplos de Casos de Uso e Recursos

RecursoCaso de Uso
drools-moduleUsa o mecanismo JBoss BRMS para a avaliação de regras, sem necessidade de persistências, processos ou tabelas de decisão.
drools-jpaUsa o mecanismo JBoss BRMS para a avaliação de regras com persistências e transações mas, sem necessidade de processos ou tabelas de decisão. O recurso drools-jpa já inclui drools-module, no entanto você também pode precisar de instalar o recurso droolsjbpm-hibernate ou verificar se um pacote Hibernate compatível foi instalado.
drools-decisiontableUsa o mecanismo JBoss BRMS com tabelas de decisão.
jbpmUsa o JBoss BPM Suite (ou o mecanismo JBoss BRMS com processos). O recurso jbpm já inclui drools-module e drools-jpa. Você também pode precisar de instalar o recurso droolsjbpm-hibernate ou verificar se um pacote Hibernate compatível foi instalado.
jbpm e jbpm-human-taskUsa o JBoss BPM Suite (ou o mecanismo JBoss BRMS com processos) com Tarefas Humanas.
mecanismos principais jars e kie-ci. Usa o JBoss BRMS ou JBoss BPM Suite com KieScanner (KIE-CI) para baixar kJARs de um repositório do Maven.
kie-springUsa a integração do KIE-Spring.
kie-spring e kie-aries-blueprint.Usa a integração do KIE-Aries-Blueprint.
Os recursos adicionais a seguir para a integração do SwitchYard e Camel ao JBoss Fuse são fornecidos pelo 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
Esse arquivo (e os repositórios de suporte) está localizado em http://repository.jboss.org/nexus/content/repositories/public e já possui uma configuração pronta para uso no JBoss Fuse 6.2 em installDir/etc/org.ops4j.pax.url.mvn.cfg.
O arquivo tembém pode ser baixado a partir do JBoss Fuse 6.2 ou da página do produto JBoss BPM Suite no Portal do Consumidor Red Hat.

9.1. Instale/ Atualize os Recursos Principais de Integração

Caso você já tenha instalado uma versão mais antiga dos recursos principais do JBoss BPM Suite e JBoss BRMS (por exemplo, drools-karaf-features-6.2.0.Final-redhat-6-features.xml), você precisará removê-los assim como todos os seus arquivos associados antes de instalar o arquivo mais recente features.xml.

Procedimento 9.1. Removendo uma Instalação drools-karaf-features Existente

  1. Inicie o console Fuse usando: 
    $ ./installDir/bin/fuse
  2. Desinstale recursos/ aplicativos antigos que usavam o arquivo features.xml anterior. Por exemplo: 
    JBossFuse:karaf@root> features:uninstall drools-module
JBossFuse:karaf@root> features:uninstall jbpm
JBossFuse:karaf@root> features:uninstall kie-ci
  3. Pesquise por referências de pacotes usando drools/kie/jbpm e remova-as: 
    list -t 0 -s | grep drools
list -t 0 -s | grep kie
list -t 0 -s | grep jbpm
    Para remover os pacotes: 
    karaf@root> osgi:uninstall <BUNDLE_ID>
  4. Remova o url drools-karaf-features antigo: 
    karaf@root> features:removeurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-<VERSION>/xml/features
  5. Reinicie Fuse
  6. Adicione o novo arquivo de recursos: 
    karaf@root> features:addurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-6-BZ1232486/xml/features
  7. Instale os recursos: 
    karaf@root> features:install ...
Para instalar drools-karaf-features:

Procedimento 9.2. Instale os recursos principais do JBoss BPM Suite e JBoss BRMS

  1. Baixe e instale a correção.
    1. Baixe jboss-brms-6.1.1-BZ-1232486.zip.
    2. Descompacte-o.
    3. Navegue até o diretório BZ-1232486 descompactado.
    4. Execute o seguinte comando de console: 
      $ 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 os repositórios necessários:
    1. Edite o arquivo installDir/etc/org.ops4j.pax.url.mvn.cfg na sua instalação do JBoss Fuse e adicione a seguinte entrada à variável org.ops4j.pax.url.mvn.repositories, observe que as entradas são separadas por ‘, \’:
      • http://maven.repository.redhat.com/techpreview/all/@id=bxms-product-repo
  3. Inicie o JBoss Fuse: 
    $ ./installDir/bin/fuse
  4. Adicione uma referência ao arquivo dos recursos principais executando o seguinte comando de console: 
    JBossFuse:karaf@root> features:addurl mvn:org.drools/drools-karaf-features/6.2.0.Final-redhat-6-BZ1232486/xml/features
  5. Você pode instalar, agora, os recursos fornecidos por este arquivo executando, por exemplo, o seguinte comando de console: 
    JBossFuse:karaf@root> features:install drools-module