Eric D. Schabell: July 2012

Friday, July 13, 2012

JBoss BRMS 5.3 - adding on Business Activity Monitoring (BAM) Reporting

One of the most often asked question since the release of the JBoss BRMS 5.3 product which has added the jBPM 5 BPM component is that of Business Activity Monitoring (BAM) and Reporting features. This article will walk you through the process of adding it, but be aware, this is not a supported feature of the product at the time of this writing.


Adding on BAM Reporting to JBoss BRMS 5.3
  1. Install JBoss BRMS 5.3, download from the Customer Portal.
  2. Create a birt directory at the following location JBOSS_HOME/server/default/data/birt/
  3. Create the ReportEngine and output directories in the birt directory from step 2 as follows:
    • JBOSS_HOME/server/default/data/birt/ReportEngine/
    • JBOSS_HOME/server/default/data/birt/ouput/
  4. Download birt-runtime-2_3_2_2 runtime jar from the following location:
  5. Unzip birt-runtime-2_3_2_2/ReportEngine into the JBOSS_HOME/server/default/data/birt/ReportEngine/ directory.
  6. Download overall_activity.rptdesign and process_summary.rptdesign report design files from the following location:
    • https://github.com/droolsjbpm/jbpm/tree/5.3.x/jbpm-installer/report/2_3_2_2
    • Copy the files to JBOSS_HOME/server/default/data/birt/
  7. Copy h2.jar from /jbpm/lib to the JBOSS_HOME/server/default/data/birt/ReportEngine/plugins/org.eclipse.birt.report.data.oda.jdbc_2.3.2.r232_v20090212/drivers/ directory.
  8. Delete report-core-1.4.0-SNAPSHOT.jar and report-shared-1.4.0-SNAPSHOT.jar from the JBOSS_HOME/server/default/deploy/business-central-server.war/WEB-INF/lib/ directory.
  9. Download the following jars and copy them to the JBOSS_HOME/server/default/deploy/business-central-server.war/WEB-INF/lib/ directory.
    • report-core-1.3.0.jar
      • https://repository.jboss.org/nexus/content/repositories/releases/org/jboss/bpm/report-core/1.3.0/report-core-1.3.0.jar
    • report-shared-1.3.0.jar
      • https://repository.jboss.org/nexus/content/repositories/releases/org/jboss/bpm/reportshared/1.3.0/report-shared-1.3.0.jar
    • engineapi-2.3.2.jar
      • http://repository.jboss.org/nexus/content/groups/public/org/eclipse/birt/engineapi/2.3.2/engineapi-2.3.2.jar
    • dteapi-2.3.2.jar
      • http://repository.jboss.org/nexus/content/groups/public/org/eclipse/birt/dteapi/2.3.2/dteapi-2.3.2.jar
    • chartengineapi-2.3.2.jar
      • http://repository.jboss.org/nexus/content/groups/public/org/eclipse/birt/chartengineapi/2.3.2/chartengineapi-2.3.2.jar
    • coreapi-2.3.2.jar
      • http://repository.jboss.org/nexus/content/groups/public/org/eclipse/birt/coreapi/2.3.2/coreapi-2.3.2.jar
    • dataadapterapi-2.3.2.jar
      • http://repository.jboss.org/nexus/content/groups/public/org/eclipse/birt/dataadapterapi/2.3.2/dataadapterapi-2.3.2.jar
    • modelapi-2.3.2.jar
      • http://repository.jboss.org/nexus/content/groups/public/org/eclipse/birt/modelapi/2.3.2/modelapi-2.3.2.jar
    • scriptapi-2.3.2.jar
      • http://repository.jboss.org/nexus/content/groups/public/org/eclipse/birt/scriptapi/2.3.2/scriptapi-2.3.2.jar
    • ecore-2.4.2.jar
      • http://repository.jboss.org/nexus/content/groups/public/org/eclipse/emf/ecore/2.4.2/ecore-2.4.2.jar
    • ecore-xmi-2.4.1.jar
      • http://repository.jboss.org/nexus/content/groups/public/org/eclipse/emf/ecore-xmi/2.4.1/ecorexmi-2.4.1.jar
    • common-2.4.0.jar
      • http://repository.jboss.org/nexus/content/groups/public/org/eclipse/emf/common/2.4.0/common-2.4.0.jar
    • flute-1.2.jar
      • http://repository.jboss.org/nexus/content/groups/public/org/w3c/flute/1.2/flute-1.2.jar
    • sac-1.3.jar
      • http://repository.jboss.org/nexus/content/groups/public/org/w3c/sac/1.3/sac-1.3.jar
    • commons-cli-1.0.jar
      • http://repo1.maven.org/maven2/commons-cli/commons-cli/1.0/commons-cli-1.0.jar
    • commons-discovery-0.2.jar
      • http://repo1.maven.org/maven2/commons-discovery/commons-discovery/0.2/commonsdiscovery-0.2.jar
    • itext-1.3.jar
      • http://repo1.maven.org/maven2/com/lowagie/itext/1.3/itext-1.3.jar
    • icu4j-3.8.1.jar
      • http://repository.jboss.org/nexus/content/groups/public/com/ibm/icu/icu4j/3.8.1/icu4j-3.8.1.jar
    • js-1.6R2.jar
      • http://repo1.maven.org/maven2/rhino/js/1.6R2/js-1.6R2.jar
To view the reports in the Business Central Console go to http://localhost:8080/business-central and
log on, see the JBoss BRMS Getting Started Guide for further details.

To collect the Business Activity Monitoring performance parameters for a task or process, first run
the task or process, and then click on the reports tab on the left pane. This will open the report
configuration tab in the right pane. Select ‘overall_activity’ from the drop down and click create to view
the report on the performance parameters of the executed process.

Install BIRT plugin into JBoss Developer Studio (JBDS)
  1. Open JBDS and select Help → Install New Software.
  2. In the Work with text box enter BIRT Update Site – http://download.eclipse.org/birt/updtae-site/3.7 and click ADD....
  3. The following packages should be listed for selection:
    • BIRT 3.7 Charting SDK
    • BIRT 3.7 Engine OSGI Runtime SDK
    • BIRT 3.7 Reporting SDK
    • BIRT 3.7 WTP Integration SDK
  4. Select all and click next. Follow the instructions on the installation screen.
  5. Restart JBDS
Enjoy!

Chinese translation post by Christina Lin.

The Intelligent, Integrated Shipping Company (JBoss BRMS)

There is nothing like a great video to start your day. Are you interested in pushing your business to new heights? Are you looking for ways to integrate business logic, process flows and handle complex events within your organization?

Get a cup of coffee, kick back, put your feet up and spend the next 3 minutes enjoying this story.

The Intelligent, Integrated Shipping Company

Friday, July 6, 2012

Devoxx 2012 CFP - Process your pants off with BPM Web-based tooling

I have been working and going to Devoxx for some years now. I have always had too much booth duty to want to submit a talk. This year I am not working it, so I wanted to submit a talk to Devoxx as a tooling talk.


Process your pants off with BPM Web-based tooling
In this session we will take a deep dive into the JBoss BPM Web-based tooling  (JBoss BRMS based Process Designer, Asset Manager, Business Central). We will go over a number of live demos which show how these tools can be utilized to increase the agility and dynamic nature of BPM efforts as well as provide subject-matter experts and technical experts a greater role in modelling, managing, and executing business processes.

Tuesday, July 3, 2012

JBoss BRMS 5.3 running in OpenShift Origin on JBoss EAP 6

After some polish and shine, we now have for you to demo, play with or just take with you to your next customer visit a fully running JBoss BRMS instance running on the brand new JBoss EAP 6!

Note: this is a running instance with no SLA, might be down, might be up, I will try to keep it running full time. Just let me know if it goes down after a new OpenShift release (they happen almost every two weeks) and I will reset it for you.

This includes the knowledge artifact repository, the BRM component and the BPMN2 web designer. There is also a demo repository zip file provided so you can import a complete demo package that is designed to evaluate customers as previously posted. The login is user 'admin' and password 'brms'.

You can replicate this in your very own instance of OpenShift (called a gear) by following the README found in the project repository.

PS. A word of thanks to kbhattac who created the initial brms53 repo in his project space.

Here's how you do it:


Running on OpenShift

Create an account at http://openshift.redhat.com/
Create a jbosseap-6.0 application
rhc app create -a brms53 -t jbosseap-6.0
Add this upstream openshift-brms53 repo.
cd brms53
git remote add upstream -m master https://github.com/eschabell/openshift-brms53.git
git pull -s recursive -X theirs upstream master
Then push the repo upstream
git push
That's it, you can now checkout your application at:
http://brms53-$your_domain.rhcloud.com
But you are not done... there is a configuration step needed right now until we sort out the OpenShift variable needed to identify this gears among a few other things. See the following Configuration Notes to get this finished. We hope to automate these steps soon.
CONFIGURATION NOTES:
This project was fully researched and created initially by Kaushik Bhattacharya, give him a shout of thanks over at his project headquarters:https://github.com/kbhattac/brms53
Some steps:
1) You need to specify the jackrabbit repo location in components.xml of jboss-brms.war. It should be configured to use Openshift environment variables, on TODO list. For now you can find it in the UUID displayed in this command:
rhc app show -a brms5.3

Application Info
================
brms53
Framework: jbossas-7
Creation: 2012-06-24T08:44:30-04:00
UUID: [some-big-number-here]
Git URL: ssh://[some-big-number-here]@brms53-onthe.rhcloud.com/~/git/brms53.git/
Public URL: http://brms53-$your_domain.rhcloud.com/
Embedded: None
So in this case, need to add in the UUID number to the componets.xml.
2) You need modify the host ip in profiles/jbpm.xml in designer.war It should have the value of $OPENSHIFT_INTERNAL_IP, which you can find by ssh'ing into the instance, then running cmd 'export' to find variable. Put that value in the host attribute:
<!-- update host, ssh into instance, run cmd 'export', locate variable OPENSHIFT_INTERNAL_IP, fill in for host.  -->
<externalloadurl protocol="http" host="127.8.133.1:8080" subdomain="jboss-brms/org.drools.guvnor.Guvnor/oryxeditor" usr="admin" pwd="brms"/ -->
3) Due to memory issues, deploying jboss-brms.war and designer.war at the same time doesn't work. So by default, we have configured only jboss-brms.war to deploy automatically. After jboss-brms.war is deployed, you need to rename the file 'designer.war.dodeploy.delayed' to 'designer.war.dodeploy' to trigger the deployment of the designer app.
$ ssh [UUID]@brms53-$your_domain.rhcloud.com
$ mv brms53/jbosseap-6.0/standalone/deployments/designer.war.dodeploy.delayed  /
     brms53/jbosseap-6.0/standalone/deployments/designer.war.dodeploy
You should see the web designer war deploy if you are watching the logs:
$ rhc-tail-files -a brms53
That is really it now, once it starts up your BRMS 5.3 product is available at:
http://brms53-$your_domain.rhcloud.com/jboss-brms
Finally, you can import the demo application by importing the file import_demo_to_brms.zip into the Administration -> Import Export tab from the console.

Chinese translation available by Christina Lin.

Devoxx 2012 CFP - OpenShift State of the Union

I have been working and going to Devoxx for some years now. I have always had too much booth duty to want to submit a talk. This year I am not working it, so I wanted to submit a talk to Devoxx as a conference talk.

As I am working on a book in this area, I wanted to run some of the material past an audience. Hope we get the chance to go through this talk together.

OpenShift State of the Union
There are plenty of clouds and platform-as-a-services to choose from, but where to start?


Join us for an action-packed hour of power where we'll show you how to deploy an application written in the language of your choice - Java, Ruby, PHP, Perl or Python, with the framework of your choice - EE6, CDI, Seam, Spring or Rails to the OpenShift PaaS in just minutes. All without having to rewrite your app to get it to work as the cloud provider thinks it should work.


We will focus on examples that highlight what OpenShift has to offer, how to get started, & provide example projects that you can access now. Bring your laptop & follow along as we help you get started with Aerogears, Drools Planner, BRMS, Switchyard & much more. Real world projects put on display for you with code you can access live during this session.


If you want to learn how the OpenShift PaaS & investing an hour of your time can change everything you thought you knew about developing apps in the cloud, this session is for you!

Monday, July 2, 2012

Telling an Integration & BPM story at GOTO Aarhus 2012

I will get to tell an Integration & BPM product story at the GOTO Aarhus 2012 Conference in Denmark this coming October 1-3. I will be there with Mark Little, so make sure you drop by and chat with us at the stand.

I will update this post with details as I find out. Abstract soon to follow but I hope to cover some of the new Integration & BPM products that we have been releasing in a furious tempo of late. Things like JBoss BRMS, SOA-P and EDS-P.

Stay tuned!