Capítulo 3. Configurações Especiais

3.1. Configurando Persistências para o Business Central

O Red Hat JBoss BPM Suite é configurado para usar uma fonte de dados de exemplo com o nome JNDI (Java Naming and Directory Interface) java:jboss/datasources/ExampleDS. Para o Business Central, essa fonte de dados de exemplo está localizada no arquivo business-central.war/WEB-INF/classes/META-INF/persistence.xml.
Caso deseje configurar o Red Hat JBoss BPM Suite para usar um banco de dados externo, realize as mudanças a seguir. Para o arquivo business-central.war/WEB-INF/classes/META-INF/persistence.xml:
  1. Instale o respectivo driver JDBC (Java Database Connectivity) usando a abordagem modular para facilitar as configurações subsequentes (consulte a documentação do EAP 6).
  2. Crie uma nova fonte de dados segundo o exemplo na documentação do EAP 6, na seção Exemplo da Fonte de Dados PostgreSQL. Essa é a configuração padrão usada da fonte de dados específica do banco de dados H2: 
     <subsystem xmlns="urn:jboss:domain:datasources:1.1">
         <datasources>
            <datasource jndi-name="java:jboss/datasources/ExampleDS" pool-name="ExampleDS" enabled="true" use-java-context="true">
               <connection-url>jdbc:h2:mem:test;DB_CLOSE_DELAY=-1</connection-url>
               <driver>h2</driver>
               <security>
                  <user-name>sa</user-name>
                  <password>sa</password>
               </security>
            </datasource>
            <drivers>
               <driver name="h2" module="com.h2database.h2">
                  <xa-datasource-class>org.h2.jdbcx.JdbcDataSource</xa-datasource-class>
               </driver>
            </drivers>
         </datasources>
  3. Use o nome JNDI da fonte de dados para atualizar a seguinte entrada dentro do arquivo persistence.xml, o qual é definido por padrão nessa entrada. 
    <jta-data-source>java:jboss/datasources/ExampleDS</jta-data-source>

    Importante

    Quando estiver configurando a sua fonte de dados, certifique-se de habilitar o JTA (geralmente, adicionando jta="true" à tag datasource).
  4. Substitua o texto a seguir pelo nome apropriado do dialeto do hibernate específico do banco de dados. 
    <property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect" />
    Por exemplo, para um Oracle Database Express Edition 11g, o nome ficaria: 
    <property name="hibernate.dialect" value="org.hibernate.dialect.Oracle10gDialect" />

Nota

Quando o Red Hat JBoss BPM Suite utiliza o Oracle 11 como a fonte de dados, múltiplas mensagens de aviso (WARN) são produzidas nos logs, sem que qualquer atividade correspondente ao Business Central esteja sendo realizada. Esse é o comportamento esperado. Para desabilitar essas mensagens, defina o nível da categoria org.hibernate.loader do agente como ERROR no arquivo standalone.xml: 
<logger category="org.hibernate.loader">
  <level name="ERROR"/>
</logger>