Skip navigation

Here is an exmple that shows how to deploy 'HelloProcess' exmaple ( using JBPM5 console.


How to install and run this example in an appserver (e.g. JBoss or Tomcat)?




1.) This example has one ftl file (HelloTask.ftl) for the human task following the pattern {TaskName}.ftl


2.) Create the image of the bpmn file using 'Export image (PNG)' option.

ScreenHunter_11 Feb. 27 17.31.gif

3.) Create a jar, e.g, 'HelloProcess.jar' file for all the artifacts (HelloProcess.ftl, Hello.ftl and Hello.png).

Alternately these artifacts can also be debloyed in Guvnor as shown in



4.) Copy the HelloProcess.jar to server's CLASSPATH. For example, it can be one of the options as shown below:


Copy the jar file into gwt-console-server war file  ( ..gwt-console-server\WEB-INF\lib)

or Copy the jar file into appserver's lib direcory (JBOSS_HOME\server\default\lib for JBOSS or TOMCAT_HOME\lib for TOMCAT)



5.) Copy the HelloProcess.bpmn file  to the directory where the other bpmn files are located

(specified using the parameter


6.) Start the appserver and login to http://localhttp://localhttp://localhttp://localhost:8080/jbpm-console


You can see the process after starting it.

ScreenHunter_12 Feb. 27 17.36.gif

ScreenHunter_13 Feb. 27 17.36.gif


You can click on the 'Personal Tasks' and approve this task.


ScreenHunter_14 Feb. 27 17.36.gif

Here is an example that shows the required steps to create a HelloWorld example with jBPM5 plug-in in Eclipse.

First install jBPM5 plugin using the steps ( or using the install script  (



A simple example ( is considered here to show the features of jBPM5 eclipse plug-in.

'Hello Task' is created as follows. Attached files (HelloProcess.bpmn, HelloTask.ftl and Hello.ftl) can be imported into the HelloProcess project created in




ScreenHunter_06 Feb. 27 13.24.gif


The user form for the task 'HelloTask' is created using the pattern {TaskName}.ftl as shown below.

ScreenHunter_07 Feb. 27 13.24.gif


The '' is created to read the 'HelloProcess.bpmn' file as shown below (also find the complete file as an attachement below):




public class HelloProcessTest {




public static final void main(String[] args) {
  try {



EntityManagerFactory emf = Persistence.createEntityManagerFactory("org.jbpm.task");
         TaskService taskService  = new TaskService(emf, SystemEventListenerFactory.getSystemEventListener());
          * Add the required users
         TaskServiceSession taskSession = taskService.createSession();  
         taskSession.addUser(new User("Administrator"));
         taskSession.addUser(new User("krisv"));
         /* Start Mina server for HT*/
         MinaTaskServer server = new MinaTaskServer(taskService);
         Thread thread = new Thread(server);
         System.out.println("Server started ...");
         /*Create the knowledge base for HelloProcss.bpmn */
         KnowledgeBase kbase = readKnowledgeBase();
   StatefulKnowledgeSession ksession = createSession(kbase);
   KnowledgeRuntimeLogger logger = KnowledgeRuntimeLoggerFactory.newThreadedFileLogger(ksession, "testlog", 1000);
   ksession.getWorkItemManager().registerWorkItemHandler("Human Task", new WSHumanTaskHandler());


   System.out.println(" started the humantask");






Select the 'Human Task View' using Window->ShowView->Drools Task->Human Task View. Start the program '' and look for  the tasks using the userID 'krisv'. 'Hello Task' can then be selected to perform tasks such as 'Start', 'Complete' etc.

ScreenHunter_08 Feb. 27 14.50.gif

Here are the manual steps to install jBPM5 plug-in and run a sample example in Eclipse.This install is done automatically after running jBPM5 installer ( Following procedure, however, might be useful if you want to understand (or having problems completing the install) the main install steps provided in the automated install script for JBPM5.2. The install instructions for the previous release 5.1 can also be found in the attachment


1.) Download Eclipse Helios:


Unzip this into a directory, say JBPM5


2.) Download Drools and JBPM5 plugin, i.e.,



Unzip this plugin to a temp directory, say TEMP\drools-update-site. Copy 'features' and 'plugins' directories from TEMP\drools-update-site into



It is required to have a runtime dependant libraries that a jBPM5 sample can use.


3.) Download the libraries ( ) from and unzip into a directory, say JBPM5\runtime.


4.) Create a new jBPM sample project in Eclipse and use the runtime libraries downloaded in Step 4.


ScreenHunter_05 Feb. 27 09.42.gif



ScreenHunter_01 Feb. 27 09.19.gif

ScreenHunter_02 Feb. 27 09.19.gif



Select 'Configure Workspace Setting' link below and set it to 'JBPM5\runtime' directory created in Step4.





Update for the version 5.4:


Following two links can be used in Steps 2 and 3 for  JBPM 5.4 plugin and the runtime libraries.


jBPM Plugin: : jbpm-5.2.0.Final-bin.zip

Filter Blog

By date:
By tag: