How to install activiti-explorer on WildFly-JBoss

This short tutorial will teach you how to deploy activiti-explorer Web application on WildFly / JBoss EAP using a custom database such as PostgreSQL.

First of all, download Activiti last stable release from http://www.activiti.org/download.html.

There, within the zip file, you will find the war folder which contains the activiti-explorer.war file. Here are the steps for changing the database.

$ unzip activiti-explorer.war

Edit the file WEB-INF/classes/db.properties and specify the JDBC settings for the Database. This is the default file:

db=h2
jdbc.driver=org.h2.Driver
jdbc.url=jdbc:h2:mem:activiti;DB_CLOSE_DELAY=1000
jdbc.username=sa
jdbc.password=

Here’s a sample configuration for PostgreSQL

db=postgres
jdbc.url=jdbc:postgresql://localhost/activiti
jdbc.driver=org.postgresql.Driver
jdbc.username=postgres
jdbc.password=postgres

In addition, consider that Activiti Explorer generates demo user and groups, process definitions and models by default. To disable this, the engine.properties file (also in the WEB-INF/classes folder) should be changed. To disable the demo setup fully you can set all of these properties to false. But as you can see you can also enable and disable items individually.

# demo data properties
create.demo.users=true
create.demo.definitions=true
create.demo.models=true
create.demo.reports=true

Update activiti-explorer with JDBC driver

Last step will be copying the JDBC Driver for your DB, in the WEB-INF/lib folder of activiti-explorer.war

$ cp postgresql-9.4-1204.jdbc4.jar activiti-explorer.war/WEB-INF/lib

Now, pack activiti-explorer.war and deploy the activiti-explorer to WildFly / JBoss

$ cp activiti-explorer.war $JBOSS_HOME/standalone/deployments