2.2. La instalación agrupada genérica implementable

Instale el gestor de transacciones.

Instale el controlador en su base de datos

<Listener className="bitronix.tm.integration.tomcat55.BTMLifecycleListener" />

CATALINA_OPTS="-Xmx512M -XX:MaxPermSize=512m -Djava.security.auth.login.config=$CATALINA_HOME/webapps/business-central/WEB-INF/classes/login.config -Dbtm.root=$CATALINA_HOME -Dbitronix.tm.configuration=$CATALINA_HOME/conf/btm-config.properties -Dorg.jbpm.designer.perspective=RuleFlow -Djbpm.tsr.jndi.lookup=java:comp/env/TransactionSynchronizationRegistry"

set "CATALINA_OPTS=-Xmx512M -XX:MaxPermSize=512m -Dbtm.root=C:/Tomcat -Dbitronix.tm.configuration=C:/Tomcat/conf/btm-config.properties -Dorg.jbpm.designer.perspective=RuleFlow"

1. Defina los usuarios y roles en $TOMCAT_DIR/conf/tomcat-users.xml. Note que la central empresarial requiere que los usuarios tengan los roles especificados como admin y/o analyst (fpara más información sobre definiciones de roles y usuarios consulte la documentación de Tomcat 7).
   El programa listado a continuación muestra un ejemplo de cómo se agregarían estos dos roles y se le asignarán estos roles al usuario llamado bpmsadmin.

   Nota

   Asegúrese de que los nombres de usuario no estén en conflicto con los roles conocidos. Por ejemplo, no debe crear un usuario con el nombre de usuario admin.

     <role rolename="admin"/>
     <role rolename="analyst" />
     <user username="bpmsadmin" password="P@ssw0rd" roles="admin,analyst"/>
   

2. Desplace (no copie) kie-tomcat-integration-VERSION.jar de $TOMCAT_DIR/webapps/business-central/WEB-INF/lib/ a $TOMCAT_DIR/lib/.
3. Copie jboss-jaxb-api-VERSION.jar from $TOMCAT_DIR/webapps/business-central/WEB-INF/lib/ en $TOMCAT_DIR/lib/.
4. En $TOMCAT_DIR/conf/server.xml agregue la declaración de válvula Tomcat en el elemento relevante <host>:

   <Valve className="org.kie.integration.tomcat.JACCValve" />

1. En business-central/META-INF/context.xml reemplace el nombre JNDI de la fuente de datos en el elemento <Resource>. El atributo uniqueName se refiere a la propiedad resource.ds1.uniqueName establecida en resources.properties:

   <Resource name="jdbc/myDatasource" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource"/>

2. En business-central/WEB-INF/web.xml remplace el nombre JNDI de la fuente de datos en el elemento <res-ref-name> con su nombre de fuente de datos:

   <resource-ref>
           <description>Console DS</description>
           <res-ref-name>jdbc/myDatasource</res-ref-name>
           <res-type>javax.sql.DataSource</res-type>
           <res-auth>Container</res-auth>
   </resource-ref>

3. Cambie business-central/WEB-INF/classes/META-INF/persistence.xml.
   En este archivo cambie el nombre del dialecto hibernate utilizado para su base de datos si está utilizando una base de datos diferente de H2. El código a continuación demuestra la información de la base de datos original para persistence.xml:

   <property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect"/>

   Esta información se puede actualizar de la siguiente manera (tal como se demuestra con la base de datos MySQL a continuación):

   <property name="hibernate.dialect" value="org.hibernate.dialect.MySQLDialect"/>

   Nota

   El dialecto para DB2 es org.hibernate.dialect.DB2Dialect, para DB2 en AS/400 es org.hibernate.dialect.DB2400Dialect, para Oracle es org.hibernate.dialect.Oracle10gDialect y para el servidor Microsoft SQL es org.hibernate.dialect.SQLServerDialect
4. Cambie el archivo business-central/WEB-INF/classes/META-INF/persistence.xml de manera que la máquina de procesos JBoss BPM Suite pueda usar la nueva base de datos.
   El código a continuación demuestra la información de la fuente de datos original para persistence.xml:

   <jta-data-source>java:comp/env/jdbc/jbpm</jta-data-source>

   Cambie este valor a la fuente de datos definida anteriormente:

   <jta-data-source>java:comp/env/jdbc/myDatasource</jta-data-source>

1. Ejecute startup.sh en el directorio $TOMCAT_HOME/bin.

   ./startup.sh

2. Vaya a http://localhost:8080/business-central en un navegador web.
3. Inicie sesión con el nombre de usuario/contraseña definidos en el archivo tomcat-users.xml.

1. En dashbuilder/META-INF/context.xml reemplace el nombre JNDI de la fuente de datos en el elemento <Resource>. El atributo uniqueName se refiere a la propiedad resource.ds1.uniqueName establecida en resources.properties:

   <Resource name="jdbc/dashbuilderDS" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource"/>

   Nota

   Dependiendo de su base de datos es posible que necesite definir otras propiedades aquí también. Por ejemplo, en un entorno Oracle esta entrada puede verse como el siguiente listado.

   <Resource name="jdbc/jbpm" uniqueName="jdbc/jbpm" auth="Container"  removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource" username="username" password="password"  driverClassName="oracle.jdbc.xa.client.OracleXADataSource" url="jdbc:oracle:thin:YOUR-URL:1521:YOUR-DB" maxActive="8" />
   

2. En dashbuilder/WEB-INF/web.xml agregue el nombre JNDI de la fuente de datos en el elemento <res-ref-name> con su nombre de fuente de datos:

   <resource-ref>
       <description>Dashboard Builder Datasource</description>
       <res-ref-name>jdbc/dashbuilderDS</res-ref-name>
       <res-type>javax.sql.DataSource</res-type>
       <res-auth>Container</res-auth>
   </resource-ref>

3. En dashbuilder/META-INF/context.xml defina la fábrica de transacciones:

    <Transaction factory="bitronix.tm.BitronixUserTransactionObjectFactory"/>

4. Actualice el nombre JNDI de la fuente de datos en dashbuilder/WEB-INF/etc/hibernate.cfg.xml en el elemento <session-factory>:

   <property name="connection.datasource">java:/comp/env/jdbc/dashbuilderDS</property>