Introduction to jBPM

Chapter 1. Introduction

1.1. License and EULA

1.2. Downloads

1.3. Sources

1.4. What is it

1.5. Contents of this userguide

1.6. Migration from jBPM 3

1.7. Reporting problems

This documentation is best viewed in firefox. There are some known issues with internet explorer.

1.1. License and EULA

jBPM is distributed under the terms of the GNU Lesser General Public License (LGPL) and the JBoss End User License Agreement (EULA). See the full LGPL license text and the full End User License Agreement.

1.2. Downloads

The distribution packages can be downloaded from sourceforge
http://sourceforge.net/projects/jbpm/files/

1.3. Sources

The source code for this component can be found in the jBPM SVN repository:
https://anonsvn.jboss.org/repos/jbpm/jbpm4/

1.4. What is it

jBPM is an extensible and flexible process engine that can run as a standalone server or embedded in any Java application.

1.5. Contents of this userguide

In this user guide, we'll describe the jPDL process language in persistent execution mode. Persistent execution mode means that process definitions, process executions and process history is stored in a relational DB. This is the common way of how jBPM is used in practice.
This user guide explains the supported way on how to use jBPM. The developers guide explains more advanced customization options that are not part of the support offerings.

1.6. Migration from jBPM 3

Migration from jBPM 3 to jBPM 4 is not supported. Check out the developers guide for hints on how to perform the migration.

1.7. Reporting problems

When reporting a problem in the user forum or in our support portal, please use the following snippet as a template:

__________________________________________________________________________________

__________________________________________________________________________________

=== Environment ==============================
- jBPM Version : which version of jBPM are you using?
- Database : which database and which version of that database
- JDK : which Java version are you using? use 'java -version' to find out
- Container : which container are you using? (JBoss, Tomcat, etc.)
- Configuration : is your jbpm.cfg.xml only using imports from the jbpm.jar
   lib itself? or did you create a custom config file?
- Libraries : are you using the exact versions of the libs from inside the jbpm
   distribution of the version that you're using? or did you change some of the 

libs?

=== Process ==================================
paste jPDL process here

=== API ===================================
paste the relevant code snippet that you use to invoke jBPM

=== Stacktrace ==============================
paste full stack trace here

=== Debug logs ==============================
paste debug logs here

=== Problem description =========================

________________________________________________________________________________

________________________________________________________________________________  

Keep this part short and to the point. E.g. API doesn't work as expected. 
or e.g. method ExecutionService.signalExecutionById throws exception.

Clever readers will have noticed that some of these questions point to probably causes :-) Especially tweaking the libs and configuration can easily lead to trouble. That's why we have spend a great deal of effort to include default installations and a simplified configuration mechanism with imports. Think twice before you start to customize configurations beyond what is indicated in this userguide. Also think twice before replacing libs with other versions.





For more information follow my Tutorial  online @ http://jbpmmaster.blogspot.com/