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
  • resources.properties
    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:

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

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

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

Installing Drools in Eclipse and Creating Simple Hello World Application in Drools

Drools

• Drools is a Business rule management system
• It is used to separate the data from logic.
• It allow us to write logic (rules) in more layman readable form. This allow business people to create their own rules instead of depending on programmers and developers.

Rules

Rules are pieces of knowledge often expressed as, "When some conditions occur, then do some tasks."
The most important part of a Rule is it’s when part. If the when part is satisfied, the then part is triggered

Installing Drools in Eclipse

Drools comes with plugin for eclipse to create and manage the project from eclipse itself.

Prerequisites to install Drools Plugin:

• Java 1.5 (or higher)
• Eclipse 4.2

Installation Step

• Download the latest binaries from http://download.jboss.org/drools/release/
• Launch Eclipse -> help -> install new software -> Add.
  • Name – Drools
  • Location - http://download.jboss.org/drools/release/X.X.X.Final/org.drools.updatesite/
    where X.X.X is version of drool downloaded.
  • Click Ok
• Checkmark “Drools and jBPM”. Click next. Accept the terms and wait for installation to finish.

Drools Runtime

Drool runtime is needed to create and execute drool rules.

• Click on Windows -> Preference -> Drools -> Installed Drools Runtime -> Add -> Browse.
• Browse to the downloaded binaries folder and Add.

Example Project

1. File -> New -> Drool Project -> Create an empty project.
2. Enter project name -> finish.
3. The project follow maven folder structure. Two primary folder are
   1. src/main/java – Java code would go here.
   2. src/main/resources – Drool files would go here.
4. Create a new java class file in src/main/java. Say ‘Hello.java’ in package ‘com.example’.
5. Create a new drool file in src/main/resources/rules. Say ‘ReplaceHello.drl’.
6. Result.

Apart from creating the rules file in resources folder, we can import the rules files from classpath as well as file system. Below example show an example of reading the rule file from classpath.