Imixs Workflow ...the open source workflow technology for business applications

Engine

Installation

The following section will give you a brief overview how to install an instance of the Imixs Workflow Engine into a Java EE Application Server. The installation guide is helpful to get a better understanding what is necessary to run the Imixs JEE Components on a Java EE Application Server.

Note:
If you just want to use the Imixs Workflow Engine in your own Web Project you can use the Imixs Web Tools which provides an easy to use jsf workflow framework.

The Imixs Workflow project provides a Enterprise Sample Application which can be download from the Imixs Donwload page

This introduction refers only the basic steps needed to get the JSF Sample Application up and running on different platforms. If you need further informations about the deployment of the Imixs JEE Workflow components into an Java EE Application server see the deployment section for more detailed informations.

You can download the Imixs Sample Enterprise Application for different Server platforms from the Imixs Download page

Install and setup your Application Server

To install the Imixs Workflow Engine you need first a Java EE application server like Glassfish (Oracle), Geronimo (IBM) or JBoss. To deploy the Imixs Workflow Engine or the Imixs Sample Enterprise Application successful on a Java EE Server you need at least the following resources:

  • a Database to store workitems processed by the Imixs Workflow
  • a JPA based Database connection from your Application Server to your database
  • a Security Realm to authenticate users who should interact with the Workflow Management System

After you have set up your server environment successfully it is easy to install the Imixs Sample Application or to deploy any instance of your own Imixs Workflow System into this server.

The next sections will explain the configuration steps needed to successfully deploy the Imixs Sample Application on different Java EE Servers:

Setup a Workflow Model

Before you can start the sample application you need to provide a process model. The process model describes the behavior of the Workflow Management System. Things like the Read- or Write-Access, the Process History or Email notifications are declared in the Model.

The Sample Application contains a valid model file of a "Trouble Ticket Workflow System". A trouble ticket system is based on a business process that manages and maintains lists of issues, as needed by an organization. Trouble Ticket Systems are commonly used in an organization's customer support call center to create, update, and resolve reported customer issues, or even issues reported by that organization's other employees.

Setup the Imixs Sample Application

Run the Sample Application

After you have installed and setup the Imixs Sample Application start the application with the following url:

 http://localhost:8080/workflow

How the application works is explained in the following section:

Run the Imixs Sample Application