Version 6

    From Guvnor 5.2 onwards

    From Guvnor 5.2 onwards we'll be releasing specific wars for JBoss AS 5.1, JBoss AS 6 and Tomcat 6 (and maybe more - patches welcome) that deploy to those app servers out of the box.

    Drools Guvnor 5.0 on JBoss AS 5.0/5.1



    Drools Guvnor 5.0 on Tomcat 6.x


    This instruction also applies to Tomcat:


    Configure JAAS authentification with Tomcat: (Contributed by


    1. We should have a JAAS LoginModule implemented that connect to a database
    and test if the user exists in the database.

    for example:
    public class JaasGuvnor implements LoginModule {
        public String userName;
        public String password;
        public boolean login(){
        return true if user exist and false if not
    /*other methods to implement*/

    2. open %TOMCAT_HOME%/conf/context.xml and you should configure your
    database, here I use Oracle
    <Resource name="jdbc/URDroolsDS"










        <Realm  className="org.apache.catalina.realm.JAASRealm"               





    3. add a file jaas.config on %TOMCAT_HOME%/conf

      com.test.JaasGuvnor required debug=true;


    4. Before lunching Tomcat we add “set JAVA_OPTS=-Xmx256m”

    Drools Guvnor 5.0 on Oracle AS (OC4J) 10.1.3 (Contributed by


    1. download oc4j (I use oc4j_extended_101350)
    2. extract the rar file
    3. Open the file data-source.xml %OC4J_HOME%/J2EE/home/config
    4. add the following lines
    <managed-data-source name="guvnor"
            jndi-name="jdbc/OracleDS" />
    <connection-pool name='drools-guvnor'
        <connection-factory factory-class='org.hsqldb.jdbcDriver'

    5. the following JARs are required
      - hsqldb.jar
      - hibernate-annotations.jar
      - hibernate-entitymanager.jar
      - hibernate3.jar
      - jboss-common.jar
      - dom4j.jar
      - commons-logging.jar
      - log4j.jar
      - commons-collections.jar
      - cglib.jar
      - jsf-api.jar
      - jsf-impl.jar

    start the server (the first start the server will need a password for
    6. open the URL: http://localhost:8888/em
    7.authentificate with your password

    8. go to application tab

    9. click on deploy and browse to the war file location

    10. click Next and give drools-guvnor as a name

    11. click Next
    12. Finally click Deploy

    Verify that Guvnor is running well:  http://localhost:8888/drools-guvnor



    Guvnor 5.0 on Weblogic 11g and 10g AS (Contributed by


    1. Install Weblogic AS
    2. create a new domain (quick start)
    3. click "Getting started with Weblogic ..."
    4. Click next -> next -> and give the domain name as guvnor
    5. click next -> next-> and finally create
    6.go to start menu -> Oracle Weblogic -> User Projects -> guvnor -> start
    admin server for weblogic server domain
    7. open http://localhost:7001/console
    8. give the password that you had specified on the domain creation
    9. click  "Deployments" (on the left)
    10. click "Install"
    11. give the path of drools-guvnor directory (extract drools-guvnor on a
    12. click next->next->...->finish
    13. now choose save
    14. click "Deployments" yand you will see drools-guvnor
    15. click "Start" -> "Servicing all requests"

    but you will see some problem and the service couldn't be started 
    don't worry, we will fixe this in a moment

    16. Stop the server
    17. go to %WEBLOGIC_HOME%\user_projects\domains\guvnor\lib and add the
    following JARs
      - commons-beanutils-1.7.0.jar
      - commons-codec-1.3.jar
      - commons-collections-3.2.jar
      - commons-digester-1.8.jar
      - commons-discovery-0.4.jar
      - commons-logging-1.1.1.jar
      - myfaces-api-1.2.8.jar
      - myfaces-impl-1.2.8.jar
    18. open drools-guvnor\WEB-INF/lib and add the followin JARs
      - asm.jar
      - cglib.jar
      - commons-logging-1.1.1.jar
      - hibernate3.jar
      - hibernate-annotations.jar
      - hibernate-commons-annotations-3.1.0.GA.jar
      - hibernate-entitymanager.jar
      - log4j.jar
    19. open the file drools-guvnor\WEB-INF \components.xml and replace

    <core:init transaction-management-enabled="false"/>

    with : <core:init debug="true" jndi-pattern="\#{ejbName}/local" />

    20. In  <component name="repositoryConfiguration"> add:
      <property name="homeDirectory">E:/GuvnorRepo/</property>
    don't forget to create a "GuvnorRepo" directory on E:\

    21. start the server and enjoy with Guvnor on http//localhost



    Drools Guvnor 5.0 on WebSphere