# 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.