amahdy/brms-coolstore-demo

Retail online web shopping cart example, the Cool Store demo leverages JBoss BRMS, JBoss Developer Studio, and Vaadin UI framework.

JBoss BRMS Suite Cool Store Demo

This is a retail web store demo where you will find rules, decision tables, events, and a ruleflow that is leveraged by a web application. The web application is a WAR built using the JBoss BRMS generated project as a dependency, providing an example project showing how developers can focus on the application code while the business analysts can focus on rules, events, and ruleflows in the JBoss BRMS product web based dashboard.

This demo is self contained, it uses a custom maven settings to deploy all built JBoss BRMS knowledge artifacts into an external maven repository (not your local repository), in /tmp/maven-repo.

There are four options available to you for using this demo; local, Docker, Openshift Online and Red Hat CDK OpenShift Enterprise.

Software

The following software is required to run this demo:

• JBoss EAP 7.0 installer
• JBoss BRMS 6.4.0.GA deployable for EAP 7
• Git client
• Maven 3.2+
• 7-Zip (Windows only): to overcome the Windows 260 character path length limit, we need 7-Zip to unzip the BRMS deployable.

Option 1 - Install on your machine

1. Download and unzip.

2. Add products to installs directory.

3. Run 'init.sh' or 'init.bat' file. 'init.bat' must be run with Administrative privileges.

4. Start JBoss BRMS Server by running ./target/jboss-eap-7.0/bin/standalone.sh

5. Login to http://localhost:8080/business-central

   - login for admin and analyst roles (u:brmsAdmin / p:jbossbrms1!)
   

6. Build and deploy project. To do this, click on 'Authoring -> Project Authoring', this will open the 'Project Authoring' view. Click on the 'Open Project Editor' button, which opens the project editor. Now, click on the 'Build -> Build & Deploy' button, which can be found on the right-hand side of the project editor window.

7. Open shopping cart and demo away (http://localhost:8080/brms-coolstore-demo)

Option 2 - Run in Docker

The following steps can be used to configure and run the demo in a container

1. Download and unzip.

2. Add the EAP installer and BPM Suite deployable to installs directory.

3. Run the 'init-docker.sh' or 'init-docker.ps1' file.

4. Start the container: docker run -it -p 8080:8080 -p 9990:9990 jbossdemocentral/brms-coolstore-demo

5. Login to http://<DOCKER_HOST>:8080/business-central

   - login for admin and analyst roles (u:brmsAdmin / p:jbossbrms1!)
   

6. Open shopping cart and demo away (http://<DOCKER_HOST>:8080/brms-coolstore-demo)

Additional information can be found in the jbossdemocentral container developer repository

Option 3 - Install with one click in xPaaS (brmsPaaS)

After clicking button, ensure Gear size is set to large:


Once installed you can use the JBoss BRMS logins:

• u:erics p: jbossbrms1! (admin)

• u: alan p: jbossbrms1! (analyst)

Current hosting of brmsPaaS is on JBoss BRMS 6.0.2 in OpenShift Online.

Option 4 - Install on Red Hat CDK OpenShift Enterprise image

The following steps can be used to install this demo on OpenShift Enterprise using the Red Hat Container Development Kit (CDK)

1. App Dev Cloud with JBoss Cool Store Demo

2. App Dev Cloud with JBoss Cool Store Persistence Demo

Notes

The web application (shopping cart) is built during demo installation with a provided coolstore project jar version 2.0.0. When you open the project you will find the version is also set to 2.0.0. You can run the web application as is, but if you build and deploy a new version of 2.0.0 to your maven repository it will find duplicate rules. To demo you deploy a new version of the coolstore project by bumping the version number on each build and deploy, noting the KieScanner picking up the new version within 10 seconds of a new deployment. For example, initially start project, bump the version to 3.0.0, build and deploy, open web application and watch KieScanner in server logs pick up the 3.0.0 version. Now change a shipping rule value in decision table, save, bump project version to 4.0.0, build and deploy, watch for KieScanner picking up new 4.0.0 version, now web application on next run will use new shipping values.

Supporting Articles

• JBoss BRMS Cool Store UI gets Vaadin facelift

• 7 Steps to Your First Rules with JBoss BRMS Starter Kit

• 3 shockingly easy ways into JBoss rules, events, planning & BPM

• Jump Start Your Rules, Events, Planning and BPM Today

• 4 Foolproof Tips Get You Started With JBoss BRMS 6.0.3

• How to Use Rules and Events to Drive JBoss BRMS Cool Store for xPaaS

• Red Hat JBoss BRMS - all product demos updated for version 6.0.2.GA release

• [Red Hat JBoss BRMS 6 - Demo Cool Store Dynamic Rule Updates (video)] (http://www.schabell.org/2014/05/redhat-jboss-brms6-demo-coolstore-dynamic-rule-updates.html)

• [Red Hat JBoss BRMS 6 - The New Cool Store Demo] (http://www.schabell.org/2014/03/redhat-jboss-brms-v6-coolstore-demo.html)

• [JBoss BRMS Cool Store Demo updated with EAP 6.1.1] (http://www.schabell.org/2013/09/jboss-brms-coolstore-demo-updated-eap-611.html)

• [A shopping cart example in the Cool Store Demo] (http://www.schabell.org/2013/04/jboss-brms-coolstore-demo.html)

• [Cool Store installation video part I] (http://www.schabell.org/2013/05/jboss-brms-coolstore-demo-video-partI.html)

• [Cool Store CEP and Rules video part II] (http://www.schabell.org/2013/05/jboss-brms-coolstore-demo-video-partII.html)

• [Cool Store BPM and Decision Tables video part III] (http://www.schabell.org/2013/05/jboss-brms-coolstore-demo-video-partIII.html)

Released versions

See the tagged releases for the following versions of the product:

• v3.8 JBoss BRMS 6.4.0.GA on JBoss EAP 7.0.0.GA with cool store installed and RH CDK on OSE Cloud install option.

• v3.7 JBoss BRMS 6.3.0 on JBoss EAP 6.4.7 with cool store installed and RH CDK on OSE Cloud install option.

• v3.6 JBoss BRMS 6.2.0-BZ-1299002 on JBoss EAP 6.4.4 with cool store installed and RH CDK on OSE Cloud install option.

• v3.5 JBoss BRMS 6.2.0-BZ-1299002 on JBoss EAP 6.4.4 with cool store installed.

• v3.4 JBoss BRMS 6.2.0, JBoss EAP 6.4.4 and OSE aligned containerization.

• v3.3 JBoss BRMS 6.2.0, JBoss EAP 6.4.4 and cool store installed, UI updated to Vaadin 7.6.0.

• v3.2 JBoss BRMS 6.2.0, JBoss EAP 6.4.4 and cool store installed, UI updated to Vaadin 7.

• v3.1 JBoss BRMS 6.2.0, JBoss EAP 6.4.4 and cool store installed.

• v3.0 JBoss BRMS 6.1.1 (patch update applied) with cool store installed and Albert Wong updates for JBDS project importing.

• v2.9 JBoss BRMS 6.1.1 (patch update applied) with cool store installed.

• v2.8 JBoss BRMS 6.1 with cool store installed.

• v2.7 JBoss BRMS 6.0.3 installer with cool store configured to scan external maven repository.

• v2.6 JBoss BRMS 6.0.3 installer with cool store updated so that project unit tests running again.

• v2.5 JBoss BRMS 6.0.3 with optional containerized installation.

• v2.4 moved to JBoss Demo Central, with updated windows init.bat support and one click install button.

• v2.3 JBoss BRMS 6.0.3 installer with cool store demo installed.

• v2.2 JBoss BPM Suite 6.0.2, JBoss EAP 6.1.1, cool store demo installed.

• v2.1 JBoss BPM Suite 6.0.1, JBoss EAP 6.1.1, cool store demo installed.

• v2.0 JBoss BPM Suite 6.0.0, JBoss EAP 6.1.1, cool store demo installed.

• v1.4 is BRMS 5.3.1 deployable, running on JBoss EAP 6.1.1, integrated BRMS maven repo into project so no longer need to add to personal settings configuration which fully automates project build.

• v1.3 is BRMS 5.3.1 deployable, running on JBoss EAP 6.1.1, and added Forge Laptop Sticker to store.

• v1.2 is BRMS 5.3.1 deployable, running on JBoss EAP 6.1, mavenized using JBoss repo.

• v1.1 new welcome screen and doc fixes.

• v1.0 is BRMS 5.3.1 deployable, running on JBoss EAP 6.