This week for the current Red Hat customers we have released the Red Hat JBoss BPM Suite Beta1. A milestone release on the way to a final version 6 release.
Without going into details that will be presented upon a final Beta release announcement soon, I wanted to give customers with access to the Beta1 release a head start by providing a completely automated setup of the JBoss BPM Suite, with a pre-configured mortgage demo project out of the box.
This project is setup like all my previous JBoss BRMS demos and therefore should be a snap for you to get started with. You just need to obtain the project, download the products from the Customer Portal, and push the start button.
Easy as can be!
For more details here is a bit of a walkthrough to get you on your way, starting with the Github hosted project bpms-mortgage-demo:
Get project
# You will want to clone the project as follows. # $ git clone https://github.com/eschabell/bpms-mortgage-demo.git
With this project still based on the Beta releases, the final documentation has not been added, therefore I provide the walkthrough in this article instead. This will be replaced with details quickstart documentation in the project you cloned above in the future, including a slide overview of the project architecture.
For now lets look at the directories and files provided.
Project structure
README.md - contains instructions and details to get started. init.sh - the script to install and configure products and demo. installs/ - directory to put the products for this demo, see README file there. projects/ - directory containing the developer demo project for JBDS import. docs/ - directory containing eventual demo documentation. support/ - directory with all supporting files and configurations for installing project.
Once you have cloned this to your machine, you can then go to the Customer Portal and download the JBoss BPM Suite Beta1 product.
 |
| Download the last entry for JBoss EAP 6 |
The file you have downloaded will be called jboss-bpms-6.0.0.Beta1-deployable-eap6.x.zip, you will also need to download JBoss EAP 6.1.0, which can be found in the Customer Portal also.
Install products
# Download & copy to the installs directory. # Ensure that this file is executable by running: # $ chmod +x installs/jboss-bpms-6.0.0.Beta1-deployable-eap6.x.zip $ chmod +x installs/jboss-eap-6.1.0.zip
Now you can execute in the project root directory the provided init.sh (or init.bat) file.
Installation output
# Running the installation script gives the following output. # $ ./init.sh ################################################################# ## ## ## Setting up the Mortgage Demo ## ## ## ## ## ## #### #### # # ### # # ##### ##### ##### ## ## # # # # # # # # # # # # # # ## ## #### #### # # # ## # # # # ### ## ## # # # # # # # # # # # ## ## #### # # # ### ##### ##### # ##### ## ## ## ## ## ## brought to you by, ## ## Babak Mozaffari, Eric D. Schabell ## ## ## ## git@github.com:eschabell/bpms-mortgage-demo.git ## ## ## ################################################################# EAP sources are present... - detected target directory, moving on... - existing JBoss Enterprise EAP 6 detected... - moving existing JBoss Enterprise EAP 6 aside... Unpacking new JBoss Enterprise EAP 6... Unpacking JBoss BPM Suite 6.0.0.Beta... - enabling demo accounts logins in application-users.properties file... - enabling demo accounts role setup in application-roles.properties file... - setting up demo projects... - setting up standalone.xml configuration adjustments... - making sure standalone.sh for server is executable... Deploying web service that pulls out credit report of customer based on SSN... You can now start the JBoss BPM Suite with ./target/jboss-eap-6.1/bin/standalone.sh JBoss BPM Suite 6.0.0.Beta Mortgage Demo Setup Complete.
You will now note that you have a new directory, target/ that contains the JBoss EAP server, an installation of JBoss BPM Suite, and a pre-configured mortgage demo project which you can start as follows.
Start JBoss BPM Suite
# The will run with this startup, installing a maven repository from # the JBoss BPM Suite in the directory you start it from. You will # see a 'repository/' directory. # $ ./target/jboss-eap-6.1/bin/standalone.sh
 |
| JBoss BPM Suite login |
http://localhost:8080/business-central
There are several roles defined and configured for the various possible human task that are part of the mortgage demo.
User roles for demo
- User erics with password bpmsuite, has all roles and admin rights.
- User alan with password bpmsuite, has appraiser role.
- User bob with password bpmsuite, has broker role.
- User mary with password bpmsuite, has manager role.
After login you will see the initial screen with links to various parts and components of the JBoss BPM Suite. It has been pre-loaded with the mortgage demo so no need to use the Authoring -> Administration menu where you would start to either create a new repository and project, or import an existing one from some Git repository.
This will then load all the existing project artifacts into the Project Explorer business user browser on the left hand side.
 |
| Project screen |
Now we want to build and deploy the project, so that we can start our very first instance to run through the demo. To do this we need to open the Tools -> Project Editor which will give you the Project Screen that has a Build & Deploy button at the top right corner.
Hitting that button will give a green bar pop-up that says Build successful if all goes well.
 |
| Build & deploy project |
The button New Instance at the top can be pressed to deploy a new process, which pops-up with your first form to submit a mortgage application.
 |
| Process view |
Submit form
- Name: erics
- Address: somewhere
- SSN: 123456789
- Income: 80000
- Property Sale Price: 50000
- Down Payment: 30000
- Amorization: 10
Pre-loading JBoss BPM Suite with processes
A more interesting option has been provided to get you up and running with 16 process instances being pre-loaded into the JBoss BPM Suite in various states of completion, also giving a populated Business Activity Monitoring (BAM) with the Process & Task Dashboard.
# Once you have JBoss BPM Suite running, have built and deployed # the mortgage project, you can pre-fill the product with 16 # instances in various states by running the following command. # $ java -jar support/jboss-mortgage-demo-client.jar erics bpmsuite
You will then find 16 processes in your Process Management -> Process Instances view, also in the Tasks -> Tasks List views.
 |
| Task list, with task being worked on |
 |
| View the process variables of an instance |
For monitoring you can view the Process & Task Dashboard, especially as you claim and complete tasks from the Tasks List.
 |
| Monitoring dashboard (BAM), mock data, completed process |
This completes the quick overview, which gets you started on working with the JBoss BPM Suite product.
One final note, the entire demo is running in memory, so if you restart your JBoss BPM Suite, you will lose your process data, instances, etc. Just re-run the jar tooling discussed above to reset your installation.