best grammar app

Making JBPM5 work on a remote host

Submitted by Abhishek on Sat, 2011-10-29 20:01

For the most part of it JBPM5 works pretty well if you follow the installation instructions. However problems start coming in when you expose or access it on a remote machine i.e. not localhost. Some of the problems you could run into are

  • A 404 error when you try and start a process
  • Reporting does not work
  • Saving and reloading process in designer could cause failures

The sections below explain how you can get through with these

A 404 error when you try and start a process

For this to work you will need to fix in a property file inside the jbpm-gwt-console-server.war file. This file is located in serverdefault/deploy directory. Copy it somewhere, unjar it using the command

jar xvf jbpm-gwt-console-server.war

After the extraction looks for a file jbpm-gwt-core-5.1.0.Final.jar inside the WEB-INF/lib folder. Copy this file to some other folder and extract it using the command

jar xvf jbpm-gwt-core-5.1.0.Final.jar

Now in the extracted output, look for a file called The contents of this file should look like



Where I have replaced the and jbpm.console.server.port to my remote server settings. You can provide your IP address as well.

Now lets repackage stuff. Jar back the contents by running the command

jar cvf jbpm-gwt-core-5.1.0.Final.jar *

This will recreate the jar for you. Copy the jbpm-gwt-core-5.1.0.Final.jar from current folder to WEB-INF/lib of the jbpm-gwt-console-server.war extract. This is the same location from where you copied it originally. Now package the war as well using the command (run it on the base folder)

jar cvf jbpm-gwt-console-server.war *

Just copy the updated war to the server/default/deploy directory and restart your JBPM Server. It should work fine.


Reporting does not work

BIRT is an Eclipse-based open source reporting system for web applications, especially those based on Java and Java EE. To enable it you will need to enable a flag while installing JBPM.  In the file of your installer, just change from “false” to “true” the line

If you run the installed after this reporting will be installed.

Assuming you have already installed JBPM and now want to enable BIRT, that can be done easily as well.

Run the command

ant download.birt

This will download birt. Now to install it after the download is done run the command

ant install.reporting.into.jboss

This will take care of the rest.


Saving and reloading process in designer could cause failures

For this to work, you will need to do the some jar changes again.  Look for the designer.war file insides server/default/deploy folder. Copy the designer.war to some folder and unjar it using the command


jar xvf designer.war

Then in the profiles/jbpm.xml,on the bottom you would need to change

<externalloadurl protocol="http" host="localhost:8080" subdomain="drools-guvnor/org.drools.guvnor.Guvnor/oryxeditor" usr="admin" pwd="admin"/>

to the url you're using i.e.

<externalloadurl protocol="http" host="" subdomain="drools-guvnor/org.drools.guvnor.Guvnor/oryxeditor" usr="admin" pwd="admin"/>

Save the file and rejar the designer

jar cvf designer.war *

copy the jar back to the server/default/deploy folder and restart your JBPM Server. \

That should do it.

Abhishek Mishra
Good experience in working with BPM technologies like Savvion, JBPM. Founder and Chief Editor of Founder of Savvion Business Manager Mobility Framework Savmobify| View my BPMGeek Profile
best grammar app

About BPMGeek

BPMGeek is an initiative to collaborate and communicate with the growing Business process management community out there. The goal is to help developers connect with experts, ask questions, post their learning and get understanding of BPM Concepts. Often tool specific knowledge of niche areas end up developers perplexed and confused - especially when there are very less number of resources available. We will be coming up several several new features. Have a look at our Roadmap here

BPMGeek is an independent entity not associated with any Product. All BPM product professionals are invited to contribute. The Logos and Names used across the site belong to their respective owners. The viewpoints mentioned by Individual contributors are their own. BPMgeek cannot be held liable for any issues arising out of it.

BPMgeek is promoting the Nounshoun English Grammar App - developed by Constellation Software.