Installing KIE workbench in Apache Tomcat 7 in Windows

KIE Drools Workbench

KIE workbench is the workflow engine where complex business process can be develop and executed. It also provide interface to create guided and DRL rules. The workbench can be linked through a Java application to use the created rule in our application.

Installing KIE workbench in Apache Tomcat 7 in Windows

• Download the Kie workbench from http://download.jboss.org/drools/release/6.4.0.Final/kie-drools-wb-distribution-wars-X.X.X.Final-tomcat7.war. The X.X.X is version of the workbench. It must correspond to the version of Drools engine used.
• The war file downloaded need to be deployed in the web-app folder of Apache tomcat.
• Download and copy following jar files 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
  • JACC (javax.security.jacc:artifactId=javax.security.jacc-api in JBoss Maven Repository)
• Create configuration files inside TOMCAT_HOME/conf
  • btm-config.properties

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

    view raw btm-config.properties hosted with ❤ by GitHub
  • 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:C:/apache-tomcat-7.0.53/temp2
    	resource.ds1.driverProperties.user=sa
    	resource.ds1.driverProperties.password=
    	resource.ds1.allowLocalTransactions=true

    view raw resources.properties hosted with ❤ by GitHub
    
    The Path in above file need to be change to the actual system path.

Create setenv.sh (or setenv.bat) file inside TOMCAT_HOME/bin and add following:

set CATALINA_OPTS=-Xmx512M -XX:MaxPermSize=512m -Dbtm.root=C:\apache-tomcat-7.0.53\ -Dbitronix.tm.configuration=C:\apache-tomcat-7.0.53\conf\btm-config.properties -Djbpm.tsr.jndi.lookup=java:comp/env/TransactionSynchronizationRegistry -Djava.security.auth.login.config=C:\apache-tomcat-7.0.53\webapps\kie-drools-wb\WEB-INF\classes\login.config -Dorg.jboss.logging.provider=jdk -Dorg.uberfire.nio.git.dir=C:/apache-tomcat-7.0.53/temp

view raw setenv.bat hosted with ❤ by GitHub

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

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

view raw server.xml hosted with ❤ by GitHub

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

	<user username="tomcat" password="tomcat" roles="manager-gui"/>
	<user username="naved" password="naved" roles="admin"/>

view raw tomcat-users.xml hosted with ❤ by GitHub

Start tomcat and open url http://127.0.0.1:8080/kie-drools-wb- distribution-wars-X.X.X.Final-tomcat7