Installation
The following section will give you a brief overview how to install an instance of the IX JEE Workflow Server. This introduction refers only the basic steps needed to get the Example Application up and running. If you need more detailed informations about deployment see the documentation for further informations.
Install Glassfish Application Server
To install the IX JEE Workflow Server components you need first a JEE application server like Glassfish , Sun, Geronimo or JBoss . After you have set up your server environment successfully it is easy to deploy a sample application of the IX Workflow on your server platform.
The next sections will explain the configuration steps needed using IX JEE Workflow in conjunction with the Glassfish JEE Server. For more help to install a Glassfish see also the Installation guide for Windows or the Installation guide for Linux Users.
Setting up the IX database pool
The example application uses a database pool with the name "imixs_db_pool". You need first to set up a Derby Database Store and a JDBC connection pool before you are able to deploy the sample application successful. If you did it not, your tables will be created in the default sun-appserv-samples database [glassfish]AppServer\bin\sun-appserv-samples. The database storage is easily changed later to other database systems.
To create your own database storage follow these steps:
- start admin console -> http://localhost:4848/asadmin
- navigate to Application Server > Resources > JDBC > Connection Pools
- click "new" to create a new database source
- name: your database name (e.g. "imixs_db_pool")
- resource type : javax.sql.DataSource
- Database Vendor : Derby - click "next". Now only the following property settings are necessary:
- ConnectionAttributes: ;create=true
- DatabaseName: "imixs_db_pool"
- Password: "APP"
- User: "APP"
- ServerName : "loacalhost"
- portnumber: 1527 - Now create a JDBC Resource - Navigate to "Application Server > Resources > JDBC > JDBC Resources"
- click "new" to create a new resource
- jndiName: jdbc/imixs_db
- PoolName: imixs_db_pool
Setup Security
To work with the example application you need also to configure a security realm. Follow the steps below: (The configuration of the Realms differs from different Glassfish Realeases. If the steps below are not clear you need to see the manual from your glassfish server)
- start admin console -> http://localhost:4848/asadmin
- navigate to Configuration->Security->realms
- add a new file realm named "imixsrealm"
- choose the class Name "com.sun.enterprese.security.auth.realm.file.FileRealm"
- Set the JAAS Context to "fileRealm"
- Set the Key File to a new File name. e.g. "imixskeyfile"
- open the newly created realm configuration and click on button "manage users"
- Add the following test accounts:
UserID Group Description Manfred IMIXS-WORKFLOW-Manager
This user will have maximum access Eddy
IMIXS-WORKFLOW-Editor
This user can edit allworkitems Anna
IMIXS-WORKFLOW-Author
This user will be allowed to create workitems and edit his own
Ronny
IMIXS-WORKFLOW-Reader
This user will be only allowd to read workitems
Norbert
This user will have no access (just to be shure security works well)
It is also possible to configure other security bindings as the file based described here. Only the realm name should match to "imixsrealm".
Deploy the Example Application
First download the example application (org.imixs.callcenter.ear) directly from the download center .
Now install the EAR file by the following steps:
- Be sure, that your database server is up and running. Start it with
>asadmin start-database - Be sure, that the domain, which you will deploy the application on, is alive. Start it with
>asadmin start-domain [ name of domain ] - Now you can start the Admin Console in the browser. The port is listed in the output while starting the domain, i.e. in the default domain domain1 it is
>http://[ name of the server ]:4848 - Choose Applications -> Enterprise Applications and click the button "deploy" in the main frame
- Choose as type "Enterprise Application (.ear)"
- at Location choose "Packaged file to be uploaded to the server" and browse to the location, where the ear file is stored
- press the button "ok" located in the upper right corner --> ear will be deployed
Start the Example Application
Now its time to start the example application.
Open a web browser and enter the following url:
http://localhost:8080/callcenter
(Change localhost with your host depending on where your server runs if it is not local)
To log on take one of the user accounts you created before in the imixsrealm - e.g. "Manfred"
Upload the Workflow Model
Before you can test the example you need further to upload a workflow model.
The Demo Application contains a valid model file so you need not to do all the modeling by your self. Download the Demo Model (example.ixm file) form the download center . This file you can open with the IX Workflow Modeler Plugin. You can synchronize this model file with your server using the IX Modeler.
After you have installed the ear application and also deployed the model successfully, the Imixs JEE Workflow is up and running. In the Example you will find typical workflow functions like a statuslist and a todolist and also you can create new workitemes.
Install the Admin Client
In addition you can install the Admin Client which allows you to administrate your workflow instance on your server. You can download the admin client form the download center . After you have download the war file you should be able to deploy it as a web application on your glassfish server instance.
After successfull deployment you can start the Adminclient with the following URL
http://localhost:8080/org.imixs.workflow.jee.adminclient.web
See further informations about the usage of the admin client here .
