Installation
Prerequisites
This script assumes you have Java JDK 1.5+ (set as JAVA_HOME), and Ant 1.7+ installed.
If you don't, use the following links to download and install them:
Java: http://java.sun.com/javase/downloads/index.jsp
Ant: http://ant.apache.org/bindownload.cgi
Download the installer
First of all, you need to download the installer:
drools-{version}-install.zip
You can for example find the latest snapshot release here.
Demo setup
The easiest way to get started is to simply run the installation script to install the demo setup.
Simply go into the install folder and run:
ant install.demo
This will:
- Download JBoss AS
- Download Eclipse
- Install Guvnor into JBoss AS
- Install the gwt-console into JBoss AS
- Install the Eclipse plugins
Once the demo setup has finished (this could take a while as it might have to download the various components),
you can start playing with the various components by starting the demo setup:
ant start.demo
This will:
- Start the H2 database
- Start the JBoss AS
- Start Eclipse
- Start the Human Task Service
Once everything is started, you can start playing with the Eclipse tooling, Guvnor and gwt-console, as explained in the next three sections.
Using Eclipse Tooling
The following screencast gives an overview of how to run a simple demo process in Eclipse. It shows you:
- How to import an existing example project into your workspace, containing
- a sample BPMN2 process for requesting a performance evaluation
- a sample Java class to start the process
- How to start the process
- How to complete human tasks using the test human task client in Eclipse
If you want to know more, we recommend you take a look at the Drools documentation here.
Using Guvnor repository
Open up Drools Guvnor:
http://localhost:8080/drools-guvnor
Log in, using any non-empty username / password (we disabled authentication for demo purposes).
The following screencast gives an overview of how to manage your repository. It shows you:
- How to import an existing sample repository, containing the performance evaluation process as shown in the previous section
- How to look up the processes that are part of a package
- How to build a package so it can be used for creating a session (like for example in the gwt-console as shown in the next section)
If you want to know more, we recommend you take a look at the Drools documentation here.
Using web management consoles
First make sure you have imported the sample repository and built the defaultPackage in Guvnor first (see previous section).
Open up the process management console:
http://localhost:8080/gwt-console
Log in, using krisv / krisv as username / password.
The following screencast gives an overview of how to manage your process instances. It shows you:
- How to start a new process
- How to look up the current status of a running process instance
- How to look up your tasks
- How to complete a task
- How to generate reports to monitor your process execution
If you want to know more, we recommend you take a look at the Drools documentation here.
Once you're done playing:
ant stop.demo
and simply close all the rest.
Manually installing the different components
If you don't want to use the demo setup, you can also use the individual ant targets, as described below.
Getting JBoss AS
You need to download and install JBoss AS version 4.2.3.GA.
If you don't have it installed yet, go into the install folder and run the installation script:
ant install.jboss
This will download and install the server in install/jboss-4.2.3.GA folder. If you don't
want it to download the zip file, you can put the jboss-4.2.3.GA.zip in the install/lib folder.
If you already have it installed somewhere else, in install/build.properties, change the
jboss.home property to the location of your JBoss AS installation.
Getting Eclipse
You need to download and install Eclipse 3.5.2
If you don't have it installed yet, run installation script:
ant install.eclipse
This will download and install eclipse in install/eclipse folder.
If you don't want it to download the eclipse file, you can put the file in the install/lib folder:
eclipse-SDK-3.5.2-linux-gtk.tar.gz (linux),
eclipse-SDK-3.5.2-win32.zip (windows), or
eclipse-SDK-3.5.2-macosx-carbon.tar.gz (mac).
If you don't want it to download the eclipse GEF file, you can put the GEF-runtime-3.5.2.zip file in the install/lib folder.
If you already have it installed somewhere else, in install/build.properties, change the
eclipse.home property to the location of your Eclipse installation.
Installing
In the install dir, run installation script:
ant install.guvnor.into.jboss
ant install.drools-gwt-console.into.jboss
ant install.drools-eclipse.into.eclipse
Starting
Startup database:
ant start.h2
Startup JBoss AS:
ant start.jboss
Startup task service:
ant start.human.task
Startup eclipse:
ant start.eclipse
Stopping
Once you're done playing
stop database:
ant stop.h2
stop JBoss AS:
ant stop.jboss
and simply close all the rest.