Chapitre 3. Configurations spéciales

3.1. Installation de la Persistance pour Business Central

Red Hat JBoss BPM Suite est configuré pour utiliser un exemple de source de données avec un nom JNDI (Java Naming and Directory Interface) java:jboss/datasources/ExampleDS. Pour Business Central, cet exemple de source de données est situé dans le fichier business-central.war/WEB-INF/classes/META-INF/persistence.xml.
Si vous souhaitez configurer Red Hat JBoss BPM Suite pour utiliser une base de données externe, effectuez les modifications suivantes. Pour le fichier business-central.war/WEB-INF/classes/META-INF/persistence.xml :
  1. Installez le pilote JDBC (Java Database Connectivity) à l'aide d'une approche modulaire pour une configuration facilitée (veuillez consulter EAP 6 documentation).
  2. Créez une nouvelle source de données suivant l'exemple dans la documentation EAP 6, section Exemple de Source de données PostgreSQL. Voici la configuration de source de données spécifique à la base de données H2 utilisée par défaut : 
     <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. Utilisez le nom JNDI de la source de données pour mettre à jour l'entrée suivante à l'intérieur du fichier persistence.xml, qui est par défaut défini sur cette entrée. 
    <jta-data-source>java:jboss/datasources/ExampleDS</jta-data-source>

    Important

    Lors de la configuration de votre source de données, assurez-vous d'activer JTA (en ajoutant jta="true" à la balise datasource).
  4. Remplacez le texte suivant par le nom de dialecte hibernate spécifique à la base de données. 
    <property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect" />
    Par exemple, pour un Oracle Database Express Edition 11g : 
    <property name="hibernate.dialect" value="org.hibernate.dialect.Oracle10gDialect" />

Note

Lorsque Red Hat JBoss BPM Suite utilise Oracle 11 comme source de données, plusieurs messages d'avertissement (WARN) sont produits dans les journaux, sans activité Business Central correspondante effectuée. Cela est normal. Pour désactiver ces messages, définissez le niveau de la catégorie org.hibernate.loader du journal sur ERROR dans le fichier standalone.xml. 
<logger category="org.hibernate.loader">
  <level name="ERROR"/>
</logger>