This chapter takes you through the first steps of getting JBoss jBPM and provides the initial pointers to get up and running in no time.
Listed below are the different jBPM packages that are available today. Each of these packages contains one or more downloadable files. Along with each of these files goes a description of its contents and a pointer to any relevant installation instructions if they are available.
All downloads described below can be found on the sourceforge jbpm downloads page.
This is the main distribution package containing the core engine and a number of additional modules that you may need to work with jBPM. Download the files of this package here.
If you want to get started with jBPM quickly, this is the file you want to download. It contains all the other modules of this package plus the graphical designer in one single download named 'jbpm-starters-kit-<version>.zip'. Extract the zipped archive into a folder of your choice and read the file named 'readme.html' for more info and further installation instructions. With this starters kit you can immediately get started with the Chapter 3, Tutorial.
The download named 'jbpm-<version>.zip' contains the jBPM core engine as well as the identity component for actor and group management. To start working with it, extract the archive into a folder of your choice. You will find pointers to the User's Guide and other important information resources in the 'readme.html' file in the 'jbpm-<version>' folder.
If you want to change the jBPM database (which is Hypersonic HSQLDB by default), you will need the third download of this package. The file named 'jbpm-db-<version>.zip' contains a fair amount of resources you might need in order to perform this database change. These resources are, amongst others, database creation scripts, hibernate property files and database drivers. The detailed step-by-step instructions can be found by reading the 'readme.html' file in the top level directory of the extracted archive file.
The second package contains the downloads related to the jBPM Graphical Proces Designer. The designer enables you to author your process definitions and to easily deploy them. You can find these downloads here.The designer is a plug-in for the Eclipse platform which is available for download either as a zipped Eclipse feature or as a zipped Eclipse update site. There is no difference in content, the only difference is in the way you have to do the installation.
If you want to be absolutely sure that the designer installation goes smoothly, we recommend to use the update site mechanism together with a new Eclipse installation. Of cource the Eclipse version should match the downloaded update site archive. To obtain the Process Designer Update Site, you should download the file 'jbpm-gpd-site-<version>.zip'. Then follow the instructions in the 'readme.html' file included in the archives root folder to succesfully install the GPD.
If you are tired of each time having to do a fresh Eclipse installation and you are willing to cope with some possible issues, you can try the feature download. In this case installation is as easy as extracting the archive into your Eclipse installation (make sure the included 'plugins' and 'features' folders end up in the same location of your Eclipse installation) overwriting the files and folders with the same name that are possibly already present. This installation is very easy, but you could run into incompatibility issues when you overwrite plugins already present in your installation because of other features that you did install. Though they have the same name it could happen that the versions of these colliding plugins are not equal, hence the possible incompatibilities. Download the file 'jbpm-gpd-feature-<version>.zip' to obtain the GPD feature. The installation instructions are repeated in the 'readme.html' file.
The third and last package contains the jBPM BPEL extensions. It contains only one file : 'jbpm-bpel-<version>.zip'. You can find the package here .To get started with the BPEL extensions, look in the User's Guide in the 'doc' subfolder of the toplevel folder.