2.2. Instalação do Pacote Implantável Genérico

Instale o Gerenciador de Transação.

Instale o Driver no seu Banco de Dados

<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"

defina "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 os usuários e as funções em $TOMCAT_DIR/conf/tomcat-users.xml. Observe que o Business Central exige que os usuários tenham as funções especificadas como admin e/ou analista (para mais informações sobre as definições de usuário e função, consulte a documentação sobre Tomcat 7).
   Segue abaixo um exemplo de como essas duas funções seriam adicionadas e como elas seriam atribuídas a um usuário nomeado bpmsadmin.

   Nota

   Certifique-se de que os nomes de usuário não entrem em conflito com as funções conhecidas. Por exemplo, você não deve criar um usuário com o nome de usuário admin.

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

2. Mova (não copie) kie-tomcat-integration-VERSION.jar de $TOMCAT_DIR/webapps/business-central/WEB-INF/lib/ para $TOMCAT_DIR/lib/.
3. Copie jboss-jaxb-api-VERSION.jar de $TOMCAT_DIR/webapps/business-central/WEB-INF/lib/ no $TOMCAT_DIR/lib/.
4. Em $TOMCAT_DIR/conf/server.xml, adicione a declaração Tomcat Valve no elemento <host> relevante:

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

1. Em business-central/META-INF/context.xml, substitua o nome JNDI da fonte de dados no elemento <Resource>. O atributo uniqueName refere-se à propriedade resource.ds1.uniqueName definida em resources.properties:

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

2. Em business-central/WEB-INF/web.xml, substitua o nome JNDI da fonte de dados no elemento <res-ref-name> pelo nome da sua fonte de dados:

   <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. Altere business-central/WEB-INF/classes/META-INF/persistence.xml.
   Nesse arquivo, altere o nome do dialeto do hibernate usado para a sua fonte de dados, se estiver usando uma fonte de dados diferente da H2. O código abaixo demonstra as informações originais da fonte de dados para persistence.xml:

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

   Essas informações podem ser atualizadas da seguinte maneira (como demonstrado com o banco de dados MySQL abaixo):

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

   Nota

   O dialeto para DB2 é org.hibernate.dialect.DB2Dialect, para DB2 em AS/400 é org.hibernate.dialect.DB2400Dialect, para Oracle é org.hibernate.dialect.Oracle10gDialect e para Microsoft SQL Server é org.hibernate.dialect.SQLServerDialect
4. Altere o arquivo business-central/WEB-INF/classes/META-INF/persistence.xml para que o mecanismo do processo JBoss BPM Suite possa usar o novo banco de dados.
   O código abaixo demonstra as informações originais da fonte de dados para persistence.xml:

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

   Altere esse valor para a fonte de dados definida antes:

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

1. Execute startup.sh no diretório $TOMCAT_HOME/bin.

   ./startup.sh

2. Navegue pelo http://localhost:8080/business-central.
3. Faça o login com o nome de usuário e a senha definidos antes no arquivo tomcat-users.xml.

1. Em dashbuilder/META-INF/context.xml, substitua o nome JNDI da fonte de dados no elemento <Resource>. O atributo uniqueName refere-se à propriedade resource.ds1.uniqueName definida em resources.properties:

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

   Nota

   Dependendo do seu banco de dados, pode ser preciso definir algumas outras propriedades também. Por exemplo, em um ambiente Oracle, essa entrada pode parecer-se com o seguinte:

   <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. Em dashbuilder/WEB-INF/web.xml, substitua o nome JNDI da fonte de dados no elemento <res-ref-name> pelo nome da sua fonte de dados:

   <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. Em dashbuilder/META-INF/context.xml, defina a fábrica de transação:

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

4. Atualize o nome JNDI da fonte de dados em dashbuilder/WEB-INF/etc/hibernate.cfg.xml no elemento <session-factory>:

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