/rhpam7-demo-template

Red Hat Process Automation Manager 7 Demo Template

Primary LanguagePowerShell

Red Hat Process Automation Manager Demo Template

Template from which we build Red Hat Process Automation Manager 7 demos.

To create a new demo, the user needs to:

  • Create a new project using this repo as a base.
  • Configure the properties files to configure the name of the demo, the location of the demo's Git repo, etc.
    • init-properties.sh
    • init-properties.ps1
    • support/openshift/provision-properties-static.sh
    • support/openshift/provision-properties-static.ps1
    • support/openshift/provision-properties-dynamic.sh
    • support/openshift/provision-properties-dynamic.ps1
  • Fix this README.md file to document the demo.
  • Add the demo's ".niogit" repository content (containing the system.git and spaces) to the directory support/rhpam7-demo-niogit.

Template

The documentation template starts below this line!!!!

There are three options available to you for using this demo; local, Docker and OpenShift.

Software

The following software is required to run this demo:

Option 1 - Install on your machine

  1. Download and unzip.

  2. Add products to installs directory.

  3. Run 'init.sh' (Linux/macOS) or 'init.ps1' (Windows) file.

  4. Start Red Hat Process Automation Manager by running 'standalone.sh' (Linux/macOS) or 'standalone.ps1' (Windows) in the /target/jboss-eap-7.1/bin directory.

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

    - login for admin, appraisor, broker, and manager roles (u:pamAdmin / p:redhatpam1!)

  6. The Mortgage_Demo project has been pre-installed in the MySpace spacethe installed and configured Red Hat Process Automation Manager 7 with the provisioned Mortgage Demo.

  7. To run the demo, click on the Deploy button in the Mortgage_Demo project. After a successful build, a process instance can be started from the Menu -> Manage -> Process Definitions screen.

Option 2 - Install on OpenShift

This demo can be installed on Red Hat OpenShift in various ways. We'll explain the different options provided.

All installation options require an oc client installation that is connected to a running OpenShift instance. More information on OpenShift and how to setup a local OpenShift development environment based on the Red Hat Container Development Kit can be found here.

NOTE

The Red Hat Process Automation Manager 7 - Business Central image requires a Persistent Volume which has both ReadWriteOnce (RWO) and ReadWriteMany (RWX) Access Types. If no PVs matching this description are available, deployment of that image will fail until a PV of that type is available.

Automated installation

This installation option will install the Process Automation Manager 7 and Process Service in OpenShift using a single script, after which the demo project needs to be manually imported.

  1. Download and unzip or clone this repo.

  2. Run the init-openshift.sh (Linux/macOS) or init-openshift.ps1 (Windows) file. This will create a new project and application in OpenShift.

  3. Login to your OpenShift console. For a local OpenShift installation this is usually: https://{host}:8443/console

  4. Open the project "RHPAM7 Mortgage Demo". Open the "Overview" screen. Wait until the 2 pods, "rhpam7-mortgage-rhpamcentr" and "rhpam7-mortgage-kieserver" have been deployed.

  5. Open the "Applications -> Routes" screen. Click on the "Hostname" value next to "rhpam7-mortgage-rhpamcentr". This opens the Business Central console.

  6. Login to Business Central (u:pamAdmin, p:redhatpam1!)

  7. The Mortgage_Demo project has been pre-installed in the MySpace spacethe installed and configured Red Hat Process Automation Manager 7 with the provisioned Mortgage Demo.

  8. To run the demo, click on the Deploy button in the Mortgage_Demo project. After a successful build, a process instance can be started from the Menu -> Manage -> Process Definitions screen.

Scripted installation

This installation option will install the Process Automation Manager 7 and Process Service in OpenShift using the provided provision.sh (Linux/macOS) or provision.ps1 (Windows) script, which gives the user a bit more control how to provision to OpenShift.

  1. Download and unzip. or clone this repo.

  2. In the demo directory, go to ./support/openshift. In that directory you will find the provision.sh (Linux/macOS) and provision.ps1 (Windows) script.

  3. Run ./provision.sh -h (Linux/macOS) or ./provision.ps1 -h (Windows) to inspect the installation options.

  4. To provision the demo, with the OpenShift ImageStreams in the project's namespace, run ./provision.sh setup rhpam7-mortgage --with-imagestreams (Linux/macOS) or ./provision.sh -command setup -demo rhpam7-mortgage -with-imagestreams (Windows)

    NOTE

    The with-imagestreams parameter installs the Process Automation Manager 7 image streams and templates into the project namespace instead of the openshift namespace (for which you need admin rights). If you already have the required image-streams and templates installed in your OpenShift environment in the openshift namespace, you can omit the with-imagestreams from the setup command.

  5. A second useful option is the --pv-capacity (Linux/macOS)/ -pv-capacity (Windows) option, which allows you to set the capacity of the Persistent Volume used by the Business Central component. This is for example required when installing this demo in OpenShift Online, as the Persistent Volume Claim needs to be set to 1Gi instead of the default 512Mi. So, to install this demo in OpenShift Online, you can use the following command: ./provision.sh setup rhpam7-mortgage --pv-capacity 1Gi --with-imagestreams (Linux/macOS) or ./provision.ps1 -command setup -demo rhpam7-mortgage -pv-capacity 1Gi -with-imagestreams (Windows).

  6. After provisioning, follow the instructions from above "Option 2 - Automated installation", starting at step 3.

  7. To delete an already provisioned demo, run ./provision.sh delete rhpam7-mortgage (Linux/macOS) or ./provision.ps1 -command delete -demo rhpam7-mortgage (Windows).

Option 3 - Install in a container

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

  1. Download and unzip.

  2. Add product installer to installs directory.

  3. Run the 'init-docker.sh' (Linux/macOS) or 'init-docker.ps1' (Windows) file.

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

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

  - login for admin, appraisor, broker, and manager roles (u:pamAdmin / p:redhatpam1!)

  1. The Mortgage_Demo project has been pre-installed in the MySpace spacethe installed and configured Red Hat Process Automation Manager 7 with the provisioned Mortgage Demo.

  2. To run the demo, click on the Deploy button in the Mortgage_Demo project. After a successful build, a process instance can be started from the Menu -> Manage -> Process Definitions screen.

Notes

The following functionality is covered:

  • One advanced process.

  • Four Human Tasks assigned to 3 different roles

  • Use of Swimlanes to assign a task to the user who previously took ownership

  • Several guide business rules

  • Several technical rules

  • A guided web decision table

  • Several Script Tasks for Java work

  • Exclusive use of the Red Hat PAM Data Modeler for creating the Java fact model

  • Use of graphic form designer to create 4 forms with an example of javascript validation

For 'Appraisal' task only, any claimed tasks that are not competed within a minute will be reassigned automatically back into the group for processing.

Note that the entire demo is running default in memory, restart server, lose your process instances, data, monitoring history.

Sources for the demo client jar can be found in the projects directory.

Supporting Articles

Released versions

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

Mortgage Process

RHPAM 7