Scribd
Upload
150 views4 pages

Drools Workbench Installation Notes

The document provides installation instructions for installing and configuring Bitronix transaction manager and JEE security on Tomcat to run a Linux distribution of KIE workbench. The key steps include: 1. Copying required JAR files to the Tomcat lib directory and creating configuration files. 2. Configuring system properties and environment variables to set paths and configure logging. 3. Configuring Tomcat users for security and adding a JACC valve to the server configuration.

Uploaded by

Vikrant
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
150 views4 pages

Drools Workbench Installation Notes

The document provides installation instructions for installing and configuring Bitronix transaction manager and JEE security on Tomcat to run a Linux distribution of KIE workbench. The key steps include: 1. Copying required JAR files to the Tomcat lib directory and creating configuration files. 2. Configuring system properties and environment variables to set paths and configure logging. 3. Configuring Tomcat users for security and adding a JACC valve to the server configuration.

Uploaded by

Vikrant
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 4

Installation notes for linux

=======================

1. Install bitronix transaction manager into your tomcat 7

- copy following libs into TOMCAT_HOME/lib

* btm-2.1.4.jar

* btm-tomcat55-lifecycle-2.1.4.jar

* h2-1.3.161.jar

* jta-1.1.jar

* slf4j-api-1.7.2.jar

* slf4j-jdk14-1.7.2.jar

* kie-tomcat-integration-6.5.0.Final.jar

* javax.security.jacc-api-1.5.jar

* geronimo-jta_1.1_spec-1.1.jar

2. Create configuration files inside TOMCAT_HOME/conf

* btm-config.properties

************************ sample btm-config.properties *************************

bitronix.tm.serverId=tomcat-btm-node0
bitronix.tm.journal.disk.logPart1Filename=../work/btm1.tlog
bitronix.tm.journal.disk.logPart2Filename=../work/btm2.tlog
bitronix.tm.resource.configuration=../conf/resources.properties

*******************************************************************************
* resources.properties

************************ sample resources.properties **************************

resource.ds1.className=bitronix.tm.resource.jdbc.lrc.LrcXADataSource
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=10
resource.ds1.maxPoolSize=20
resource.ds1.driverProperties.driverClassName=org.h2.Driver
resource.ds1.driverProperties.url=jdbc:h2:file:~/DEV_TOOLS/tomcat/tomcat7/jbpm
resource.ds1.driverProperties.user=sa
resource.ds1.driverProperties.password=
resource.ds1.allowLocalTransactions=true
*******************************************************************************

NOTE: jdbc/jbpm is the JNDI name used by tomcat distribution of the application

3. Define system properties for btm.root, bitronix config file, JBoss logging provider and others.

Editor create setenv.sh file inside TOMCAT_HOME/bin and add following:

export CATALINA_OPTS="-Xmx512M -XX:MaxPermSize=512m -Dbtm.root=$CATALINA_HOME


-Dbitronix.tm.configuration=$CATALINA_HOME/conf/btm-config.properties
-Djbpm.tsr.jndi.lookup=java:comp/env/TransactionSynchronizationRegistry
-Djava.security.auth.login.config=$CATALINA_HOME/webapps/kdroolswb65/WEB-INF/classes/l
ogin.config -Dorg.jboss.logging.provider=jdk -Dorg.kie.demo=false
-Dorg.kie.example=false -Dorg.uberfire.nio.git.ssh.host=0.0.0.0"

NOTE: - -Dorg.uberfire.nio.git.ssh.host=0.0.0.0 is required to start git ssh at


0.0.0.0 default is localhost which will not work if you will try to clone to clone on
remote machine giving ip of linux workbench server.

NOTE: - -Dorg.kie.demo=false -Dorg.kie.example=false are required for linux systems to


stop workbench from cloning demo example repository not required if system is able to
connect demo github repository.

NOTE:- On Debian based systems $CATALINA_HOME needs to be replaced with $CATALINA_BASE.


($CATALINA_HOME defaults to /usr/share/tomcat7 and $CATALINA_BASE defaults to /var/lib/tomcat7/)

NOTE: this is an example for unix like systems for Windows $CATALINA_HOME needs to be replaced
with windows env variable or absolute path

NOTE: java.security.auth.login.config value includes name of the folder in which application is


deployed by default it assumes kie-drools-wb so ensure that matches real installation.

login.config file can be externalized as well meaning be placed outside of war file.
*******************************************************************************

4. Configure JEE security for kie-wb on tomcat (with default realm backed by tomcat-users.xml)

2a. Copy "kie-tomcat-integration" JAR into TOMCAT_HOME/lib (org.kie:kie-tomcat-integration)

2b. Copy "JACC" JAR into TOMCAT_HOME/lib (javax.security.jacc:artifactId=javax.security.jacc-api in


JBoss Maven Repository)

2c. Copy "slf4j-api" JAR into TOMCAT_HOME/lib (org.slf4j:artifactId=slf4j-api in JBoss Maven


Repository)

2d. Add valve configuration into TOMCAT_HOME/conf/server.xml inside Host element as last valve
definition:

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

2e. Edit TOMCAT_HOME/conf/tomcat-users.xml to include roles and users, make sure there will be
'analyst' or 'admin' roles defined as it's required to be authorized to use kie-wb

Additional notes :

1. In tomcat.home/conf/context.xml, add this line

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


2. In tomcat.conf/conf/server.xml, add this line

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


3. Verify ports 8001 and 4918 are open these will be used by niogit

-------------------------------------------------client side

Add settings.xml in .m2 driectory

<?xml version="1.0" encoding="UTF-8"?>


<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
http://maven.apache.org/xsd/settings-1.0.0.xsd">

<servers>
<server>
<id>guvnor-m2-repo</id>
<username>tomcat</username>
<password>tomcat</password>
<configuration>
<wagonProvider>httpclient</wagonProvider>
<httpConfiguration>
<all>
<usePreemptive>true</usePreemptive>
</all>
</httpConfiguration>
</configuration>
</server>
</servers>

</settings>

You might also like