44
Red Hat Process Automation Manager 7.0 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 7.1 Last Updated: 2018-08-24

Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

  • Upload
    others

  • View
    70

  • Download
    2

Embed Size (px)

Citation preview

Page 1: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

Red Hat Process Automation Manager70

Installing and configuring Red Hat ProcessAutomation Manager on Red Hat JBoss EAP 71

Last Updated 2018-08-24

Red Hat Process Automation Manager 70 Installing and configuring Red

Hat Process Automation Manager on Red Hat JBoss EAP 71

Red Hat Customer Content Servicesbrms-docsredhatcom

Legal Notice

Copyright copy 2018 Red Hat Inc

The text of and illustrations in this document are licensed by Red Hat under a Creative CommonsAttributionndashShare Alike 30 Unported license (CC-BY-SA) An explanation of CC-BY-SA isavailable athttpcreativecommonsorglicensesby-sa30 In accordance with CC-BY-SA if you distribute this document or an adaptation of it you mustprovide the URL for the original version

Red Hat as the licensor of this document waives the right to enforce and agrees not to assertSection 4d of CC-BY-SA to the fullest extent permitted by applicable law

Red Hat Red Hat Enterprise Linux the Shadowman logo JBoss OpenShift Fedora the Infinitylogo and RHCE are trademarks of Red Hat Inc registered in the United States and othercountries

Linux reg is the registered trademark of Linus Torvalds in the United States and other countries

Java reg is a registered trademark of Oracle andor its affiliates

XFS reg is a trademark of Silicon Graphics International Corp or its subsidiaries in the UnitedStates andor other countries

MySQL reg is a registered trademark of MySQL AB in the United States the European Union andother countries

Nodejs reg is an official trademark of Joyent Red Hat Software Collections is not formally relatedto or endorsed by the official Joyent Nodejs open source or commercial project

The OpenStack reg Word Mark and OpenStack logo are either registered trademarksservice marksor trademarksservice marks of the OpenStack Foundation in the United States and othercountries and are used with the OpenStack Foundations permission We are not affiliated withendorsed or sponsored by the OpenStack Foundation or the OpenStack community

All other trademarks are the property of their respective owners

Abstract

This document describes how to install Red Hat Process Automation Manager on a Red Hat JBossEAP 71 installation

Table of Contents

PREFACE

CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER

CHAPTER 2 ROLES AND USERS

CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER41 USING THE INSTALLER IN INTERACTIVE MODE42 USING THE INSTALLER IN CLI MODE43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGERCONTROLLER

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE52 INSTALLING PROCESS SERVER FROM THE ZIP FILE53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER54 CREATING USERS55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGERCONTROLLER

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER711 Creating a controller user712 Configuring Process Server and the headless Process Automation Manager controller

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL81 SUPPORTED PROPERTIES

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT91 MODIFY THE MAVEN SETTINGS FILE92 MODIFY THE MAVEN POM FILE

CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

CHAPTER 13 INTEGRATING LDAP AND SSL

CHAPTER 14 RELATED INFORMATION

CHAPTER 15 NEXT STEPS

APPENDIX A VERSIONING INFORMATION

3

4

5

6

77

10

11

1313141416

17

20

2121222224

2526

292929

34

35

363636

37

38

39

40

Table of Contents

1

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

2

PREFACEThis document describes how to install Red Hat Process Automation Manager on a Red Hat JBossEnterprise Application Platform 71 instance

Prerequisite

Review the information in Planning a Red Hat Process Automation Manager installation

PREFACE

3

CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATIONMANAGER

Red Hat Process Automation Manager is the Red Hat middleware platform for creating businessautomation applications and microservices It enables enterprise business and IT users to documentsimulate manage automate and monitor business processes and policies It is designed to empowerbusiness and IT users to collaborate more effectively so business applications can be changed easilyand quickly

Red Hat JBoss Enterprise Application Platform (Red Hat JBoss EAP) 71 is a certified implementationof the Java Enterprise Edition 7 (Java EE 7) full and web profile specifications Red Hat JBoss EAPprovides preconfigured options for features such as high availability clustering messaging anddistributed caching It also enables users to write deploy and run applications using the various APIsand services that Red Hat JBoss EAP provides

The instructions in this document explain how to install Red Hat Process Automation Manager in a RedHat JBoss EAP 71 server instance For instruction on how to install Red Hat Process AutomationManager in other environments see the following documents

Installing and configuring Process Server on IBM WebSphere Application Server

Installing and configuring Process Server on Oracle WebLogic Server

Deploying a Red Hat Process Automation Manager 70 authoring environment on Red Hat OpenShiftContainer Platform

Deploying a Red Hat Process Automation Manager 70 immutable server environment on Red HatOpenShift Container Platform

Deploying a Red Hat Process Automation Manager 70 managed server environment on Red HatOpenShift Container Platform

For information on supported components see the following documents What is the mappingbetween RHPAM product and maven library version Red Hat Process Automation Manager 7Supported Configurations

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

4

CHAPTER 2 ROLES AND USERSTo access Business Central or Process Server you must create users and assign them appropriateroles before the servers are started This section describes available Red Hat Process AutomationManager user roles

NOTE

The admin analyst developer manager process-admin user and rest-allroles are reserved for Business Central The kie-server role is reserved for ProcessServer For this reason the available roles can differ depending on whether BusinessCentral Process Server or both are installed

admin Users with the admin role are the Business Central administrators They can manageusers and create clone and manage the repositories They have full access to make requiredchanges in the application Users with the admin role have access to all areas within Red HatProcess Automation Manager

analyst Users with the analyst role have access to all high-level features They can modeland execute their projects However these users cannot add contributors to spaces or deletespaces in the Design rarr Projects view Access to the Deploy rarr Execution Servers view whichis intended for administrators is not available to users with the analyst role However theDeploy button is available to these users when they access the Library perspective

developer Users with the developer role have access to almost all features and canmanage rules models process flows forms and dashboards They can manage the assetrepository they can create build and deploy projects and they can use Red Hat JBossDeveloper Studio to view processes Only certain administrative functions such as creatingand cloning a new repository are hidden from users with the developer role

manager Users with the manager role can view reports These users are usually interested instatistics about the business processes and their performance business indicators and otherbusiness-related reporting A user with this role has access only to process and task reports

process-admin Users with the process-admin role are business process administratorsThey have full access to business processes business tasks and execution errors These userscan also view business reports and have access to the Task Inbox list

user Users with the user role can work on the Task Inbox list which contains business tasksthat are part of currently running processes Users with this role can view process and taskreports and manage processes

rest-all Users with the rest-all role can access Business Central REST capabilities

kie-server Users with the kie-server role can access Process Server (KIE Server) RESTcapabilities This role is mandatory for users to have access to Manage and Track views inBusiness Central

CHAPTER 2 ROLES AND USERS

5

CHAPTER 3 DOWNLOADING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION FILES

Depending on your environment and installation requirements download a Red Hat ProcessAutomation Manager distribution

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download one of the following product distributions

To use the installer to install Red Hat Process Automation Manager on Red Hat JBoss EAP71 download Red Hat Process Automation Manager 700 Installer (rhpam-installer-700jar) The installer graphical user interface guides you through theinstallation process

To install Red Hat Process Automation Manager on Red Hat JBoss EAP 71 using thedeployable zip files download the following files

Red Hat Process Automation Manager 700 Process Server for All Supported EE7Containers (rhpam-700-kie-server-ee7zip)

Red Hat Process Automation Manager 700 Business Central Deployable for EAP 7(rhpam-700-business-central-eap7-deployablezip)

The ZIP files do not require a graphical user interface so you can install Red Hat ProcessAutomation Manager using SSH

To run Business Central without needing to deploy it to an application server downloadRed Hat Process Automation Manager 700 Decision Central Standalone (rhpam-700-business-central-standalonejar)

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

6

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATIONMANAGER INSTALLER

This section describes how to install Process Server and the headless Process Automation Managercontroller using the installer JAR file The JAR file is an executable file that installs Red Hat ProcessAutomation Manager in an existing Red Hat JBoss EAP 71 server installation You can run the installerin interactive or command line interface (CLI) mode

NOTE

The Red Hat Process Automation Manager JAR file installer does not support the RedHat JBoss EAP distribution installed by yum or RPM Package Manager If you want toinstall Red Hat Process Automation Manager in this type of Red Hat JBoss EAPinstallation download the Red Hat Process Automation Manager 70 Deployable forRed Hat JBoss EAP 71 file and follow the steps in Chapter 5 Installing Red Hat ProcessAutomation Manager from ZIP files

NOTE

Because IBM JDK cannot use keystores generated on other JDKs you cannot installRed Hat Process Automation Manager into an existing Red Hat JBoss EAP installationrunning on IBM JDK with a keystore generated on another JDK

Next steps

Follow the instructions in one of the following sections

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

Section 43 ldquoUsing the installer to configure Process Server with the Process AutomationManager controllerrdquo

41 USING THE INSTALLER IN INTERACTIVE MODE

The installer for Red Hat Process Automation Manager is an executable JAR file You can use it toinstall Red Hat Process Automation Manager in an existing Red Hat JBoss EAP 71 server installation

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in $PATH environment variable On Red Hat Enterprise Linux it isincluded in the java-$JAVA_VERSION-openjdk-devel package

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

7

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer JAR file andenter the following command

java -jar rhpam-installer-700jar

NOTE

When running the installer on Windows you may be prompted to provideadministrator credentials during the installation To prevent this requirementadd the izpackmode=privileged option to the installation command

java -Dizpackmode=privileged -jarrhpam-installer-700jar

Furthermore when running the installer on a 32-bit Java virtual machine youmight encounter memory limitations To prevent this issue run this command

java -XXMaxHeapSize=4g -jarrhpam-installer-700jar

The graphical installer displays a splash screen and a license agreement page

2 Click I accept the terms of this license agreement and click Next

3 Specify the Red Hat JBoss EAP 71 server home where you want to install Red Hat ProcessAutomation Manager and click Next

4 Select the components that you want to install and click Next

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments To do this run the installer twice

5 Create a user and click Next By default the new user is given the admin kie-server and rest-all roles To select another role deselect admin For more information see Chapter 2Roles and users

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

8

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

Make a note of the user name and password You will need them to access Business Centraland Process Server

6 On the Installation Overview page click Next to start the installation The InstallationOverview page lists the components that you will install

7 When the installation has completed click Next

8 On the Configure Runtime Environment page choose whether to perform the defaultinstallation or perform an advanced configurationIf you choose Perform advanced configuration you can choose to configure databasesettings or customize certain Process Server options

9 If you selected Customize database settings on the JDBC Drive Configuration page specifya data source JDBC driver vendor select one or more Driver JAR files and click NextA data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the datasource on the Java Naming and Directory Interface (JNDI) tree or in the local applicationcontext and request a database connection to retrieve data You must configure data sourcesfor Process Server to ensure proper data exchange between the servers and the designateddatabase

10 If you selected Customize Process Server settings change any of the following if desired

Change the name of the Process Server property

Change the URL of the controller

Deselect any Process Server server options

11 Click Next to configure the runtime environment

12 When Processing finished appears at the top of the screen click Next to complete theinstallation

13 If desired click Generate Installation Script and Properties File to save the installation datain an XML file then click Done You can use this file to automatically install Red Hat ProcessAutomation Manager on the same type of server Note that you must change the installpath parameter in the XML file to specify the path of the new server that you want toinstall Red Hat Process Automation Manager on Enter the following command to perform aninstallation with the XML file

java -jar rhpam-installer-700jar ltpath-to-filegt

You have successfully installed Red Hat Process Automation Manager using the installer If youinstalled only Business Central repeat these steps to install Process Server on a separate server

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

9

42 USING THE INSTALLER IN CLI MODE

You can run the Red Hat Process Automation Manager installer through the command-line interface(CLI)

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in the $PATH environment variable On Red Hat Enterprise Linux itis included in the java-$JAVA_VERSION-openjdk-devel package

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer file andenter the following command

java -jar rhpam-installer-700jar -console

The command-line interactive process will start and display the End-User License Agreement

press 1 to continue 2 to quit 3 to redisplay

2 Read the license agreement enter 1 and press Enter to continue

Specify the home directory of one of the following servers Red Hat JBoss EAP 71 or Red Hat JBoss Web Server 50

3 Enter the parent directory of an existing Red Hat JBoss EAP 71 installationThe installer will verify the location of the installation at the location provided Enter 1 toconfirm and continue

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments

4 Follow the instructions in the installer to complete the installation

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

10

NOTE

When you create the user name and password make sure that the specified username does not conflict with any known title of a role or a group For example ifthere is a role called admin you should not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character (not including the character amp)

Make a note of the user name and password You will need them to accessBusiness Central and Process Server

5 When the installation has completed you will see this message

Would you like to generate an automatic installation script and properties file

6 Enter y to create an XML file that contains the installation data or n to complete theinstallation If you enter y you are prompted to specify a path for the XML file

7 Enter a path or press the Enter key to accept the suggested path

8 If you installed only Business Central repeat these steps to install Process Server on aseparate server

43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITHTHE PROCESS AUTOMATION MANAGER CONTROLLER

Process Server can be managed by the Process Automation Manager controller or it can beunmanaged If Process Server is unmanaged you must manually create and maintain containers IfProcess Server is managed the Process Automation Manager controller manages the Process Serverconfiguration and you interact with the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

You can use the installer in interactive or CLI mode to install Business Central and Process Server andthen configure Process Server with the Process Automation Manager controller

NOTE

If you do not install Business Central see Chapter 7 Installing and running the headlessProcess Automation Manager controller for information about using the headless ProcessAutomation Manager controller

Prerequisites

Two computers with backed-up Red Hat JBoss EAP 71 or higher server installations areavailable

Sufficient user permissions to complete the installation are granted

Procedure

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

11

1 On the first computer run the installer in interactive mode or CLI mode See one of thefollowing sections for more information

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

2 On the Component Selection page clear the Process Server box

3 Complete the Business Central installation

4 On the second computer run the installer in interactive mode or CLI mode

5 On the Component Selection page clear the Business Central box

6 On the Configure Runtime Environment page select Perform Advanced Configuration

7 Select Customize Process Server properties and click Next

8 On the Process Server Properties Configuration page click New Server Configuration to adda Process Server and specify a unique name for that Process Server This name will appear inBusiness Central and enable you to distinguish between different Process Servers

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

12

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATIONMANAGER FROM ZIP FILES

The Red Hat Process Automation Manager ZIP files (one for Business Central and one for ProcessServer) do not require a graphical user interface so you can install Red Hat Process AutomationManager using SSH

NOTE

You should install Business Central and the Process Server on different servers inproduction environments

For information about installing the headless Process Automation Manager controllersee Chapter 7 Installing and running the headless Process Automation Manager controller

51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE

Business Central is a web console that enables you to perform the following tasks over individualcomponents in a unified web-based environment

Create manage and edit your rules processes and related assets

Manage connected Process Server instances and their containers

Execute runtime operations against processes and tasks in Process Server instancesconnected to Business Central

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-business-central-eap7-deployablezip

Procedure

1 Extract the rhpam-700-business-central-eap7-deployablezip file to atemporary directory In the following examples this directory is called TEMP_DIR

2 Copy the contents of the TEMP_DIRrhpam-700-business-central-eap7-deployablejboss-eap-71 directory to EAP_HOME When prompted merge or replacefiles

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

13

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 2: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

Red Hat Process Automation Manager 70 Installing and configuring Red

Hat Process Automation Manager on Red Hat JBoss EAP 71

Red Hat Customer Content Servicesbrms-docsredhatcom

Legal Notice

Copyright copy 2018 Red Hat Inc

The text of and illustrations in this document are licensed by Red Hat under a Creative CommonsAttributionndashShare Alike 30 Unported license (CC-BY-SA) An explanation of CC-BY-SA isavailable athttpcreativecommonsorglicensesby-sa30 In accordance with CC-BY-SA if you distribute this document or an adaptation of it you mustprovide the URL for the original version

Red Hat as the licensor of this document waives the right to enforce and agrees not to assertSection 4d of CC-BY-SA to the fullest extent permitted by applicable law

Red Hat Red Hat Enterprise Linux the Shadowman logo JBoss OpenShift Fedora the Infinitylogo and RHCE are trademarks of Red Hat Inc registered in the United States and othercountries

Linux reg is the registered trademark of Linus Torvalds in the United States and other countries

Java reg is a registered trademark of Oracle andor its affiliates

XFS reg is a trademark of Silicon Graphics International Corp or its subsidiaries in the UnitedStates andor other countries

MySQL reg is a registered trademark of MySQL AB in the United States the European Union andother countries

Nodejs reg is an official trademark of Joyent Red Hat Software Collections is not formally relatedto or endorsed by the official Joyent Nodejs open source or commercial project

The OpenStack reg Word Mark and OpenStack logo are either registered trademarksservice marksor trademarksservice marks of the OpenStack Foundation in the United States and othercountries and are used with the OpenStack Foundations permission We are not affiliated withendorsed or sponsored by the OpenStack Foundation or the OpenStack community

All other trademarks are the property of their respective owners

Abstract

This document describes how to install Red Hat Process Automation Manager on a Red Hat JBossEAP 71 installation

Table of Contents

PREFACE

CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER

CHAPTER 2 ROLES AND USERS

CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER41 USING THE INSTALLER IN INTERACTIVE MODE42 USING THE INSTALLER IN CLI MODE43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGERCONTROLLER

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE52 INSTALLING PROCESS SERVER FROM THE ZIP FILE53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER54 CREATING USERS55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGERCONTROLLER

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER711 Creating a controller user712 Configuring Process Server and the headless Process Automation Manager controller

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL81 SUPPORTED PROPERTIES

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT91 MODIFY THE MAVEN SETTINGS FILE92 MODIFY THE MAVEN POM FILE

CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

CHAPTER 13 INTEGRATING LDAP AND SSL

CHAPTER 14 RELATED INFORMATION

CHAPTER 15 NEXT STEPS

APPENDIX A VERSIONING INFORMATION

3

4

5

6

77

10

11

1313141416

17

20

2121222224

2526

292929

34

35

363636

37

38

39

40

Table of Contents

1

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

2

PREFACEThis document describes how to install Red Hat Process Automation Manager on a Red Hat JBossEnterprise Application Platform 71 instance

Prerequisite

Review the information in Planning a Red Hat Process Automation Manager installation

PREFACE

3

CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATIONMANAGER

Red Hat Process Automation Manager is the Red Hat middleware platform for creating businessautomation applications and microservices It enables enterprise business and IT users to documentsimulate manage automate and monitor business processes and policies It is designed to empowerbusiness and IT users to collaborate more effectively so business applications can be changed easilyand quickly

Red Hat JBoss Enterprise Application Platform (Red Hat JBoss EAP) 71 is a certified implementationof the Java Enterprise Edition 7 (Java EE 7) full and web profile specifications Red Hat JBoss EAPprovides preconfigured options for features such as high availability clustering messaging anddistributed caching It also enables users to write deploy and run applications using the various APIsand services that Red Hat JBoss EAP provides

The instructions in this document explain how to install Red Hat Process Automation Manager in a RedHat JBoss EAP 71 server instance For instruction on how to install Red Hat Process AutomationManager in other environments see the following documents

Installing and configuring Process Server on IBM WebSphere Application Server

Installing and configuring Process Server on Oracle WebLogic Server

Deploying a Red Hat Process Automation Manager 70 authoring environment on Red Hat OpenShiftContainer Platform

Deploying a Red Hat Process Automation Manager 70 immutable server environment on Red HatOpenShift Container Platform

Deploying a Red Hat Process Automation Manager 70 managed server environment on Red HatOpenShift Container Platform

For information on supported components see the following documents What is the mappingbetween RHPAM product and maven library version Red Hat Process Automation Manager 7Supported Configurations

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

4

CHAPTER 2 ROLES AND USERSTo access Business Central or Process Server you must create users and assign them appropriateroles before the servers are started This section describes available Red Hat Process AutomationManager user roles

NOTE

The admin analyst developer manager process-admin user and rest-allroles are reserved for Business Central The kie-server role is reserved for ProcessServer For this reason the available roles can differ depending on whether BusinessCentral Process Server or both are installed

admin Users with the admin role are the Business Central administrators They can manageusers and create clone and manage the repositories They have full access to make requiredchanges in the application Users with the admin role have access to all areas within Red HatProcess Automation Manager

analyst Users with the analyst role have access to all high-level features They can modeland execute their projects However these users cannot add contributors to spaces or deletespaces in the Design rarr Projects view Access to the Deploy rarr Execution Servers view whichis intended for administrators is not available to users with the analyst role However theDeploy button is available to these users when they access the Library perspective

developer Users with the developer role have access to almost all features and canmanage rules models process flows forms and dashboards They can manage the assetrepository they can create build and deploy projects and they can use Red Hat JBossDeveloper Studio to view processes Only certain administrative functions such as creatingand cloning a new repository are hidden from users with the developer role

manager Users with the manager role can view reports These users are usually interested instatistics about the business processes and their performance business indicators and otherbusiness-related reporting A user with this role has access only to process and task reports

process-admin Users with the process-admin role are business process administratorsThey have full access to business processes business tasks and execution errors These userscan also view business reports and have access to the Task Inbox list

user Users with the user role can work on the Task Inbox list which contains business tasksthat are part of currently running processes Users with this role can view process and taskreports and manage processes

rest-all Users with the rest-all role can access Business Central REST capabilities

kie-server Users with the kie-server role can access Process Server (KIE Server) RESTcapabilities This role is mandatory for users to have access to Manage and Track views inBusiness Central

CHAPTER 2 ROLES AND USERS

5

CHAPTER 3 DOWNLOADING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION FILES

Depending on your environment and installation requirements download a Red Hat ProcessAutomation Manager distribution

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download one of the following product distributions

To use the installer to install Red Hat Process Automation Manager on Red Hat JBoss EAP71 download Red Hat Process Automation Manager 700 Installer (rhpam-installer-700jar) The installer graphical user interface guides you through theinstallation process

To install Red Hat Process Automation Manager on Red Hat JBoss EAP 71 using thedeployable zip files download the following files

Red Hat Process Automation Manager 700 Process Server for All Supported EE7Containers (rhpam-700-kie-server-ee7zip)

Red Hat Process Automation Manager 700 Business Central Deployable for EAP 7(rhpam-700-business-central-eap7-deployablezip)

The ZIP files do not require a graphical user interface so you can install Red Hat ProcessAutomation Manager using SSH

To run Business Central without needing to deploy it to an application server downloadRed Hat Process Automation Manager 700 Decision Central Standalone (rhpam-700-business-central-standalonejar)

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

6

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATIONMANAGER INSTALLER

This section describes how to install Process Server and the headless Process Automation Managercontroller using the installer JAR file The JAR file is an executable file that installs Red Hat ProcessAutomation Manager in an existing Red Hat JBoss EAP 71 server installation You can run the installerin interactive or command line interface (CLI) mode

NOTE

The Red Hat Process Automation Manager JAR file installer does not support the RedHat JBoss EAP distribution installed by yum or RPM Package Manager If you want toinstall Red Hat Process Automation Manager in this type of Red Hat JBoss EAPinstallation download the Red Hat Process Automation Manager 70 Deployable forRed Hat JBoss EAP 71 file and follow the steps in Chapter 5 Installing Red Hat ProcessAutomation Manager from ZIP files

NOTE

Because IBM JDK cannot use keystores generated on other JDKs you cannot installRed Hat Process Automation Manager into an existing Red Hat JBoss EAP installationrunning on IBM JDK with a keystore generated on another JDK

Next steps

Follow the instructions in one of the following sections

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

Section 43 ldquoUsing the installer to configure Process Server with the Process AutomationManager controllerrdquo

41 USING THE INSTALLER IN INTERACTIVE MODE

The installer for Red Hat Process Automation Manager is an executable JAR file You can use it toinstall Red Hat Process Automation Manager in an existing Red Hat JBoss EAP 71 server installation

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in $PATH environment variable On Red Hat Enterprise Linux it isincluded in the java-$JAVA_VERSION-openjdk-devel package

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

7

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer JAR file andenter the following command

java -jar rhpam-installer-700jar

NOTE

When running the installer on Windows you may be prompted to provideadministrator credentials during the installation To prevent this requirementadd the izpackmode=privileged option to the installation command

java -Dizpackmode=privileged -jarrhpam-installer-700jar

Furthermore when running the installer on a 32-bit Java virtual machine youmight encounter memory limitations To prevent this issue run this command

java -XXMaxHeapSize=4g -jarrhpam-installer-700jar

The graphical installer displays a splash screen and a license agreement page

2 Click I accept the terms of this license agreement and click Next

3 Specify the Red Hat JBoss EAP 71 server home where you want to install Red Hat ProcessAutomation Manager and click Next

4 Select the components that you want to install and click Next

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments To do this run the installer twice

5 Create a user and click Next By default the new user is given the admin kie-server and rest-all roles To select another role deselect admin For more information see Chapter 2Roles and users

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

8

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

Make a note of the user name and password You will need them to access Business Centraland Process Server

6 On the Installation Overview page click Next to start the installation The InstallationOverview page lists the components that you will install

7 When the installation has completed click Next

8 On the Configure Runtime Environment page choose whether to perform the defaultinstallation or perform an advanced configurationIf you choose Perform advanced configuration you can choose to configure databasesettings or customize certain Process Server options

9 If you selected Customize database settings on the JDBC Drive Configuration page specifya data source JDBC driver vendor select one or more Driver JAR files and click NextA data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the datasource on the Java Naming and Directory Interface (JNDI) tree or in the local applicationcontext and request a database connection to retrieve data You must configure data sourcesfor Process Server to ensure proper data exchange between the servers and the designateddatabase

10 If you selected Customize Process Server settings change any of the following if desired

Change the name of the Process Server property

Change the URL of the controller

Deselect any Process Server server options

11 Click Next to configure the runtime environment

12 When Processing finished appears at the top of the screen click Next to complete theinstallation

13 If desired click Generate Installation Script and Properties File to save the installation datain an XML file then click Done You can use this file to automatically install Red Hat ProcessAutomation Manager on the same type of server Note that you must change the installpath parameter in the XML file to specify the path of the new server that you want toinstall Red Hat Process Automation Manager on Enter the following command to perform aninstallation with the XML file

java -jar rhpam-installer-700jar ltpath-to-filegt

You have successfully installed Red Hat Process Automation Manager using the installer If youinstalled only Business Central repeat these steps to install Process Server on a separate server

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

9

42 USING THE INSTALLER IN CLI MODE

You can run the Red Hat Process Automation Manager installer through the command-line interface(CLI)

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in the $PATH environment variable On Red Hat Enterprise Linux itis included in the java-$JAVA_VERSION-openjdk-devel package

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer file andenter the following command

java -jar rhpam-installer-700jar -console

The command-line interactive process will start and display the End-User License Agreement

press 1 to continue 2 to quit 3 to redisplay

2 Read the license agreement enter 1 and press Enter to continue

Specify the home directory of one of the following servers Red Hat JBoss EAP 71 or Red Hat JBoss Web Server 50

3 Enter the parent directory of an existing Red Hat JBoss EAP 71 installationThe installer will verify the location of the installation at the location provided Enter 1 toconfirm and continue

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments

4 Follow the instructions in the installer to complete the installation

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

10

NOTE

When you create the user name and password make sure that the specified username does not conflict with any known title of a role or a group For example ifthere is a role called admin you should not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character (not including the character amp)

Make a note of the user name and password You will need them to accessBusiness Central and Process Server

5 When the installation has completed you will see this message

Would you like to generate an automatic installation script and properties file

6 Enter y to create an XML file that contains the installation data or n to complete theinstallation If you enter y you are prompted to specify a path for the XML file

7 Enter a path or press the Enter key to accept the suggested path

8 If you installed only Business Central repeat these steps to install Process Server on aseparate server

43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITHTHE PROCESS AUTOMATION MANAGER CONTROLLER

Process Server can be managed by the Process Automation Manager controller or it can beunmanaged If Process Server is unmanaged you must manually create and maintain containers IfProcess Server is managed the Process Automation Manager controller manages the Process Serverconfiguration and you interact with the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

You can use the installer in interactive or CLI mode to install Business Central and Process Server andthen configure Process Server with the Process Automation Manager controller

NOTE

If you do not install Business Central see Chapter 7 Installing and running the headlessProcess Automation Manager controller for information about using the headless ProcessAutomation Manager controller

Prerequisites

Two computers with backed-up Red Hat JBoss EAP 71 or higher server installations areavailable

Sufficient user permissions to complete the installation are granted

Procedure

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

11

1 On the first computer run the installer in interactive mode or CLI mode See one of thefollowing sections for more information

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

2 On the Component Selection page clear the Process Server box

3 Complete the Business Central installation

4 On the second computer run the installer in interactive mode or CLI mode

5 On the Component Selection page clear the Business Central box

6 On the Configure Runtime Environment page select Perform Advanced Configuration

7 Select Customize Process Server properties and click Next

8 On the Process Server Properties Configuration page click New Server Configuration to adda Process Server and specify a unique name for that Process Server This name will appear inBusiness Central and enable you to distinguish between different Process Servers

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

12

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATIONMANAGER FROM ZIP FILES

The Red Hat Process Automation Manager ZIP files (one for Business Central and one for ProcessServer) do not require a graphical user interface so you can install Red Hat Process AutomationManager using SSH

NOTE

You should install Business Central and the Process Server on different servers inproduction environments

For information about installing the headless Process Automation Manager controllersee Chapter 7 Installing and running the headless Process Automation Manager controller

51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE

Business Central is a web console that enables you to perform the following tasks over individualcomponents in a unified web-based environment

Create manage and edit your rules processes and related assets

Manage connected Process Server instances and their containers

Execute runtime operations against processes and tasks in Process Server instancesconnected to Business Central

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-business-central-eap7-deployablezip

Procedure

1 Extract the rhpam-700-business-central-eap7-deployablezip file to atemporary directory In the following examples this directory is called TEMP_DIR

2 Copy the contents of the TEMP_DIRrhpam-700-business-central-eap7-deployablejboss-eap-71 directory to EAP_HOME When prompted merge or replacefiles

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

13

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 3: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

Legal Notice

Copyright copy 2018 Red Hat Inc

The text of and illustrations in this document are licensed by Red Hat under a Creative CommonsAttributionndashShare Alike 30 Unported license (CC-BY-SA) An explanation of CC-BY-SA isavailable athttpcreativecommonsorglicensesby-sa30 In accordance with CC-BY-SA if you distribute this document or an adaptation of it you mustprovide the URL for the original version

Red Hat as the licensor of this document waives the right to enforce and agrees not to assertSection 4d of CC-BY-SA to the fullest extent permitted by applicable law

Red Hat Red Hat Enterprise Linux the Shadowman logo JBoss OpenShift Fedora the Infinitylogo and RHCE are trademarks of Red Hat Inc registered in the United States and othercountries

Linux reg is the registered trademark of Linus Torvalds in the United States and other countries

Java reg is a registered trademark of Oracle andor its affiliates

XFS reg is a trademark of Silicon Graphics International Corp or its subsidiaries in the UnitedStates andor other countries

MySQL reg is a registered trademark of MySQL AB in the United States the European Union andother countries

Nodejs reg is an official trademark of Joyent Red Hat Software Collections is not formally relatedto or endorsed by the official Joyent Nodejs open source or commercial project

The OpenStack reg Word Mark and OpenStack logo are either registered trademarksservice marksor trademarksservice marks of the OpenStack Foundation in the United States and othercountries and are used with the OpenStack Foundations permission We are not affiliated withendorsed or sponsored by the OpenStack Foundation or the OpenStack community

All other trademarks are the property of their respective owners

Abstract

This document describes how to install Red Hat Process Automation Manager on a Red Hat JBossEAP 71 installation

Table of Contents

PREFACE

CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER

CHAPTER 2 ROLES AND USERS

CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER41 USING THE INSTALLER IN INTERACTIVE MODE42 USING THE INSTALLER IN CLI MODE43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGERCONTROLLER

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE52 INSTALLING PROCESS SERVER FROM THE ZIP FILE53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER54 CREATING USERS55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGERCONTROLLER

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER711 Creating a controller user712 Configuring Process Server and the headless Process Automation Manager controller

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL81 SUPPORTED PROPERTIES

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT91 MODIFY THE MAVEN SETTINGS FILE92 MODIFY THE MAVEN POM FILE

CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

CHAPTER 13 INTEGRATING LDAP AND SSL

CHAPTER 14 RELATED INFORMATION

CHAPTER 15 NEXT STEPS

APPENDIX A VERSIONING INFORMATION

3

4

5

6

77

10

11

1313141416

17

20

2121222224

2526

292929

34

35

363636

37

38

39

40

Table of Contents

1

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

2

PREFACEThis document describes how to install Red Hat Process Automation Manager on a Red Hat JBossEnterprise Application Platform 71 instance

Prerequisite

Review the information in Planning a Red Hat Process Automation Manager installation

PREFACE

3

CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATIONMANAGER

Red Hat Process Automation Manager is the Red Hat middleware platform for creating businessautomation applications and microservices It enables enterprise business and IT users to documentsimulate manage automate and monitor business processes and policies It is designed to empowerbusiness and IT users to collaborate more effectively so business applications can be changed easilyand quickly

Red Hat JBoss Enterprise Application Platform (Red Hat JBoss EAP) 71 is a certified implementationof the Java Enterprise Edition 7 (Java EE 7) full and web profile specifications Red Hat JBoss EAPprovides preconfigured options for features such as high availability clustering messaging anddistributed caching It also enables users to write deploy and run applications using the various APIsand services that Red Hat JBoss EAP provides

The instructions in this document explain how to install Red Hat Process Automation Manager in a RedHat JBoss EAP 71 server instance For instruction on how to install Red Hat Process AutomationManager in other environments see the following documents

Installing and configuring Process Server on IBM WebSphere Application Server

Installing and configuring Process Server on Oracle WebLogic Server

Deploying a Red Hat Process Automation Manager 70 authoring environment on Red Hat OpenShiftContainer Platform

Deploying a Red Hat Process Automation Manager 70 immutable server environment on Red HatOpenShift Container Platform

Deploying a Red Hat Process Automation Manager 70 managed server environment on Red HatOpenShift Container Platform

For information on supported components see the following documents What is the mappingbetween RHPAM product and maven library version Red Hat Process Automation Manager 7Supported Configurations

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

4

CHAPTER 2 ROLES AND USERSTo access Business Central or Process Server you must create users and assign them appropriateroles before the servers are started This section describes available Red Hat Process AutomationManager user roles

NOTE

The admin analyst developer manager process-admin user and rest-allroles are reserved for Business Central The kie-server role is reserved for ProcessServer For this reason the available roles can differ depending on whether BusinessCentral Process Server or both are installed

admin Users with the admin role are the Business Central administrators They can manageusers and create clone and manage the repositories They have full access to make requiredchanges in the application Users with the admin role have access to all areas within Red HatProcess Automation Manager

analyst Users with the analyst role have access to all high-level features They can modeland execute their projects However these users cannot add contributors to spaces or deletespaces in the Design rarr Projects view Access to the Deploy rarr Execution Servers view whichis intended for administrators is not available to users with the analyst role However theDeploy button is available to these users when they access the Library perspective

developer Users with the developer role have access to almost all features and canmanage rules models process flows forms and dashboards They can manage the assetrepository they can create build and deploy projects and they can use Red Hat JBossDeveloper Studio to view processes Only certain administrative functions such as creatingand cloning a new repository are hidden from users with the developer role

manager Users with the manager role can view reports These users are usually interested instatistics about the business processes and their performance business indicators and otherbusiness-related reporting A user with this role has access only to process and task reports

process-admin Users with the process-admin role are business process administratorsThey have full access to business processes business tasks and execution errors These userscan also view business reports and have access to the Task Inbox list

user Users with the user role can work on the Task Inbox list which contains business tasksthat are part of currently running processes Users with this role can view process and taskreports and manage processes

rest-all Users with the rest-all role can access Business Central REST capabilities

kie-server Users with the kie-server role can access Process Server (KIE Server) RESTcapabilities This role is mandatory for users to have access to Manage and Track views inBusiness Central

CHAPTER 2 ROLES AND USERS

5

CHAPTER 3 DOWNLOADING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION FILES

Depending on your environment and installation requirements download a Red Hat ProcessAutomation Manager distribution

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download one of the following product distributions

To use the installer to install Red Hat Process Automation Manager on Red Hat JBoss EAP71 download Red Hat Process Automation Manager 700 Installer (rhpam-installer-700jar) The installer graphical user interface guides you through theinstallation process

To install Red Hat Process Automation Manager on Red Hat JBoss EAP 71 using thedeployable zip files download the following files

Red Hat Process Automation Manager 700 Process Server for All Supported EE7Containers (rhpam-700-kie-server-ee7zip)

Red Hat Process Automation Manager 700 Business Central Deployable for EAP 7(rhpam-700-business-central-eap7-deployablezip)

The ZIP files do not require a graphical user interface so you can install Red Hat ProcessAutomation Manager using SSH

To run Business Central without needing to deploy it to an application server downloadRed Hat Process Automation Manager 700 Decision Central Standalone (rhpam-700-business-central-standalonejar)

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

6

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATIONMANAGER INSTALLER

This section describes how to install Process Server and the headless Process Automation Managercontroller using the installer JAR file The JAR file is an executable file that installs Red Hat ProcessAutomation Manager in an existing Red Hat JBoss EAP 71 server installation You can run the installerin interactive or command line interface (CLI) mode

NOTE

The Red Hat Process Automation Manager JAR file installer does not support the RedHat JBoss EAP distribution installed by yum or RPM Package Manager If you want toinstall Red Hat Process Automation Manager in this type of Red Hat JBoss EAPinstallation download the Red Hat Process Automation Manager 70 Deployable forRed Hat JBoss EAP 71 file and follow the steps in Chapter 5 Installing Red Hat ProcessAutomation Manager from ZIP files

NOTE

Because IBM JDK cannot use keystores generated on other JDKs you cannot installRed Hat Process Automation Manager into an existing Red Hat JBoss EAP installationrunning on IBM JDK with a keystore generated on another JDK

Next steps

Follow the instructions in one of the following sections

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

Section 43 ldquoUsing the installer to configure Process Server with the Process AutomationManager controllerrdquo

41 USING THE INSTALLER IN INTERACTIVE MODE

The installer for Red Hat Process Automation Manager is an executable JAR file You can use it toinstall Red Hat Process Automation Manager in an existing Red Hat JBoss EAP 71 server installation

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in $PATH environment variable On Red Hat Enterprise Linux it isincluded in the java-$JAVA_VERSION-openjdk-devel package

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

7

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer JAR file andenter the following command

java -jar rhpam-installer-700jar

NOTE

When running the installer on Windows you may be prompted to provideadministrator credentials during the installation To prevent this requirementadd the izpackmode=privileged option to the installation command

java -Dizpackmode=privileged -jarrhpam-installer-700jar

Furthermore when running the installer on a 32-bit Java virtual machine youmight encounter memory limitations To prevent this issue run this command

java -XXMaxHeapSize=4g -jarrhpam-installer-700jar

The graphical installer displays a splash screen and a license agreement page

2 Click I accept the terms of this license agreement and click Next

3 Specify the Red Hat JBoss EAP 71 server home where you want to install Red Hat ProcessAutomation Manager and click Next

4 Select the components that you want to install and click Next

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments To do this run the installer twice

5 Create a user and click Next By default the new user is given the admin kie-server and rest-all roles To select another role deselect admin For more information see Chapter 2Roles and users

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

8

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

Make a note of the user name and password You will need them to access Business Centraland Process Server

6 On the Installation Overview page click Next to start the installation The InstallationOverview page lists the components that you will install

7 When the installation has completed click Next

8 On the Configure Runtime Environment page choose whether to perform the defaultinstallation or perform an advanced configurationIf you choose Perform advanced configuration you can choose to configure databasesettings or customize certain Process Server options

9 If you selected Customize database settings on the JDBC Drive Configuration page specifya data source JDBC driver vendor select one or more Driver JAR files and click NextA data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the datasource on the Java Naming and Directory Interface (JNDI) tree or in the local applicationcontext and request a database connection to retrieve data You must configure data sourcesfor Process Server to ensure proper data exchange between the servers and the designateddatabase

10 If you selected Customize Process Server settings change any of the following if desired

Change the name of the Process Server property

Change the URL of the controller

Deselect any Process Server server options

11 Click Next to configure the runtime environment

12 When Processing finished appears at the top of the screen click Next to complete theinstallation

13 If desired click Generate Installation Script and Properties File to save the installation datain an XML file then click Done You can use this file to automatically install Red Hat ProcessAutomation Manager on the same type of server Note that you must change the installpath parameter in the XML file to specify the path of the new server that you want toinstall Red Hat Process Automation Manager on Enter the following command to perform aninstallation with the XML file

java -jar rhpam-installer-700jar ltpath-to-filegt

You have successfully installed Red Hat Process Automation Manager using the installer If youinstalled only Business Central repeat these steps to install Process Server on a separate server

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

9

42 USING THE INSTALLER IN CLI MODE

You can run the Red Hat Process Automation Manager installer through the command-line interface(CLI)

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in the $PATH environment variable On Red Hat Enterprise Linux itis included in the java-$JAVA_VERSION-openjdk-devel package

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer file andenter the following command

java -jar rhpam-installer-700jar -console

The command-line interactive process will start and display the End-User License Agreement

press 1 to continue 2 to quit 3 to redisplay

2 Read the license agreement enter 1 and press Enter to continue

Specify the home directory of one of the following servers Red Hat JBoss EAP 71 or Red Hat JBoss Web Server 50

3 Enter the parent directory of an existing Red Hat JBoss EAP 71 installationThe installer will verify the location of the installation at the location provided Enter 1 toconfirm and continue

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments

4 Follow the instructions in the installer to complete the installation

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

10

NOTE

When you create the user name and password make sure that the specified username does not conflict with any known title of a role or a group For example ifthere is a role called admin you should not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character (not including the character amp)

Make a note of the user name and password You will need them to accessBusiness Central and Process Server

5 When the installation has completed you will see this message

Would you like to generate an automatic installation script and properties file

6 Enter y to create an XML file that contains the installation data or n to complete theinstallation If you enter y you are prompted to specify a path for the XML file

7 Enter a path or press the Enter key to accept the suggested path

8 If you installed only Business Central repeat these steps to install Process Server on aseparate server

43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITHTHE PROCESS AUTOMATION MANAGER CONTROLLER

Process Server can be managed by the Process Automation Manager controller or it can beunmanaged If Process Server is unmanaged you must manually create and maintain containers IfProcess Server is managed the Process Automation Manager controller manages the Process Serverconfiguration and you interact with the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

You can use the installer in interactive or CLI mode to install Business Central and Process Server andthen configure Process Server with the Process Automation Manager controller

NOTE

If you do not install Business Central see Chapter 7 Installing and running the headlessProcess Automation Manager controller for information about using the headless ProcessAutomation Manager controller

Prerequisites

Two computers with backed-up Red Hat JBoss EAP 71 or higher server installations areavailable

Sufficient user permissions to complete the installation are granted

Procedure

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

11

1 On the first computer run the installer in interactive mode or CLI mode See one of thefollowing sections for more information

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

2 On the Component Selection page clear the Process Server box

3 Complete the Business Central installation

4 On the second computer run the installer in interactive mode or CLI mode

5 On the Component Selection page clear the Business Central box

6 On the Configure Runtime Environment page select Perform Advanced Configuration

7 Select Customize Process Server properties and click Next

8 On the Process Server Properties Configuration page click New Server Configuration to adda Process Server and specify a unique name for that Process Server This name will appear inBusiness Central and enable you to distinguish between different Process Servers

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

12

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATIONMANAGER FROM ZIP FILES

The Red Hat Process Automation Manager ZIP files (one for Business Central and one for ProcessServer) do not require a graphical user interface so you can install Red Hat Process AutomationManager using SSH

NOTE

You should install Business Central and the Process Server on different servers inproduction environments

For information about installing the headless Process Automation Manager controllersee Chapter 7 Installing and running the headless Process Automation Manager controller

51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE

Business Central is a web console that enables you to perform the following tasks over individualcomponents in a unified web-based environment

Create manage and edit your rules processes and related assets

Manage connected Process Server instances and their containers

Execute runtime operations against processes and tasks in Process Server instancesconnected to Business Central

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-business-central-eap7-deployablezip

Procedure

1 Extract the rhpam-700-business-central-eap7-deployablezip file to atemporary directory In the following examples this directory is called TEMP_DIR

2 Copy the contents of the TEMP_DIRrhpam-700-business-central-eap7-deployablejboss-eap-71 directory to EAP_HOME When prompted merge or replacefiles

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

13

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 4: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

Table of Contents

PREFACE

CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER

CHAPTER 2 ROLES AND USERS

CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER41 USING THE INSTALLER IN INTERACTIVE MODE42 USING THE INSTALLER IN CLI MODE43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGERCONTROLLER

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE52 INSTALLING PROCESS SERVER FROM THE ZIP FILE53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER54 CREATING USERS55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGERCONTROLLER

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER711 Creating a controller user712 Configuring Process Server and the headless Process Automation Manager controller

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL81 SUPPORTED PROPERTIES

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT91 MODIFY THE MAVEN SETTINGS FILE92 MODIFY THE MAVEN POM FILE

CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

CHAPTER 13 INTEGRATING LDAP AND SSL

CHAPTER 14 RELATED INFORMATION

CHAPTER 15 NEXT STEPS

APPENDIX A VERSIONING INFORMATION

3

4

5

6

77

10

11

1313141416

17

20

2121222224

2526

292929

34

35

363636

37

38

39

40

Table of Contents

1

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

2

PREFACEThis document describes how to install Red Hat Process Automation Manager on a Red Hat JBossEnterprise Application Platform 71 instance

Prerequisite

Review the information in Planning a Red Hat Process Automation Manager installation

PREFACE

3

CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATIONMANAGER

Red Hat Process Automation Manager is the Red Hat middleware platform for creating businessautomation applications and microservices It enables enterprise business and IT users to documentsimulate manage automate and monitor business processes and policies It is designed to empowerbusiness and IT users to collaborate more effectively so business applications can be changed easilyand quickly

Red Hat JBoss Enterprise Application Platform (Red Hat JBoss EAP) 71 is a certified implementationof the Java Enterprise Edition 7 (Java EE 7) full and web profile specifications Red Hat JBoss EAPprovides preconfigured options for features such as high availability clustering messaging anddistributed caching It also enables users to write deploy and run applications using the various APIsand services that Red Hat JBoss EAP provides

The instructions in this document explain how to install Red Hat Process Automation Manager in a RedHat JBoss EAP 71 server instance For instruction on how to install Red Hat Process AutomationManager in other environments see the following documents

Installing and configuring Process Server on IBM WebSphere Application Server

Installing and configuring Process Server on Oracle WebLogic Server

Deploying a Red Hat Process Automation Manager 70 authoring environment on Red Hat OpenShiftContainer Platform

Deploying a Red Hat Process Automation Manager 70 immutable server environment on Red HatOpenShift Container Platform

Deploying a Red Hat Process Automation Manager 70 managed server environment on Red HatOpenShift Container Platform

For information on supported components see the following documents What is the mappingbetween RHPAM product and maven library version Red Hat Process Automation Manager 7Supported Configurations

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

4

CHAPTER 2 ROLES AND USERSTo access Business Central or Process Server you must create users and assign them appropriateroles before the servers are started This section describes available Red Hat Process AutomationManager user roles

NOTE

The admin analyst developer manager process-admin user and rest-allroles are reserved for Business Central The kie-server role is reserved for ProcessServer For this reason the available roles can differ depending on whether BusinessCentral Process Server or both are installed

admin Users with the admin role are the Business Central administrators They can manageusers and create clone and manage the repositories They have full access to make requiredchanges in the application Users with the admin role have access to all areas within Red HatProcess Automation Manager

analyst Users with the analyst role have access to all high-level features They can modeland execute their projects However these users cannot add contributors to spaces or deletespaces in the Design rarr Projects view Access to the Deploy rarr Execution Servers view whichis intended for administrators is not available to users with the analyst role However theDeploy button is available to these users when they access the Library perspective

developer Users with the developer role have access to almost all features and canmanage rules models process flows forms and dashboards They can manage the assetrepository they can create build and deploy projects and they can use Red Hat JBossDeveloper Studio to view processes Only certain administrative functions such as creatingand cloning a new repository are hidden from users with the developer role

manager Users with the manager role can view reports These users are usually interested instatistics about the business processes and their performance business indicators and otherbusiness-related reporting A user with this role has access only to process and task reports

process-admin Users with the process-admin role are business process administratorsThey have full access to business processes business tasks and execution errors These userscan also view business reports and have access to the Task Inbox list

user Users with the user role can work on the Task Inbox list which contains business tasksthat are part of currently running processes Users with this role can view process and taskreports and manage processes

rest-all Users with the rest-all role can access Business Central REST capabilities

kie-server Users with the kie-server role can access Process Server (KIE Server) RESTcapabilities This role is mandatory for users to have access to Manage and Track views inBusiness Central

CHAPTER 2 ROLES AND USERS

5

CHAPTER 3 DOWNLOADING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION FILES

Depending on your environment and installation requirements download a Red Hat ProcessAutomation Manager distribution

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download one of the following product distributions

To use the installer to install Red Hat Process Automation Manager on Red Hat JBoss EAP71 download Red Hat Process Automation Manager 700 Installer (rhpam-installer-700jar) The installer graphical user interface guides you through theinstallation process

To install Red Hat Process Automation Manager on Red Hat JBoss EAP 71 using thedeployable zip files download the following files

Red Hat Process Automation Manager 700 Process Server for All Supported EE7Containers (rhpam-700-kie-server-ee7zip)

Red Hat Process Automation Manager 700 Business Central Deployable for EAP 7(rhpam-700-business-central-eap7-deployablezip)

The ZIP files do not require a graphical user interface so you can install Red Hat ProcessAutomation Manager using SSH

To run Business Central without needing to deploy it to an application server downloadRed Hat Process Automation Manager 700 Decision Central Standalone (rhpam-700-business-central-standalonejar)

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

6

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATIONMANAGER INSTALLER

This section describes how to install Process Server and the headless Process Automation Managercontroller using the installer JAR file The JAR file is an executable file that installs Red Hat ProcessAutomation Manager in an existing Red Hat JBoss EAP 71 server installation You can run the installerin interactive or command line interface (CLI) mode

NOTE

The Red Hat Process Automation Manager JAR file installer does not support the RedHat JBoss EAP distribution installed by yum or RPM Package Manager If you want toinstall Red Hat Process Automation Manager in this type of Red Hat JBoss EAPinstallation download the Red Hat Process Automation Manager 70 Deployable forRed Hat JBoss EAP 71 file and follow the steps in Chapter 5 Installing Red Hat ProcessAutomation Manager from ZIP files

NOTE

Because IBM JDK cannot use keystores generated on other JDKs you cannot installRed Hat Process Automation Manager into an existing Red Hat JBoss EAP installationrunning on IBM JDK with a keystore generated on another JDK

Next steps

Follow the instructions in one of the following sections

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

Section 43 ldquoUsing the installer to configure Process Server with the Process AutomationManager controllerrdquo

41 USING THE INSTALLER IN INTERACTIVE MODE

The installer for Red Hat Process Automation Manager is an executable JAR file You can use it toinstall Red Hat Process Automation Manager in an existing Red Hat JBoss EAP 71 server installation

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in $PATH environment variable On Red Hat Enterprise Linux it isincluded in the java-$JAVA_VERSION-openjdk-devel package

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

7

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer JAR file andenter the following command

java -jar rhpam-installer-700jar

NOTE

When running the installer on Windows you may be prompted to provideadministrator credentials during the installation To prevent this requirementadd the izpackmode=privileged option to the installation command

java -Dizpackmode=privileged -jarrhpam-installer-700jar

Furthermore when running the installer on a 32-bit Java virtual machine youmight encounter memory limitations To prevent this issue run this command

java -XXMaxHeapSize=4g -jarrhpam-installer-700jar

The graphical installer displays a splash screen and a license agreement page

2 Click I accept the terms of this license agreement and click Next

3 Specify the Red Hat JBoss EAP 71 server home where you want to install Red Hat ProcessAutomation Manager and click Next

4 Select the components that you want to install and click Next

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments To do this run the installer twice

5 Create a user and click Next By default the new user is given the admin kie-server and rest-all roles To select another role deselect admin For more information see Chapter 2Roles and users

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

8

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

Make a note of the user name and password You will need them to access Business Centraland Process Server

6 On the Installation Overview page click Next to start the installation The InstallationOverview page lists the components that you will install

7 When the installation has completed click Next

8 On the Configure Runtime Environment page choose whether to perform the defaultinstallation or perform an advanced configurationIf you choose Perform advanced configuration you can choose to configure databasesettings or customize certain Process Server options

9 If you selected Customize database settings on the JDBC Drive Configuration page specifya data source JDBC driver vendor select one or more Driver JAR files and click NextA data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the datasource on the Java Naming and Directory Interface (JNDI) tree or in the local applicationcontext and request a database connection to retrieve data You must configure data sourcesfor Process Server to ensure proper data exchange between the servers and the designateddatabase

10 If you selected Customize Process Server settings change any of the following if desired

Change the name of the Process Server property

Change the URL of the controller

Deselect any Process Server server options

11 Click Next to configure the runtime environment

12 When Processing finished appears at the top of the screen click Next to complete theinstallation

13 If desired click Generate Installation Script and Properties File to save the installation datain an XML file then click Done You can use this file to automatically install Red Hat ProcessAutomation Manager on the same type of server Note that you must change the installpath parameter in the XML file to specify the path of the new server that you want toinstall Red Hat Process Automation Manager on Enter the following command to perform aninstallation with the XML file

java -jar rhpam-installer-700jar ltpath-to-filegt

You have successfully installed Red Hat Process Automation Manager using the installer If youinstalled only Business Central repeat these steps to install Process Server on a separate server

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

9

42 USING THE INSTALLER IN CLI MODE

You can run the Red Hat Process Automation Manager installer through the command-line interface(CLI)

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in the $PATH environment variable On Red Hat Enterprise Linux itis included in the java-$JAVA_VERSION-openjdk-devel package

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer file andenter the following command

java -jar rhpam-installer-700jar -console

The command-line interactive process will start and display the End-User License Agreement

press 1 to continue 2 to quit 3 to redisplay

2 Read the license agreement enter 1 and press Enter to continue

Specify the home directory of one of the following servers Red Hat JBoss EAP 71 or Red Hat JBoss Web Server 50

3 Enter the parent directory of an existing Red Hat JBoss EAP 71 installationThe installer will verify the location of the installation at the location provided Enter 1 toconfirm and continue

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments

4 Follow the instructions in the installer to complete the installation

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

10

NOTE

When you create the user name and password make sure that the specified username does not conflict with any known title of a role or a group For example ifthere is a role called admin you should not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character (not including the character amp)

Make a note of the user name and password You will need them to accessBusiness Central and Process Server

5 When the installation has completed you will see this message

Would you like to generate an automatic installation script and properties file

6 Enter y to create an XML file that contains the installation data or n to complete theinstallation If you enter y you are prompted to specify a path for the XML file

7 Enter a path or press the Enter key to accept the suggested path

8 If you installed only Business Central repeat these steps to install Process Server on aseparate server

43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITHTHE PROCESS AUTOMATION MANAGER CONTROLLER

Process Server can be managed by the Process Automation Manager controller or it can beunmanaged If Process Server is unmanaged you must manually create and maintain containers IfProcess Server is managed the Process Automation Manager controller manages the Process Serverconfiguration and you interact with the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

You can use the installer in interactive or CLI mode to install Business Central and Process Server andthen configure Process Server with the Process Automation Manager controller

NOTE

If you do not install Business Central see Chapter 7 Installing and running the headlessProcess Automation Manager controller for information about using the headless ProcessAutomation Manager controller

Prerequisites

Two computers with backed-up Red Hat JBoss EAP 71 or higher server installations areavailable

Sufficient user permissions to complete the installation are granted

Procedure

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

11

1 On the first computer run the installer in interactive mode or CLI mode See one of thefollowing sections for more information

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

2 On the Component Selection page clear the Process Server box

3 Complete the Business Central installation

4 On the second computer run the installer in interactive mode or CLI mode

5 On the Component Selection page clear the Business Central box

6 On the Configure Runtime Environment page select Perform Advanced Configuration

7 Select Customize Process Server properties and click Next

8 On the Process Server Properties Configuration page click New Server Configuration to adda Process Server and specify a unique name for that Process Server This name will appear inBusiness Central and enable you to distinguish between different Process Servers

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

12

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATIONMANAGER FROM ZIP FILES

The Red Hat Process Automation Manager ZIP files (one for Business Central and one for ProcessServer) do not require a graphical user interface so you can install Red Hat Process AutomationManager using SSH

NOTE

You should install Business Central and the Process Server on different servers inproduction environments

For information about installing the headless Process Automation Manager controllersee Chapter 7 Installing and running the headless Process Automation Manager controller

51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE

Business Central is a web console that enables you to perform the following tasks over individualcomponents in a unified web-based environment

Create manage and edit your rules processes and related assets

Manage connected Process Server instances and their containers

Execute runtime operations against processes and tasks in Process Server instancesconnected to Business Central

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-business-central-eap7-deployablezip

Procedure

1 Extract the rhpam-700-business-central-eap7-deployablezip file to atemporary directory In the following examples this directory is called TEMP_DIR

2 Copy the contents of the TEMP_DIRrhpam-700-business-central-eap7-deployablejboss-eap-71 directory to EAP_HOME When prompted merge or replacefiles

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

13

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 5: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

2

PREFACEThis document describes how to install Red Hat Process Automation Manager on a Red Hat JBossEnterprise Application Platform 71 instance

Prerequisite

Review the information in Planning a Red Hat Process Automation Manager installation

PREFACE

3

CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATIONMANAGER

Red Hat Process Automation Manager is the Red Hat middleware platform for creating businessautomation applications and microservices It enables enterprise business and IT users to documentsimulate manage automate and monitor business processes and policies It is designed to empowerbusiness and IT users to collaborate more effectively so business applications can be changed easilyand quickly

Red Hat JBoss Enterprise Application Platform (Red Hat JBoss EAP) 71 is a certified implementationof the Java Enterprise Edition 7 (Java EE 7) full and web profile specifications Red Hat JBoss EAPprovides preconfigured options for features such as high availability clustering messaging anddistributed caching It also enables users to write deploy and run applications using the various APIsand services that Red Hat JBoss EAP provides

The instructions in this document explain how to install Red Hat Process Automation Manager in a RedHat JBoss EAP 71 server instance For instruction on how to install Red Hat Process AutomationManager in other environments see the following documents

Installing and configuring Process Server on IBM WebSphere Application Server

Installing and configuring Process Server on Oracle WebLogic Server

Deploying a Red Hat Process Automation Manager 70 authoring environment on Red Hat OpenShiftContainer Platform

Deploying a Red Hat Process Automation Manager 70 immutable server environment on Red HatOpenShift Container Platform

Deploying a Red Hat Process Automation Manager 70 managed server environment on Red HatOpenShift Container Platform

For information on supported components see the following documents What is the mappingbetween RHPAM product and maven library version Red Hat Process Automation Manager 7Supported Configurations

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

4

CHAPTER 2 ROLES AND USERSTo access Business Central or Process Server you must create users and assign them appropriateroles before the servers are started This section describes available Red Hat Process AutomationManager user roles

NOTE

The admin analyst developer manager process-admin user and rest-allroles are reserved for Business Central The kie-server role is reserved for ProcessServer For this reason the available roles can differ depending on whether BusinessCentral Process Server or both are installed

admin Users with the admin role are the Business Central administrators They can manageusers and create clone and manage the repositories They have full access to make requiredchanges in the application Users with the admin role have access to all areas within Red HatProcess Automation Manager

analyst Users with the analyst role have access to all high-level features They can modeland execute their projects However these users cannot add contributors to spaces or deletespaces in the Design rarr Projects view Access to the Deploy rarr Execution Servers view whichis intended for administrators is not available to users with the analyst role However theDeploy button is available to these users when they access the Library perspective

developer Users with the developer role have access to almost all features and canmanage rules models process flows forms and dashboards They can manage the assetrepository they can create build and deploy projects and they can use Red Hat JBossDeveloper Studio to view processes Only certain administrative functions such as creatingand cloning a new repository are hidden from users with the developer role

manager Users with the manager role can view reports These users are usually interested instatistics about the business processes and their performance business indicators and otherbusiness-related reporting A user with this role has access only to process and task reports

process-admin Users with the process-admin role are business process administratorsThey have full access to business processes business tasks and execution errors These userscan also view business reports and have access to the Task Inbox list

user Users with the user role can work on the Task Inbox list which contains business tasksthat are part of currently running processes Users with this role can view process and taskreports and manage processes

rest-all Users with the rest-all role can access Business Central REST capabilities

kie-server Users with the kie-server role can access Process Server (KIE Server) RESTcapabilities This role is mandatory for users to have access to Manage and Track views inBusiness Central

CHAPTER 2 ROLES AND USERS

5

CHAPTER 3 DOWNLOADING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION FILES

Depending on your environment and installation requirements download a Red Hat ProcessAutomation Manager distribution

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download one of the following product distributions

To use the installer to install Red Hat Process Automation Manager on Red Hat JBoss EAP71 download Red Hat Process Automation Manager 700 Installer (rhpam-installer-700jar) The installer graphical user interface guides you through theinstallation process

To install Red Hat Process Automation Manager on Red Hat JBoss EAP 71 using thedeployable zip files download the following files

Red Hat Process Automation Manager 700 Process Server for All Supported EE7Containers (rhpam-700-kie-server-ee7zip)

Red Hat Process Automation Manager 700 Business Central Deployable for EAP 7(rhpam-700-business-central-eap7-deployablezip)

The ZIP files do not require a graphical user interface so you can install Red Hat ProcessAutomation Manager using SSH

To run Business Central without needing to deploy it to an application server downloadRed Hat Process Automation Manager 700 Decision Central Standalone (rhpam-700-business-central-standalonejar)

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

6

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATIONMANAGER INSTALLER

This section describes how to install Process Server and the headless Process Automation Managercontroller using the installer JAR file The JAR file is an executable file that installs Red Hat ProcessAutomation Manager in an existing Red Hat JBoss EAP 71 server installation You can run the installerin interactive or command line interface (CLI) mode

NOTE

The Red Hat Process Automation Manager JAR file installer does not support the RedHat JBoss EAP distribution installed by yum or RPM Package Manager If you want toinstall Red Hat Process Automation Manager in this type of Red Hat JBoss EAPinstallation download the Red Hat Process Automation Manager 70 Deployable forRed Hat JBoss EAP 71 file and follow the steps in Chapter 5 Installing Red Hat ProcessAutomation Manager from ZIP files

NOTE

Because IBM JDK cannot use keystores generated on other JDKs you cannot installRed Hat Process Automation Manager into an existing Red Hat JBoss EAP installationrunning on IBM JDK with a keystore generated on another JDK

Next steps

Follow the instructions in one of the following sections

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

Section 43 ldquoUsing the installer to configure Process Server with the Process AutomationManager controllerrdquo

41 USING THE INSTALLER IN INTERACTIVE MODE

The installer for Red Hat Process Automation Manager is an executable JAR file You can use it toinstall Red Hat Process Automation Manager in an existing Red Hat JBoss EAP 71 server installation

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in $PATH environment variable On Red Hat Enterprise Linux it isincluded in the java-$JAVA_VERSION-openjdk-devel package

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

7

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer JAR file andenter the following command

java -jar rhpam-installer-700jar

NOTE

When running the installer on Windows you may be prompted to provideadministrator credentials during the installation To prevent this requirementadd the izpackmode=privileged option to the installation command

java -Dizpackmode=privileged -jarrhpam-installer-700jar

Furthermore when running the installer on a 32-bit Java virtual machine youmight encounter memory limitations To prevent this issue run this command

java -XXMaxHeapSize=4g -jarrhpam-installer-700jar

The graphical installer displays a splash screen and a license agreement page

2 Click I accept the terms of this license agreement and click Next

3 Specify the Red Hat JBoss EAP 71 server home where you want to install Red Hat ProcessAutomation Manager and click Next

4 Select the components that you want to install and click Next

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments To do this run the installer twice

5 Create a user and click Next By default the new user is given the admin kie-server and rest-all roles To select another role deselect admin For more information see Chapter 2Roles and users

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

8

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

Make a note of the user name and password You will need them to access Business Centraland Process Server

6 On the Installation Overview page click Next to start the installation The InstallationOverview page lists the components that you will install

7 When the installation has completed click Next

8 On the Configure Runtime Environment page choose whether to perform the defaultinstallation or perform an advanced configurationIf you choose Perform advanced configuration you can choose to configure databasesettings or customize certain Process Server options

9 If you selected Customize database settings on the JDBC Drive Configuration page specifya data source JDBC driver vendor select one or more Driver JAR files and click NextA data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the datasource on the Java Naming and Directory Interface (JNDI) tree or in the local applicationcontext and request a database connection to retrieve data You must configure data sourcesfor Process Server to ensure proper data exchange between the servers and the designateddatabase

10 If you selected Customize Process Server settings change any of the following if desired

Change the name of the Process Server property

Change the URL of the controller

Deselect any Process Server server options

11 Click Next to configure the runtime environment

12 When Processing finished appears at the top of the screen click Next to complete theinstallation

13 If desired click Generate Installation Script and Properties File to save the installation datain an XML file then click Done You can use this file to automatically install Red Hat ProcessAutomation Manager on the same type of server Note that you must change the installpath parameter in the XML file to specify the path of the new server that you want toinstall Red Hat Process Automation Manager on Enter the following command to perform aninstallation with the XML file

java -jar rhpam-installer-700jar ltpath-to-filegt

You have successfully installed Red Hat Process Automation Manager using the installer If youinstalled only Business Central repeat these steps to install Process Server on a separate server

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

9

42 USING THE INSTALLER IN CLI MODE

You can run the Red Hat Process Automation Manager installer through the command-line interface(CLI)

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in the $PATH environment variable On Red Hat Enterprise Linux itis included in the java-$JAVA_VERSION-openjdk-devel package

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer file andenter the following command

java -jar rhpam-installer-700jar -console

The command-line interactive process will start and display the End-User License Agreement

press 1 to continue 2 to quit 3 to redisplay

2 Read the license agreement enter 1 and press Enter to continue

Specify the home directory of one of the following servers Red Hat JBoss EAP 71 or Red Hat JBoss Web Server 50

3 Enter the parent directory of an existing Red Hat JBoss EAP 71 installationThe installer will verify the location of the installation at the location provided Enter 1 toconfirm and continue

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments

4 Follow the instructions in the installer to complete the installation

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

10

NOTE

When you create the user name and password make sure that the specified username does not conflict with any known title of a role or a group For example ifthere is a role called admin you should not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character (not including the character amp)

Make a note of the user name and password You will need them to accessBusiness Central and Process Server

5 When the installation has completed you will see this message

Would you like to generate an automatic installation script and properties file

6 Enter y to create an XML file that contains the installation data or n to complete theinstallation If you enter y you are prompted to specify a path for the XML file

7 Enter a path or press the Enter key to accept the suggested path

8 If you installed only Business Central repeat these steps to install Process Server on aseparate server

43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITHTHE PROCESS AUTOMATION MANAGER CONTROLLER

Process Server can be managed by the Process Automation Manager controller or it can beunmanaged If Process Server is unmanaged you must manually create and maintain containers IfProcess Server is managed the Process Automation Manager controller manages the Process Serverconfiguration and you interact with the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

You can use the installer in interactive or CLI mode to install Business Central and Process Server andthen configure Process Server with the Process Automation Manager controller

NOTE

If you do not install Business Central see Chapter 7 Installing and running the headlessProcess Automation Manager controller for information about using the headless ProcessAutomation Manager controller

Prerequisites

Two computers with backed-up Red Hat JBoss EAP 71 or higher server installations areavailable

Sufficient user permissions to complete the installation are granted

Procedure

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

11

1 On the first computer run the installer in interactive mode or CLI mode See one of thefollowing sections for more information

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

2 On the Component Selection page clear the Process Server box

3 Complete the Business Central installation

4 On the second computer run the installer in interactive mode or CLI mode

5 On the Component Selection page clear the Business Central box

6 On the Configure Runtime Environment page select Perform Advanced Configuration

7 Select Customize Process Server properties and click Next

8 On the Process Server Properties Configuration page click New Server Configuration to adda Process Server and specify a unique name for that Process Server This name will appear inBusiness Central and enable you to distinguish between different Process Servers

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

12

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATIONMANAGER FROM ZIP FILES

The Red Hat Process Automation Manager ZIP files (one for Business Central and one for ProcessServer) do not require a graphical user interface so you can install Red Hat Process AutomationManager using SSH

NOTE

You should install Business Central and the Process Server on different servers inproduction environments

For information about installing the headless Process Automation Manager controllersee Chapter 7 Installing and running the headless Process Automation Manager controller

51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE

Business Central is a web console that enables you to perform the following tasks over individualcomponents in a unified web-based environment

Create manage and edit your rules processes and related assets

Manage connected Process Server instances and their containers

Execute runtime operations against processes and tasks in Process Server instancesconnected to Business Central

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-business-central-eap7-deployablezip

Procedure

1 Extract the rhpam-700-business-central-eap7-deployablezip file to atemporary directory In the following examples this directory is called TEMP_DIR

2 Copy the contents of the TEMP_DIRrhpam-700-business-central-eap7-deployablejboss-eap-71 directory to EAP_HOME When prompted merge or replacefiles

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

13

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 6: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

PREFACEThis document describes how to install Red Hat Process Automation Manager on a Red Hat JBossEnterprise Application Platform 71 instance

Prerequisite

Review the information in Planning a Red Hat Process Automation Manager installation

PREFACE

3

CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATIONMANAGER

Red Hat Process Automation Manager is the Red Hat middleware platform for creating businessautomation applications and microservices It enables enterprise business and IT users to documentsimulate manage automate and monitor business processes and policies It is designed to empowerbusiness and IT users to collaborate more effectively so business applications can be changed easilyand quickly

Red Hat JBoss Enterprise Application Platform (Red Hat JBoss EAP) 71 is a certified implementationof the Java Enterprise Edition 7 (Java EE 7) full and web profile specifications Red Hat JBoss EAPprovides preconfigured options for features such as high availability clustering messaging anddistributed caching It also enables users to write deploy and run applications using the various APIsand services that Red Hat JBoss EAP provides

The instructions in this document explain how to install Red Hat Process Automation Manager in a RedHat JBoss EAP 71 server instance For instruction on how to install Red Hat Process AutomationManager in other environments see the following documents

Installing and configuring Process Server on IBM WebSphere Application Server

Installing and configuring Process Server on Oracle WebLogic Server

Deploying a Red Hat Process Automation Manager 70 authoring environment on Red Hat OpenShiftContainer Platform

Deploying a Red Hat Process Automation Manager 70 immutable server environment on Red HatOpenShift Container Platform

Deploying a Red Hat Process Automation Manager 70 managed server environment on Red HatOpenShift Container Platform

For information on supported components see the following documents What is the mappingbetween RHPAM product and maven library version Red Hat Process Automation Manager 7Supported Configurations

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

4

CHAPTER 2 ROLES AND USERSTo access Business Central or Process Server you must create users and assign them appropriateroles before the servers are started This section describes available Red Hat Process AutomationManager user roles

NOTE

The admin analyst developer manager process-admin user and rest-allroles are reserved for Business Central The kie-server role is reserved for ProcessServer For this reason the available roles can differ depending on whether BusinessCentral Process Server or both are installed

admin Users with the admin role are the Business Central administrators They can manageusers and create clone and manage the repositories They have full access to make requiredchanges in the application Users with the admin role have access to all areas within Red HatProcess Automation Manager

analyst Users with the analyst role have access to all high-level features They can modeland execute their projects However these users cannot add contributors to spaces or deletespaces in the Design rarr Projects view Access to the Deploy rarr Execution Servers view whichis intended for administrators is not available to users with the analyst role However theDeploy button is available to these users when they access the Library perspective

developer Users with the developer role have access to almost all features and canmanage rules models process flows forms and dashboards They can manage the assetrepository they can create build and deploy projects and they can use Red Hat JBossDeveloper Studio to view processes Only certain administrative functions such as creatingand cloning a new repository are hidden from users with the developer role

manager Users with the manager role can view reports These users are usually interested instatistics about the business processes and their performance business indicators and otherbusiness-related reporting A user with this role has access only to process and task reports

process-admin Users with the process-admin role are business process administratorsThey have full access to business processes business tasks and execution errors These userscan also view business reports and have access to the Task Inbox list

user Users with the user role can work on the Task Inbox list which contains business tasksthat are part of currently running processes Users with this role can view process and taskreports and manage processes

rest-all Users with the rest-all role can access Business Central REST capabilities

kie-server Users with the kie-server role can access Process Server (KIE Server) RESTcapabilities This role is mandatory for users to have access to Manage and Track views inBusiness Central

CHAPTER 2 ROLES AND USERS

5

CHAPTER 3 DOWNLOADING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION FILES

Depending on your environment and installation requirements download a Red Hat ProcessAutomation Manager distribution

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download one of the following product distributions

To use the installer to install Red Hat Process Automation Manager on Red Hat JBoss EAP71 download Red Hat Process Automation Manager 700 Installer (rhpam-installer-700jar) The installer graphical user interface guides you through theinstallation process

To install Red Hat Process Automation Manager on Red Hat JBoss EAP 71 using thedeployable zip files download the following files

Red Hat Process Automation Manager 700 Process Server for All Supported EE7Containers (rhpam-700-kie-server-ee7zip)

Red Hat Process Automation Manager 700 Business Central Deployable for EAP 7(rhpam-700-business-central-eap7-deployablezip)

The ZIP files do not require a graphical user interface so you can install Red Hat ProcessAutomation Manager using SSH

To run Business Central without needing to deploy it to an application server downloadRed Hat Process Automation Manager 700 Decision Central Standalone (rhpam-700-business-central-standalonejar)

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

6

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATIONMANAGER INSTALLER

This section describes how to install Process Server and the headless Process Automation Managercontroller using the installer JAR file The JAR file is an executable file that installs Red Hat ProcessAutomation Manager in an existing Red Hat JBoss EAP 71 server installation You can run the installerin interactive or command line interface (CLI) mode

NOTE

The Red Hat Process Automation Manager JAR file installer does not support the RedHat JBoss EAP distribution installed by yum or RPM Package Manager If you want toinstall Red Hat Process Automation Manager in this type of Red Hat JBoss EAPinstallation download the Red Hat Process Automation Manager 70 Deployable forRed Hat JBoss EAP 71 file and follow the steps in Chapter 5 Installing Red Hat ProcessAutomation Manager from ZIP files

NOTE

Because IBM JDK cannot use keystores generated on other JDKs you cannot installRed Hat Process Automation Manager into an existing Red Hat JBoss EAP installationrunning on IBM JDK with a keystore generated on another JDK

Next steps

Follow the instructions in one of the following sections

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

Section 43 ldquoUsing the installer to configure Process Server with the Process AutomationManager controllerrdquo

41 USING THE INSTALLER IN INTERACTIVE MODE

The installer for Red Hat Process Automation Manager is an executable JAR file You can use it toinstall Red Hat Process Automation Manager in an existing Red Hat JBoss EAP 71 server installation

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in $PATH environment variable On Red Hat Enterprise Linux it isincluded in the java-$JAVA_VERSION-openjdk-devel package

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

7

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer JAR file andenter the following command

java -jar rhpam-installer-700jar

NOTE

When running the installer on Windows you may be prompted to provideadministrator credentials during the installation To prevent this requirementadd the izpackmode=privileged option to the installation command

java -Dizpackmode=privileged -jarrhpam-installer-700jar

Furthermore when running the installer on a 32-bit Java virtual machine youmight encounter memory limitations To prevent this issue run this command

java -XXMaxHeapSize=4g -jarrhpam-installer-700jar

The graphical installer displays a splash screen and a license agreement page

2 Click I accept the terms of this license agreement and click Next

3 Specify the Red Hat JBoss EAP 71 server home where you want to install Red Hat ProcessAutomation Manager and click Next

4 Select the components that you want to install and click Next

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments To do this run the installer twice

5 Create a user and click Next By default the new user is given the admin kie-server and rest-all roles To select another role deselect admin For more information see Chapter 2Roles and users

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

8

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

Make a note of the user name and password You will need them to access Business Centraland Process Server

6 On the Installation Overview page click Next to start the installation The InstallationOverview page lists the components that you will install

7 When the installation has completed click Next

8 On the Configure Runtime Environment page choose whether to perform the defaultinstallation or perform an advanced configurationIf you choose Perform advanced configuration you can choose to configure databasesettings or customize certain Process Server options

9 If you selected Customize database settings on the JDBC Drive Configuration page specifya data source JDBC driver vendor select one or more Driver JAR files and click NextA data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the datasource on the Java Naming and Directory Interface (JNDI) tree or in the local applicationcontext and request a database connection to retrieve data You must configure data sourcesfor Process Server to ensure proper data exchange between the servers and the designateddatabase

10 If you selected Customize Process Server settings change any of the following if desired

Change the name of the Process Server property

Change the URL of the controller

Deselect any Process Server server options

11 Click Next to configure the runtime environment

12 When Processing finished appears at the top of the screen click Next to complete theinstallation

13 If desired click Generate Installation Script and Properties File to save the installation datain an XML file then click Done You can use this file to automatically install Red Hat ProcessAutomation Manager on the same type of server Note that you must change the installpath parameter in the XML file to specify the path of the new server that you want toinstall Red Hat Process Automation Manager on Enter the following command to perform aninstallation with the XML file

java -jar rhpam-installer-700jar ltpath-to-filegt

You have successfully installed Red Hat Process Automation Manager using the installer If youinstalled only Business Central repeat these steps to install Process Server on a separate server

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

9

42 USING THE INSTALLER IN CLI MODE

You can run the Red Hat Process Automation Manager installer through the command-line interface(CLI)

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in the $PATH environment variable On Red Hat Enterprise Linux itis included in the java-$JAVA_VERSION-openjdk-devel package

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer file andenter the following command

java -jar rhpam-installer-700jar -console

The command-line interactive process will start and display the End-User License Agreement

press 1 to continue 2 to quit 3 to redisplay

2 Read the license agreement enter 1 and press Enter to continue

Specify the home directory of one of the following servers Red Hat JBoss EAP 71 or Red Hat JBoss Web Server 50

3 Enter the parent directory of an existing Red Hat JBoss EAP 71 installationThe installer will verify the location of the installation at the location provided Enter 1 toconfirm and continue

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments

4 Follow the instructions in the installer to complete the installation

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

10

NOTE

When you create the user name and password make sure that the specified username does not conflict with any known title of a role or a group For example ifthere is a role called admin you should not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character (not including the character amp)

Make a note of the user name and password You will need them to accessBusiness Central and Process Server

5 When the installation has completed you will see this message

Would you like to generate an automatic installation script and properties file

6 Enter y to create an XML file that contains the installation data or n to complete theinstallation If you enter y you are prompted to specify a path for the XML file

7 Enter a path or press the Enter key to accept the suggested path

8 If you installed only Business Central repeat these steps to install Process Server on aseparate server

43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITHTHE PROCESS AUTOMATION MANAGER CONTROLLER

Process Server can be managed by the Process Automation Manager controller or it can beunmanaged If Process Server is unmanaged you must manually create and maintain containers IfProcess Server is managed the Process Automation Manager controller manages the Process Serverconfiguration and you interact with the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

You can use the installer in interactive or CLI mode to install Business Central and Process Server andthen configure Process Server with the Process Automation Manager controller

NOTE

If you do not install Business Central see Chapter 7 Installing and running the headlessProcess Automation Manager controller for information about using the headless ProcessAutomation Manager controller

Prerequisites

Two computers with backed-up Red Hat JBoss EAP 71 or higher server installations areavailable

Sufficient user permissions to complete the installation are granted

Procedure

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

11

1 On the first computer run the installer in interactive mode or CLI mode See one of thefollowing sections for more information

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

2 On the Component Selection page clear the Process Server box

3 Complete the Business Central installation

4 On the second computer run the installer in interactive mode or CLI mode

5 On the Component Selection page clear the Business Central box

6 On the Configure Runtime Environment page select Perform Advanced Configuration

7 Select Customize Process Server properties and click Next

8 On the Process Server Properties Configuration page click New Server Configuration to adda Process Server and specify a unique name for that Process Server This name will appear inBusiness Central and enable you to distinguish between different Process Servers

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

12

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATIONMANAGER FROM ZIP FILES

The Red Hat Process Automation Manager ZIP files (one for Business Central and one for ProcessServer) do not require a graphical user interface so you can install Red Hat Process AutomationManager using SSH

NOTE

You should install Business Central and the Process Server on different servers inproduction environments

For information about installing the headless Process Automation Manager controllersee Chapter 7 Installing and running the headless Process Automation Manager controller

51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE

Business Central is a web console that enables you to perform the following tasks over individualcomponents in a unified web-based environment

Create manage and edit your rules processes and related assets

Manage connected Process Server instances and their containers

Execute runtime operations against processes and tasks in Process Server instancesconnected to Business Central

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-business-central-eap7-deployablezip

Procedure

1 Extract the rhpam-700-business-central-eap7-deployablezip file to atemporary directory In the following examples this directory is called TEMP_DIR

2 Copy the contents of the TEMP_DIRrhpam-700-business-central-eap7-deployablejboss-eap-71 directory to EAP_HOME When prompted merge or replacefiles

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

13

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 7: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATIONMANAGER

Red Hat Process Automation Manager is the Red Hat middleware platform for creating businessautomation applications and microservices It enables enterprise business and IT users to documentsimulate manage automate and monitor business processes and policies It is designed to empowerbusiness and IT users to collaborate more effectively so business applications can be changed easilyand quickly

Red Hat JBoss Enterprise Application Platform (Red Hat JBoss EAP) 71 is a certified implementationof the Java Enterprise Edition 7 (Java EE 7) full and web profile specifications Red Hat JBoss EAPprovides preconfigured options for features such as high availability clustering messaging anddistributed caching It also enables users to write deploy and run applications using the various APIsand services that Red Hat JBoss EAP provides

The instructions in this document explain how to install Red Hat Process Automation Manager in a RedHat JBoss EAP 71 server instance For instruction on how to install Red Hat Process AutomationManager in other environments see the following documents

Installing and configuring Process Server on IBM WebSphere Application Server

Installing and configuring Process Server on Oracle WebLogic Server

Deploying a Red Hat Process Automation Manager 70 authoring environment on Red Hat OpenShiftContainer Platform

Deploying a Red Hat Process Automation Manager 70 immutable server environment on Red HatOpenShift Container Platform

Deploying a Red Hat Process Automation Manager 70 managed server environment on Red HatOpenShift Container Platform

For information on supported components see the following documents What is the mappingbetween RHPAM product and maven library version Red Hat Process Automation Manager 7Supported Configurations

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

4

CHAPTER 2 ROLES AND USERSTo access Business Central or Process Server you must create users and assign them appropriateroles before the servers are started This section describes available Red Hat Process AutomationManager user roles

NOTE

The admin analyst developer manager process-admin user and rest-allroles are reserved for Business Central The kie-server role is reserved for ProcessServer For this reason the available roles can differ depending on whether BusinessCentral Process Server or both are installed

admin Users with the admin role are the Business Central administrators They can manageusers and create clone and manage the repositories They have full access to make requiredchanges in the application Users with the admin role have access to all areas within Red HatProcess Automation Manager

analyst Users with the analyst role have access to all high-level features They can modeland execute their projects However these users cannot add contributors to spaces or deletespaces in the Design rarr Projects view Access to the Deploy rarr Execution Servers view whichis intended for administrators is not available to users with the analyst role However theDeploy button is available to these users when they access the Library perspective

developer Users with the developer role have access to almost all features and canmanage rules models process flows forms and dashboards They can manage the assetrepository they can create build and deploy projects and they can use Red Hat JBossDeveloper Studio to view processes Only certain administrative functions such as creatingand cloning a new repository are hidden from users with the developer role

manager Users with the manager role can view reports These users are usually interested instatistics about the business processes and their performance business indicators and otherbusiness-related reporting A user with this role has access only to process and task reports

process-admin Users with the process-admin role are business process administratorsThey have full access to business processes business tasks and execution errors These userscan also view business reports and have access to the Task Inbox list

user Users with the user role can work on the Task Inbox list which contains business tasksthat are part of currently running processes Users with this role can view process and taskreports and manage processes

rest-all Users with the rest-all role can access Business Central REST capabilities

kie-server Users with the kie-server role can access Process Server (KIE Server) RESTcapabilities This role is mandatory for users to have access to Manage and Track views inBusiness Central

CHAPTER 2 ROLES AND USERS

5

CHAPTER 3 DOWNLOADING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION FILES

Depending on your environment and installation requirements download a Red Hat ProcessAutomation Manager distribution

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download one of the following product distributions

To use the installer to install Red Hat Process Automation Manager on Red Hat JBoss EAP71 download Red Hat Process Automation Manager 700 Installer (rhpam-installer-700jar) The installer graphical user interface guides you through theinstallation process

To install Red Hat Process Automation Manager on Red Hat JBoss EAP 71 using thedeployable zip files download the following files

Red Hat Process Automation Manager 700 Process Server for All Supported EE7Containers (rhpam-700-kie-server-ee7zip)

Red Hat Process Automation Manager 700 Business Central Deployable for EAP 7(rhpam-700-business-central-eap7-deployablezip)

The ZIP files do not require a graphical user interface so you can install Red Hat ProcessAutomation Manager using SSH

To run Business Central without needing to deploy it to an application server downloadRed Hat Process Automation Manager 700 Decision Central Standalone (rhpam-700-business-central-standalonejar)

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

6

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATIONMANAGER INSTALLER

This section describes how to install Process Server and the headless Process Automation Managercontroller using the installer JAR file The JAR file is an executable file that installs Red Hat ProcessAutomation Manager in an existing Red Hat JBoss EAP 71 server installation You can run the installerin interactive or command line interface (CLI) mode

NOTE

The Red Hat Process Automation Manager JAR file installer does not support the RedHat JBoss EAP distribution installed by yum or RPM Package Manager If you want toinstall Red Hat Process Automation Manager in this type of Red Hat JBoss EAPinstallation download the Red Hat Process Automation Manager 70 Deployable forRed Hat JBoss EAP 71 file and follow the steps in Chapter 5 Installing Red Hat ProcessAutomation Manager from ZIP files

NOTE

Because IBM JDK cannot use keystores generated on other JDKs you cannot installRed Hat Process Automation Manager into an existing Red Hat JBoss EAP installationrunning on IBM JDK with a keystore generated on another JDK

Next steps

Follow the instructions in one of the following sections

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

Section 43 ldquoUsing the installer to configure Process Server with the Process AutomationManager controllerrdquo

41 USING THE INSTALLER IN INTERACTIVE MODE

The installer for Red Hat Process Automation Manager is an executable JAR file You can use it toinstall Red Hat Process Automation Manager in an existing Red Hat JBoss EAP 71 server installation

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in $PATH environment variable On Red Hat Enterprise Linux it isincluded in the java-$JAVA_VERSION-openjdk-devel package

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

7

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer JAR file andenter the following command

java -jar rhpam-installer-700jar

NOTE

When running the installer on Windows you may be prompted to provideadministrator credentials during the installation To prevent this requirementadd the izpackmode=privileged option to the installation command

java -Dizpackmode=privileged -jarrhpam-installer-700jar

Furthermore when running the installer on a 32-bit Java virtual machine youmight encounter memory limitations To prevent this issue run this command

java -XXMaxHeapSize=4g -jarrhpam-installer-700jar

The graphical installer displays a splash screen and a license agreement page

2 Click I accept the terms of this license agreement and click Next

3 Specify the Red Hat JBoss EAP 71 server home where you want to install Red Hat ProcessAutomation Manager and click Next

4 Select the components that you want to install and click Next

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments To do this run the installer twice

5 Create a user and click Next By default the new user is given the admin kie-server and rest-all roles To select another role deselect admin For more information see Chapter 2Roles and users

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

8

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

Make a note of the user name and password You will need them to access Business Centraland Process Server

6 On the Installation Overview page click Next to start the installation The InstallationOverview page lists the components that you will install

7 When the installation has completed click Next

8 On the Configure Runtime Environment page choose whether to perform the defaultinstallation or perform an advanced configurationIf you choose Perform advanced configuration you can choose to configure databasesettings or customize certain Process Server options

9 If you selected Customize database settings on the JDBC Drive Configuration page specifya data source JDBC driver vendor select one or more Driver JAR files and click NextA data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the datasource on the Java Naming and Directory Interface (JNDI) tree or in the local applicationcontext and request a database connection to retrieve data You must configure data sourcesfor Process Server to ensure proper data exchange between the servers and the designateddatabase

10 If you selected Customize Process Server settings change any of the following if desired

Change the name of the Process Server property

Change the URL of the controller

Deselect any Process Server server options

11 Click Next to configure the runtime environment

12 When Processing finished appears at the top of the screen click Next to complete theinstallation

13 If desired click Generate Installation Script and Properties File to save the installation datain an XML file then click Done You can use this file to automatically install Red Hat ProcessAutomation Manager on the same type of server Note that you must change the installpath parameter in the XML file to specify the path of the new server that you want toinstall Red Hat Process Automation Manager on Enter the following command to perform aninstallation with the XML file

java -jar rhpam-installer-700jar ltpath-to-filegt

You have successfully installed Red Hat Process Automation Manager using the installer If youinstalled only Business Central repeat these steps to install Process Server on a separate server

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

9

42 USING THE INSTALLER IN CLI MODE

You can run the Red Hat Process Automation Manager installer through the command-line interface(CLI)

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in the $PATH environment variable On Red Hat Enterprise Linux itis included in the java-$JAVA_VERSION-openjdk-devel package

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer file andenter the following command

java -jar rhpam-installer-700jar -console

The command-line interactive process will start and display the End-User License Agreement

press 1 to continue 2 to quit 3 to redisplay

2 Read the license agreement enter 1 and press Enter to continue

Specify the home directory of one of the following servers Red Hat JBoss EAP 71 or Red Hat JBoss Web Server 50

3 Enter the parent directory of an existing Red Hat JBoss EAP 71 installationThe installer will verify the location of the installation at the location provided Enter 1 toconfirm and continue

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments

4 Follow the instructions in the installer to complete the installation

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

10

NOTE

When you create the user name and password make sure that the specified username does not conflict with any known title of a role or a group For example ifthere is a role called admin you should not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character (not including the character amp)

Make a note of the user name and password You will need them to accessBusiness Central and Process Server

5 When the installation has completed you will see this message

Would you like to generate an automatic installation script and properties file

6 Enter y to create an XML file that contains the installation data or n to complete theinstallation If you enter y you are prompted to specify a path for the XML file

7 Enter a path or press the Enter key to accept the suggested path

8 If you installed only Business Central repeat these steps to install Process Server on aseparate server

43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITHTHE PROCESS AUTOMATION MANAGER CONTROLLER

Process Server can be managed by the Process Automation Manager controller or it can beunmanaged If Process Server is unmanaged you must manually create and maintain containers IfProcess Server is managed the Process Automation Manager controller manages the Process Serverconfiguration and you interact with the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

You can use the installer in interactive or CLI mode to install Business Central and Process Server andthen configure Process Server with the Process Automation Manager controller

NOTE

If you do not install Business Central see Chapter 7 Installing and running the headlessProcess Automation Manager controller for information about using the headless ProcessAutomation Manager controller

Prerequisites

Two computers with backed-up Red Hat JBoss EAP 71 or higher server installations areavailable

Sufficient user permissions to complete the installation are granted

Procedure

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

11

1 On the first computer run the installer in interactive mode or CLI mode See one of thefollowing sections for more information

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

2 On the Component Selection page clear the Process Server box

3 Complete the Business Central installation

4 On the second computer run the installer in interactive mode or CLI mode

5 On the Component Selection page clear the Business Central box

6 On the Configure Runtime Environment page select Perform Advanced Configuration

7 Select Customize Process Server properties and click Next

8 On the Process Server Properties Configuration page click New Server Configuration to adda Process Server and specify a unique name for that Process Server This name will appear inBusiness Central and enable you to distinguish between different Process Servers

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

12

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATIONMANAGER FROM ZIP FILES

The Red Hat Process Automation Manager ZIP files (one for Business Central and one for ProcessServer) do not require a graphical user interface so you can install Red Hat Process AutomationManager using SSH

NOTE

You should install Business Central and the Process Server on different servers inproduction environments

For information about installing the headless Process Automation Manager controllersee Chapter 7 Installing and running the headless Process Automation Manager controller

51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE

Business Central is a web console that enables you to perform the following tasks over individualcomponents in a unified web-based environment

Create manage and edit your rules processes and related assets

Manage connected Process Server instances and their containers

Execute runtime operations against processes and tasks in Process Server instancesconnected to Business Central

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-business-central-eap7-deployablezip

Procedure

1 Extract the rhpam-700-business-central-eap7-deployablezip file to atemporary directory In the following examples this directory is called TEMP_DIR

2 Copy the contents of the TEMP_DIRrhpam-700-business-central-eap7-deployablejboss-eap-71 directory to EAP_HOME When prompted merge or replacefiles

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

13

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 8: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

CHAPTER 2 ROLES AND USERSTo access Business Central or Process Server you must create users and assign them appropriateroles before the servers are started This section describes available Red Hat Process AutomationManager user roles

NOTE

The admin analyst developer manager process-admin user and rest-allroles are reserved for Business Central The kie-server role is reserved for ProcessServer For this reason the available roles can differ depending on whether BusinessCentral Process Server or both are installed

admin Users with the admin role are the Business Central administrators They can manageusers and create clone and manage the repositories They have full access to make requiredchanges in the application Users with the admin role have access to all areas within Red HatProcess Automation Manager

analyst Users with the analyst role have access to all high-level features They can modeland execute their projects However these users cannot add contributors to spaces or deletespaces in the Design rarr Projects view Access to the Deploy rarr Execution Servers view whichis intended for administrators is not available to users with the analyst role However theDeploy button is available to these users when they access the Library perspective

developer Users with the developer role have access to almost all features and canmanage rules models process flows forms and dashboards They can manage the assetrepository they can create build and deploy projects and they can use Red Hat JBossDeveloper Studio to view processes Only certain administrative functions such as creatingand cloning a new repository are hidden from users with the developer role

manager Users with the manager role can view reports These users are usually interested instatistics about the business processes and their performance business indicators and otherbusiness-related reporting A user with this role has access only to process and task reports

process-admin Users with the process-admin role are business process administratorsThey have full access to business processes business tasks and execution errors These userscan also view business reports and have access to the Task Inbox list

user Users with the user role can work on the Task Inbox list which contains business tasksthat are part of currently running processes Users with this role can view process and taskreports and manage processes

rest-all Users with the rest-all role can access Business Central REST capabilities

kie-server Users with the kie-server role can access Process Server (KIE Server) RESTcapabilities This role is mandatory for users to have access to Manage and Track views inBusiness Central

CHAPTER 2 ROLES AND USERS

5

CHAPTER 3 DOWNLOADING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION FILES

Depending on your environment and installation requirements download a Red Hat ProcessAutomation Manager distribution

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download one of the following product distributions

To use the installer to install Red Hat Process Automation Manager on Red Hat JBoss EAP71 download Red Hat Process Automation Manager 700 Installer (rhpam-installer-700jar) The installer graphical user interface guides you through theinstallation process

To install Red Hat Process Automation Manager on Red Hat JBoss EAP 71 using thedeployable zip files download the following files

Red Hat Process Automation Manager 700 Process Server for All Supported EE7Containers (rhpam-700-kie-server-ee7zip)

Red Hat Process Automation Manager 700 Business Central Deployable for EAP 7(rhpam-700-business-central-eap7-deployablezip)

The ZIP files do not require a graphical user interface so you can install Red Hat ProcessAutomation Manager using SSH

To run Business Central without needing to deploy it to an application server downloadRed Hat Process Automation Manager 700 Decision Central Standalone (rhpam-700-business-central-standalonejar)

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

6

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATIONMANAGER INSTALLER

This section describes how to install Process Server and the headless Process Automation Managercontroller using the installer JAR file The JAR file is an executable file that installs Red Hat ProcessAutomation Manager in an existing Red Hat JBoss EAP 71 server installation You can run the installerin interactive or command line interface (CLI) mode

NOTE

The Red Hat Process Automation Manager JAR file installer does not support the RedHat JBoss EAP distribution installed by yum or RPM Package Manager If you want toinstall Red Hat Process Automation Manager in this type of Red Hat JBoss EAPinstallation download the Red Hat Process Automation Manager 70 Deployable forRed Hat JBoss EAP 71 file and follow the steps in Chapter 5 Installing Red Hat ProcessAutomation Manager from ZIP files

NOTE

Because IBM JDK cannot use keystores generated on other JDKs you cannot installRed Hat Process Automation Manager into an existing Red Hat JBoss EAP installationrunning on IBM JDK with a keystore generated on another JDK

Next steps

Follow the instructions in one of the following sections

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

Section 43 ldquoUsing the installer to configure Process Server with the Process AutomationManager controllerrdquo

41 USING THE INSTALLER IN INTERACTIVE MODE

The installer for Red Hat Process Automation Manager is an executable JAR file You can use it toinstall Red Hat Process Automation Manager in an existing Red Hat JBoss EAP 71 server installation

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in $PATH environment variable On Red Hat Enterprise Linux it isincluded in the java-$JAVA_VERSION-openjdk-devel package

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

7

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer JAR file andenter the following command

java -jar rhpam-installer-700jar

NOTE

When running the installer on Windows you may be prompted to provideadministrator credentials during the installation To prevent this requirementadd the izpackmode=privileged option to the installation command

java -Dizpackmode=privileged -jarrhpam-installer-700jar

Furthermore when running the installer on a 32-bit Java virtual machine youmight encounter memory limitations To prevent this issue run this command

java -XXMaxHeapSize=4g -jarrhpam-installer-700jar

The graphical installer displays a splash screen and a license agreement page

2 Click I accept the terms of this license agreement and click Next

3 Specify the Red Hat JBoss EAP 71 server home where you want to install Red Hat ProcessAutomation Manager and click Next

4 Select the components that you want to install and click Next

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments To do this run the installer twice

5 Create a user and click Next By default the new user is given the admin kie-server and rest-all roles To select another role deselect admin For more information see Chapter 2Roles and users

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

8

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

Make a note of the user name and password You will need them to access Business Centraland Process Server

6 On the Installation Overview page click Next to start the installation The InstallationOverview page lists the components that you will install

7 When the installation has completed click Next

8 On the Configure Runtime Environment page choose whether to perform the defaultinstallation or perform an advanced configurationIf you choose Perform advanced configuration you can choose to configure databasesettings or customize certain Process Server options

9 If you selected Customize database settings on the JDBC Drive Configuration page specifya data source JDBC driver vendor select one or more Driver JAR files and click NextA data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the datasource on the Java Naming and Directory Interface (JNDI) tree or in the local applicationcontext and request a database connection to retrieve data You must configure data sourcesfor Process Server to ensure proper data exchange between the servers and the designateddatabase

10 If you selected Customize Process Server settings change any of the following if desired

Change the name of the Process Server property

Change the URL of the controller

Deselect any Process Server server options

11 Click Next to configure the runtime environment

12 When Processing finished appears at the top of the screen click Next to complete theinstallation

13 If desired click Generate Installation Script and Properties File to save the installation datain an XML file then click Done You can use this file to automatically install Red Hat ProcessAutomation Manager on the same type of server Note that you must change the installpath parameter in the XML file to specify the path of the new server that you want toinstall Red Hat Process Automation Manager on Enter the following command to perform aninstallation with the XML file

java -jar rhpam-installer-700jar ltpath-to-filegt

You have successfully installed Red Hat Process Automation Manager using the installer If youinstalled only Business Central repeat these steps to install Process Server on a separate server

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

9

42 USING THE INSTALLER IN CLI MODE

You can run the Red Hat Process Automation Manager installer through the command-line interface(CLI)

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in the $PATH environment variable On Red Hat Enterprise Linux itis included in the java-$JAVA_VERSION-openjdk-devel package

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer file andenter the following command

java -jar rhpam-installer-700jar -console

The command-line interactive process will start and display the End-User License Agreement

press 1 to continue 2 to quit 3 to redisplay

2 Read the license agreement enter 1 and press Enter to continue

Specify the home directory of one of the following servers Red Hat JBoss EAP 71 or Red Hat JBoss Web Server 50

3 Enter the parent directory of an existing Red Hat JBoss EAP 71 installationThe installer will verify the location of the installation at the location provided Enter 1 toconfirm and continue

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments

4 Follow the instructions in the installer to complete the installation

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

10

NOTE

When you create the user name and password make sure that the specified username does not conflict with any known title of a role or a group For example ifthere is a role called admin you should not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character (not including the character amp)

Make a note of the user name and password You will need them to accessBusiness Central and Process Server

5 When the installation has completed you will see this message

Would you like to generate an automatic installation script and properties file

6 Enter y to create an XML file that contains the installation data or n to complete theinstallation If you enter y you are prompted to specify a path for the XML file

7 Enter a path or press the Enter key to accept the suggested path

8 If you installed only Business Central repeat these steps to install Process Server on aseparate server

43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITHTHE PROCESS AUTOMATION MANAGER CONTROLLER

Process Server can be managed by the Process Automation Manager controller or it can beunmanaged If Process Server is unmanaged you must manually create and maintain containers IfProcess Server is managed the Process Automation Manager controller manages the Process Serverconfiguration and you interact with the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

You can use the installer in interactive or CLI mode to install Business Central and Process Server andthen configure Process Server with the Process Automation Manager controller

NOTE

If you do not install Business Central see Chapter 7 Installing and running the headlessProcess Automation Manager controller for information about using the headless ProcessAutomation Manager controller

Prerequisites

Two computers with backed-up Red Hat JBoss EAP 71 or higher server installations areavailable

Sufficient user permissions to complete the installation are granted

Procedure

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

11

1 On the first computer run the installer in interactive mode or CLI mode See one of thefollowing sections for more information

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

2 On the Component Selection page clear the Process Server box

3 Complete the Business Central installation

4 On the second computer run the installer in interactive mode or CLI mode

5 On the Component Selection page clear the Business Central box

6 On the Configure Runtime Environment page select Perform Advanced Configuration

7 Select Customize Process Server properties and click Next

8 On the Process Server Properties Configuration page click New Server Configuration to adda Process Server and specify a unique name for that Process Server This name will appear inBusiness Central and enable you to distinguish between different Process Servers

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

12

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATIONMANAGER FROM ZIP FILES

The Red Hat Process Automation Manager ZIP files (one for Business Central and one for ProcessServer) do not require a graphical user interface so you can install Red Hat Process AutomationManager using SSH

NOTE

You should install Business Central and the Process Server on different servers inproduction environments

For information about installing the headless Process Automation Manager controllersee Chapter 7 Installing and running the headless Process Automation Manager controller

51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE

Business Central is a web console that enables you to perform the following tasks over individualcomponents in a unified web-based environment

Create manage and edit your rules processes and related assets

Manage connected Process Server instances and their containers

Execute runtime operations against processes and tasks in Process Server instancesconnected to Business Central

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-business-central-eap7-deployablezip

Procedure

1 Extract the rhpam-700-business-central-eap7-deployablezip file to atemporary directory In the following examples this directory is called TEMP_DIR

2 Copy the contents of the TEMP_DIRrhpam-700-business-central-eap7-deployablejboss-eap-71 directory to EAP_HOME When prompted merge or replacefiles

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

13

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 9: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

CHAPTER 3 DOWNLOADING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION FILES

Depending on your environment and installation requirements download a Red Hat ProcessAutomation Manager distribution

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download one of the following product distributions

To use the installer to install Red Hat Process Automation Manager on Red Hat JBoss EAP71 download Red Hat Process Automation Manager 700 Installer (rhpam-installer-700jar) The installer graphical user interface guides you through theinstallation process

To install Red Hat Process Automation Manager on Red Hat JBoss EAP 71 using thedeployable zip files download the following files

Red Hat Process Automation Manager 700 Process Server for All Supported EE7Containers (rhpam-700-kie-server-ee7zip)

Red Hat Process Automation Manager 700 Business Central Deployable for EAP 7(rhpam-700-business-central-eap7-deployablezip)

The ZIP files do not require a graphical user interface so you can install Red Hat ProcessAutomation Manager using SSH

To run Business Central without needing to deploy it to an application server downloadRed Hat Process Automation Manager 700 Decision Central Standalone (rhpam-700-business-central-standalonejar)

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

6

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATIONMANAGER INSTALLER

This section describes how to install Process Server and the headless Process Automation Managercontroller using the installer JAR file The JAR file is an executable file that installs Red Hat ProcessAutomation Manager in an existing Red Hat JBoss EAP 71 server installation You can run the installerin interactive or command line interface (CLI) mode

NOTE

The Red Hat Process Automation Manager JAR file installer does not support the RedHat JBoss EAP distribution installed by yum or RPM Package Manager If you want toinstall Red Hat Process Automation Manager in this type of Red Hat JBoss EAPinstallation download the Red Hat Process Automation Manager 70 Deployable forRed Hat JBoss EAP 71 file and follow the steps in Chapter 5 Installing Red Hat ProcessAutomation Manager from ZIP files

NOTE

Because IBM JDK cannot use keystores generated on other JDKs you cannot installRed Hat Process Automation Manager into an existing Red Hat JBoss EAP installationrunning on IBM JDK with a keystore generated on another JDK

Next steps

Follow the instructions in one of the following sections

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

Section 43 ldquoUsing the installer to configure Process Server with the Process AutomationManager controllerrdquo

41 USING THE INSTALLER IN INTERACTIVE MODE

The installer for Red Hat Process Automation Manager is an executable JAR file You can use it toinstall Red Hat Process Automation Manager in an existing Red Hat JBoss EAP 71 server installation

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in $PATH environment variable On Red Hat Enterprise Linux it isincluded in the java-$JAVA_VERSION-openjdk-devel package

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

7

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer JAR file andenter the following command

java -jar rhpam-installer-700jar

NOTE

When running the installer on Windows you may be prompted to provideadministrator credentials during the installation To prevent this requirementadd the izpackmode=privileged option to the installation command

java -Dizpackmode=privileged -jarrhpam-installer-700jar

Furthermore when running the installer on a 32-bit Java virtual machine youmight encounter memory limitations To prevent this issue run this command

java -XXMaxHeapSize=4g -jarrhpam-installer-700jar

The graphical installer displays a splash screen and a license agreement page

2 Click I accept the terms of this license agreement and click Next

3 Specify the Red Hat JBoss EAP 71 server home where you want to install Red Hat ProcessAutomation Manager and click Next

4 Select the components that you want to install and click Next

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments To do this run the installer twice

5 Create a user and click Next By default the new user is given the admin kie-server and rest-all roles To select another role deselect admin For more information see Chapter 2Roles and users

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

8

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

Make a note of the user name and password You will need them to access Business Centraland Process Server

6 On the Installation Overview page click Next to start the installation The InstallationOverview page lists the components that you will install

7 When the installation has completed click Next

8 On the Configure Runtime Environment page choose whether to perform the defaultinstallation or perform an advanced configurationIf you choose Perform advanced configuration you can choose to configure databasesettings or customize certain Process Server options

9 If you selected Customize database settings on the JDBC Drive Configuration page specifya data source JDBC driver vendor select one or more Driver JAR files and click NextA data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the datasource on the Java Naming and Directory Interface (JNDI) tree or in the local applicationcontext and request a database connection to retrieve data You must configure data sourcesfor Process Server to ensure proper data exchange between the servers and the designateddatabase

10 If you selected Customize Process Server settings change any of the following if desired

Change the name of the Process Server property

Change the URL of the controller

Deselect any Process Server server options

11 Click Next to configure the runtime environment

12 When Processing finished appears at the top of the screen click Next to complete theinstallation

13 If desired click Generate Installation Script and Properties File to save the installation datain an XML file then click Done You can use this file to automatically install Red Hat ProcessAutomation Manager on the same type of server Note that you must change the installpath parameter in the XML file to specify the path of the new server that you want toinstall Red Hat Process Automation Manager on Enter the following command to perform aninstallation with the XML file

java -jar rhpam-installer-700jar ltpath-to-filegt

You have successfully installed Red Hat Process Automation Manager using the installer If youinstalled only Business Central repeat these steps to install Process Server on a separate server

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

9

42 USING THE INSTALLER IN CLI MODE

You can run the Red Hat Process Automation Manager installer through the command-line interface(CLI)

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in the $PATH environment variable On Red Hat Enterprise Linux itis included in the java-$JAVA_VERSION-openjdk-devel package

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer file andenter the following command

java -jar rhpam-installer-700jar -console

The command-line interactive process will start and display the End-User License Agreement

press 1 to continue 2 to quit 3 to redisplay

2 Read the license agreement enter 1 and press Enter to continue

Specify the home directory of one of the following servers Red Hat JBoss EAP 71 or Red Hat JBoss Web Server 50

3 Enter the parent directory of an existing Red Hat JBoss EAP 71 installationThe installer will verify the location of the installation at the location provided Enter 1 toconfirm and continue

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments

4 Follow the instructions in the installer to complete the installation

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

10

NOTE

When you create the user name and password make sure that the specified username does not conflict with any known title of a role or a group For example ifthere is a role called admin you should not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character (not including the character amp)

Make a note of the user name and password You will need them to accessBusiness Central and Process Server

5 When the installation has completed you will see this message

Would you like to generate an automatic installation script and properties file

6 Enter y to create an XML file that contains the installation data or n to complete theinstallation If you enter y you are prompted to specify a path for the XML file

7 Enter a path or press the Enter key to accept the suggested path

8 If you installed only Business Central repeat these steps to install Process Server on aseparate server

43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITHTHE PROCESS AUTOMATION MANAGER CONTROLLER

Process Server can be managed by the Process Automation Manager controller or it can beunmanaged If Process Server is unmanaged you must manually create and maintain containers IfProcess Server is managed the Process Automation Manager controller manages the Process Serverconfiguration and you interact with the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

You can use the installer in interactive or CLI mode to install Business Central and Process Server andthen configure Process Server with the Process Automation Manager controller

NOTE

If you do not install Business Central see Chapter 7 Installing and running the headlessProcess Automation Manager controller for information about using the headless ProcessAutomation Manager controller

Prerequisites

Two computers with backed-up Red Hat JBoss EAP 71 or higher server installations areavailable

Sufficient user permissions to complete the installation are granted

Procedure

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

11

1 On the first computer run the installer in interactive mode or CLI mode See one of thefollowing sections for more information

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

2 On the Component Selection page clear the Process Server box

3 Complete the Business Central installation

4 On the second computer run the installer in interactive mode or CLI mode

5 On the Component Selection page clear the Business Central box

6 On the Configure Runtime Environment page select Perform Advanced Configuration

7 Select Customize Process Server properties and click Next

8 On the Process Server Properties Configuration page click New Server Configuration to adda Process Server and specify a unique name for that Process Server This name will appear inBusiness Central and enable you to distinguish between different Process Servers

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

12

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATIONMANAGER FROM ZIP FILES

The Red Hat Process Automation Manager ZIP files (one for Business Central and one for ProcessServer) do not require a graphical user interface so you can install Red Hat Process AutomationManager using SSH

NOTE

You should install Business Central and the Process Server on different servers inproduction environments

For information about installing the headless Process Automation Manager controllersee Chapter 7 Installing and running the headless Process Automation Manager controller

51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE

Business Central is a web console that enables you to perform the following tasks over individualcomponents in a unified web-based environment

Create manage and edit your rules processes and related assets

Manage connected Process Server instances and their containers

Execute runtime operations against processes and tasks in Process Server instancesconnected to Business Central

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-business-central-eap7-deployablezip

Procedure

1 Extract the rhpam-700-business-central-eap7-deployablezip file to atemporary directory In the following examples this directory is called TEMP_DIR

2 Copy the contents of the TEMP_DIRrhpam-700-business-central-eap7-deployablejboss-eap-71 directory to EAP_HOME When prompted merge or replacefiles

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

13

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 10: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATIONMANAGER INSTALLER

This section describes how to install Process Server and the headless Process Automation Managercontroller using the installer JAR file The JAR file is an executable file that installs Red Hat ProcessAutomation Manager in an existing Red Hat JBoss EAP 71 server installation You can run the installerin interactive or command line interface (CLI) mode

NOTE

The Red Hat Process Automation Manager JAR file installer does not support the RedHat JBoss EAP distribution installed by yum or RPM Package Manager If you want toinstall Red Hat Process Automation Manager in this type of Red Hat JBoss EAPinstallation download the Red Hat Process Automation Manager 70 Deployable forRed Hat JBoss EAP 71 file and follow the steps in Chapter 5 Installing Red Hat ProcessAutomation Manager from ZIP files

NOTE

Because IBM JDK cannot use keystores generated on other JDKs you cannot installRed Hat Process Automation Manager into an existing Red Hat JBoss EAP installationrunning on IBM JDK with a keystore generated on another JDK

Next steps

Follow the instructions in one of the following sections

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

Section 43 ldquoUsing the installer to configure Process Server with the Process AutomationManager controllerrdquo

41 USING THE INSTALLER IN INTERACTIVE MODE

The installer for Red Hat Process Automation Manager is an executable JAR file You can use it toinstall Red Hat Process Automation Manager in an existing Red Hat JBoss EAP 71 server installation

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in $PATH environment variable On Red Hat Enterprise Linux it isincluded in the java-$JAVA_VERSION-openjdk-devel package

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

7

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer JAR file andenter the following command

java -jar rhpam-installer-700jar

NOTE

When running the installer on Windows you may be prompted to provideadministrator credentials during the installation To prevent this requirementadd the izpackmode=privileged option to the installation command

java -Dizpackmode=privileged -jarrhpam-installer-700jar

Furthermore when running the installer on a 32-bit Java virtual machine youmight encounter memory limitations To prevent this issue run this command

java -XXMaxHeapSize=4g -jarrhpam-installer-700jar

The graphical installer displays a splash screen and a license agreement page

2 Click I accept the terms of this license agreement and click Next

3 Specify the Red Hat JBoss EAP 71 server home where you want to install Red Hat ProcessAutomation Manager and click Next

4 Select the components that you want to install and click Next

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments To do this run the installer twice

5 Create a user and click Next By default the new user is given the admin kie-server and rest-all roles To select another role deselect admin For more information see Chapter 2Roles and users

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

8

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

Make a note of the user name and password You will need them to access Business Centraland Process Server

6 On the Installation Overview page click Next to start the installation The InstallationOverview page lists the components that you will install

7 When the installation has completed click Next

8 On the Configure Runtime Environment page choose whether to perform the defaultinstallation or perform an advanced configurationIf you choose Perform advanced configuration you can choose to configure databasesettings or customize certain Process Server options

9 If you selected Customize database settings on the JDBC Drive Configuration page specifya data source JDBC driver vendor select one or more Driver JAR files and click NextA data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the datasource on the Java Naming and Directory Interface (JNDI) tree or in the local applicationcontext and request a database connection to retrieve data You must configure data sourcesfor Process Server to ensure proper data exchange between the servers and the designateddatabase

10 If you selected Customize Process Server settings change any of the following if desired

Change the name of the Process Server property

Change the URL of the controller

Deselect any Process Server server options

11 Click Next to configure the runtime environment

12 When Processing finished appears at the top of the screen click Next to complete theinstallation

13 If desired click Generate Installation Script and Properties File to save the installation datain an XML file then click Done You can use this file to automatically install Red Hat ProcessAutomation Manager on the same type of server Note that you must change the installpath parameter in the XML file to specify the path of the new server that you want toinstall Red Hat Process Automation Manager on Enter the following command to perform aninstallation with the XML file

java -jar rhpam-installer-700jar ltpath-to-filegt

You have successfully installed Red Hat Process Automation Manager using the installer If youinstalled only Business Central repeat these steps to install Process Server on a separate server

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

9

42 USING THE INSTALLER IN CLI MODE

You can run the Red Hat Process Automation Manager installer through the command-line interface(CLI)

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in the $PATH environment variable On Red Hat Enterprise Linux itis included in the java-$JAVA_VERSION-openjdk-devel package

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer file andenter the following command

java -jar rhpam-installer-700jar -console

The command-line interactive process will start and display the End-User License Agreement

press 1 to continue 2 to quit 3 to redisplay

2 Read the license agreement enter 1 and press Enter to continue

Specify the home directory of one of the following servers Red Hat JBoss EAP 71 or Red Hat JBoss Web Server 50

3 Enter the parent directory of an existing Red Hat JBoss EAP 71 installationThe installer will verify the location of the installation at the location provided Enter 1 toconfirm and continue

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments

4 Follow the instructions in the installer to complete the installation

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

10

NOTE

When you create the user name and password make sure that the specified username does not conflict with any known title of a role or a group For example ifthere is a role called admin you should not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character (not including the character amp)

Make a note of the user name and password You will need them to accessBusiness Central and Process Server

5 When the installation has completed you will see this message

Would you like to generate an automatic installation script and properties file

6 Enter y to create an XML file that contains the installation data or n to complete theinstallation If you enter y you are prompted to specify a path for the XML file

7 Enter a path or press the Enter key to accept the suggested path

8 If you installed only Business Central repeat these steps to install Process Server on aseparate server

43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITHTHE PROCESS AUTOMATION MANAGER CONTROLLER

Process Server can be managed by the Process Automation Manager controller or it can beunmanaged If Process Server is unmanaged you must manually create and maintain containers IfProcess Server is managed the Process Automation Manager controller manages the Process Serverconfiguration and you interact with the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

You can use the installer in interactive or CLI mode to install Business Central and Process Server andthen configure Process Server with the Process Automation Manager controller

NOTE

If you do not install Business Central see Chapter 7 Installing and running the headlessProcess Automation Manager controller for information about using the headless ProcessAutomation Manager controller

Prerequisites

Two computers with backed-up Red Hat JBoss EAP 71 or higher server installations areavailable

Sufficient user permissions to complete the installation are granted

Procedure

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

11

1 On the first computer run the installer in interactive mode or CLI mode See one of thefollowing sections for more information

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

2 On the Component Selection page clear the Process Server box

3 Complete the Business Central installation

4 On the second computer run the installer in interactive mode or CLI mode

5 On the Component Selection page clear the Business Central box

6 On the Configure Runtime Environment page select Perform Advanced Configuration

7 Select Customize Process Server properties and click Next

8 On the Process Server Properties Configuration page click New Server Configuration to adda Process Server and specify a unique name for that Process Server This name will appear inBusiness Central and enable you to distinguish between different Process Servers

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

12

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATIONMANAGER FROM ZIP FILES

The Red Hat Process Automation Manager ZIP files (one for Business Central and one for ProcessServer) do not require a graphical user interface so you can install Red Hat Process AutomationManager using SSH

NOTE

You should install Business Central and the Process Server on different servers inproduction environments

For information about installing the headless Process Automation Manager controllersee Chapter 7 Installing and running the headless Process Automation Manager controller

51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE

Business Central is a web console that enables you to perform the following tasks over individualcomponents in a unified web-based environment

Create manage and edit your rules processes and related assets

Manage connected Process Server instances and their containers

Execute runtime operations against processes and tasks in Process Server instancesconnected to Business Central

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-business-central-eap7-deployablezip

Procedure

1 Extract the rhpam-700-business-central-eap7-deployablezip file to atemporary directory In the following examples this directory is called TEMP_DIR

2 Copy the contents of the TEMP_DIRrhpam-700-business-central-eap7-deployablejboss-eap-71 directory to EAP_HOME When prompted merge or replacefiles

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

13

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 11: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer JAR file andenter the following command

java -jar rhpam-installer-700jar

NOTE

When running the installer on Windows you may be prompted to provideadministrator credentials during the installation To prevent this requirementadd the izpackmode=privileged option to the installation command

java -Dizpackmode=privileged -jarrhpam-installer-700jar

Furthermore when running the installer on a 32-bit Java virtual machine youmight encounter memory limitations To prevent this issue run this command

java -XXMaxHeapSize=4g -jarrhpam-installer-700jar

The graphical installer displays a splash screen and a license agreement page

2 Click I accept the terms of this license agreement and click Next

3 Specify the Red Hat JBoss EAP 71 server home where you want to install Red Hat ProcessAutomation Manager and click Next

4 Select the components that you want to install and click Next

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments To do this run the installer twice

5 Create a user and click Next By default the new user is given the admin kie-server and rest-all roles To select another role deselect admin For more information see Chapter 2Roles and users

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

8

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

Make a note of the user name and password You will need them to access Business Centraland Process Server

6 On the Installation Overview page click Next to start the installation The InstallationOverview page lists the components that you will install

7 When the installation has completed click Next

8 On the Configure Runtime Environment page choose whether to perform the defaultinstallation or perform an advanced configurationIf you choose Perform advanced configuration you can choose to configure databasesettings or customize certain Process Server options

9 If you selected Customize database settings on the JDBC Drive Configuration page specifya data source JDBC driver vendor select one or more Driver JAR files and click NextA data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the datasource on the Java Naming and Directory Interface (JNDI) tree or in the local applicationcontext and request a database connection to retrieve data You must configure data sourcesfor Process Server to ensure proper data exchange between the servers and the designateddatabase

10 If you selected Customize Process Server settings change any of the following if desired

Change the name of the Process Server property

Change the URL of the controller

Deselect any Process Server server options

11 Click Next to configure the runtime environment

12 When Processing finished appears at the top of the screen click Next to complete theinstallation

13 If desired click Generate Installation Script and Properties File to save the installation datain an XML file then click Done You can use this file to automatically install Red Hat ProcessAutomation Manager on the same type of server Note that you must change the installpath parameter in the XML file to specify the path of the new server that you want toinstall Red Hat Process Automation Manager on Enter the following command to perform aninstallation with the XML file

java -jar rhpam-installer-700jar ltpath-to-filegt

You have successfully installed Red Hat Process Automation Manager using the installer If youinstalled only Business Central repeat these steps to install Process Server on a separate server

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

9

42 USING THE INSTALLER IN CLI MODE

You can run the Red Hat Process Automation Manager installer through the command-line interface(CLI)

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in the $PATH environment variable On Red Hat Enterprise Linux itis included in the java-$JAVA_VERSION-openjdk-devel package

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer file andenter the following command

java -jar rhpam-installer-700jar -console

The command-line interactive process will start and display the End-User License Agreement

press 1 to continue 2 to quit 3 to redisplay

2 Read the license agreement enter 1 and press Enter to continue

Specify the home directory of one of the following servers Red Hat JBoss EAP 71 or Red Hat JBoss Web Server 50

3 Enter the parent directory of an existing Red Hat JBoss EAP 71 installationThe installer will verify the location of the installation at the location provided Enter 1 toconfirm and continue

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments

4 Follow the instructions in the installer to complete the installation

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

10

NOTE

When you create the user name and password make sure that the specified username does not conflict with any known title of a role or a group For example ifthere is a role called admin you should not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character (not including the character amp)

Make a note of the user name and password You will need them to accessBusiness Central and Process Server

5 When the installation has completed you will see this message

Would you like to generate an automatic installation script and properties file

6 Enter y to create an XML file that contains the installation data or n to complete theinstallation If you enter y you are prompted to specify a path for the XML file

7 Enter a path or press the Enter key to accept the suggested path

8 If you installed only Business Central repeat these steps to install Process Server on aseparate server

43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITHTHE PROCESS AUTOMATION MANAGER CONTROLLER

Process Server can be managed by the Process Automation Manager controller or it can beunmanaged If Process Server is unmanaged you must manually create and maintain containers IfProcess Server is managed the Process Automation Manager controller manages the Process Serverconfiguration and you interact with the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

You can use the installer in interactive or CLI mode to install Business Central and Process Server andthen configure Process Server with the Process Automation Manager controller

NOTE

If you do not install Business Central see Chapter 7 Installing and running the headlessProcess Automation Manager controller for information about using the headless ProcessAutomation Manager controller

Prerequisites

Two computers with backed-up Red Hat JBoss EAP 71 or higher server installations areavailable

Sufficient user permissions to complete the installation are granted

Procedure

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

11

1 On the first computer run the installer in interactive mode or CLI mode See one of thefollowing sections for more information

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

2 On the Component Selection page clear the Process Server box

3 Complete the Business Central installation

4 On the second computer run the installer in interactive mode or CLI mode

5 On the Component Selection page clear the Business Central box

6 On the Configure Runtime Environment page select Perform Advanced Configuration

7 Select Customize Process Server properties and click Next

8 On the Process Server Properties Configuration page click New Server Configuration to adda Process Server and specify a unique name for that Process Server This name will appear inBusiness Central and enable you to distinguish between different Process Servers

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

12

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATIONMANAGER FROM ZIP FILES

The Red Hat Process Automation Manager ZIP files (one for Business Central and one for ProcessServer) do not require a graphical user interface so you can install Red Hat Process AutomationManager using SSH

NOTE

You should install Business Central and the Process Server on different servers inproduction environments

For information about installing the headless Process Automation Manager controllersee Chapter 7 Installing and running the headless Process Automation Manager controller

51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE

Business Central is a web console that enables you to perform the following tasks over individualcomponents in a unified web-based environment

Create manage and edit your rules processes and related assets

Manage connected Process Server instances and their containers

Execute runtime operations against processes and tasks in Process Server instancesconnected to Business Central

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-business-central-eap7-deployablezip

Procedure

1 Extract the rhpam-700-business-central-eap7-deployablezip file to atemporary directory In the following examples this directory is called TEMP_DIR

2 Copy the contents of the TEMP_DIRrhpam-700-business-central-eap7-deployablejboss-eap-71 directory to EAP_HOME When prompted merge or replacefiles

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

13

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 12: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

Make a note of the user name and password You will need them to access Business Centraland Process Server

6 On the Installation Overview page click Next to start the installation The InstallationOverview page lists the components that you will install

7 When the installation has completed click Next

8 On the Configure Runtime Environment page choose whether to perform the defaultinstallation or perform an advanced configurationIf you choose Perform advanced configuration you can choose to configure databasesettings or customize certain Process Server options

9 If you selected Customize database settings on the JDBC Drive Configuration page specifya data source JDBC driver vendor select one or more Driver JAR files and click NextA data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the datasource on the Java Naming and Directory Interface (JNDI) tree or in the local applicationcontext and request a database connection to retrieve data You must configure data sourcesfor Process Server to ensure proper data exchange between the servers and the designateddatabase

10 If you selected Customize Process Server settings change any of the following if desired

Change the name of the Process Server property

Change the URL of the controller

Deselect any Process Server server options

11 Click Next to configure the runtime environment

12 When Processing finished appears at the top of the screen click Next to complete theinstallation

13 If desired click Generate Installation Script and Properties File to save the installation datain an XML file then click Done You can use this file to automatically install Red Hat ProcessAutomation Manager on the same type of server Note that you must change the installpath parameter in the XML file to specify the path of the new server that you want toinstall Red Hat Process Automation Manager on Enter the following command to perform aninstallation with the XML file

java -jar rhpam-installer-700jar ltpath-to-filegt

You have successfully installed Red Hat Process Automation Manager using the installer If youinstalled only Business Central repeat these steps to install Process Server on a separate server

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

9

42 USING THE INSTALLER IN CLI MODE

You can run the Red Hat Process Automation Manager installer through the command-line interface(CLI)

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in the $PATH environment variable On Red Hat Enterprise Linux itis included in the java-$JAVA_VERSION-openjdk-devel package

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer file andenter the following command

java -jar rhpam-installer-700jar -console

The command-line interactive process will start and display the End-User License Agreement

press 1 to continue 2 to quit 3 to redisplay

2 Read the license agreement enter 1 and press Enter to continue

Specify the home directory of one of the following servers Red Hat JBoss EAP 71 or Red Hat JBoss Web Server 50

3 Enter the parent directory of an existing Red Hat JBoss EAP 71 installationThe installer will verify the location of the installation at the location provided Enter 1 toconfirm and continue

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments

4 Follow the instructions in the installer to complete the installation

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

10

NOTE

When you create the user name and password make sure that the specified username does not conflict with any known title of a role or a group For example ifthere is a role called admin you should not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character (not including the character amp)

Make a note of the user name and password You will need them to accessBusiness Central and Process Server

5 When the installation has completed you will see this message

Would you like to generate an automatic installation script and properties file

6 Enter y to create an XML file that contains the installation data or n to complete theinstallation If you enter y you are prompted to specify a path for the XML file

7 Enter a path or press the Enter key to accept the suggested path

8 If you installed only Business Central repeat these steps to install Process Server on aseparate server

43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITHTHE PROCESS AUTOMATION MANAGER CONTROLLER

Process Server can be managed by the Process Automation Manager controller or it can beunmanaged If Process Server is unmanaged you must manually create and maintain containers IfProcess Server is managed the Process Automation Manager controller manages the Process Serverconfiguration and you interact with the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

You can use the installer in interactive or CLI mode to install Business Central and Process Server andthen configure Process Server with the Process Automation Manager controller

NOTE

If you do not install Business Central see Chapter 7 Installing and running the headlessProcess Automation Manager controller for information about using the headless ProcessAutomation Manager controller

Prerequisites

Two computers with backed-up Red Hat JBoss EAP 71 or higher server installations areavailable

Sufficient user permissions to complete the installation are granted

Procedure

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

11

1 On the first computer run the installer in interactive mode or CLI mode See one of thefollowing sections for more information

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

2 On the Component Selection page clear the Process Server box

3 Complete the Business Central installation

4 On the second computer run the installer in interactive mode or CLI mode

5 On the Component Selection page clear the Business Central box

6 On the Configure Runtime Environment page select Perform Advanced Configuration

7 Select Customize Process Server properties and click Next

8 On the Process Server Properties Configuration page click New Server Configuration to adda Process Server and specify a unique name for that Process Server This name will appear inBusiness Central and enable you to distinguish between different Process Servers

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

12

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATIONMANAGER FROM ZIP FILES

The Red Hat Process Automation Manager ZIP files (one for Business Central and one for ProcessServer) do not require a graphical user interface so you can install Red Hat Process AutomationManager using SSH

NOTE

You should install Business Central and the Process Server on different servers inproduction environments

For information about installing the headless Process Automation Manager controllersee Chapter 7 Installing and running the headless Process Automation Manager controller

51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE

Business Central is a web console that enables you to perform the following tasks over individualcomponents in a unified web-based environment

Create manage and edit your rules processes and related assets

Manage connected Process Server instances and their containers

Execute runtime operations against processes and tasks in Process Server instancesconnected to Business Central

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-business-central-eap7-deployablezip

Procedure

1 Extract the rhpam-700-business-central-eap7-deployablezip file to atemporary directory In the following examples this directory is called TEMP_DIR

2 Copy the contents of the TEMP_DIRrhpam-700-business-central-eap7-deployablejboss-eap-71 directory to EAP_HOME When prompted merge or replacefiles

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

13

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 13: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

42 USING THE INSTALLER IN CLI MODE

You can run the Red Hat Process Automation Manager installer through the command-line interface(CLI)

NOTE

For security reasons you should run the installer as a non-root user

Prerequisites

A backed-up Red Hat JBoss EAP 71 or higher server installation is available

Sufficient user permissions to complete the installation are granted

The JAR binary is included in the $PATH environment variable On Red Hat Enterprise Linux itis included in the java-$JAVA_VERSION-openjdk-devel package

NOTE

Red Hat Process Automation Manager is designed to work with UTF-8 encodingIf a different encoding system is used by the underlying JVM unexpected errorsmight occur To ensure UTF-8 is used by the JVM use the -Dfileencoding=UTF-8 system property

Procedure

1 In a terminal window navigate to the directory where you downloaded the installer file andenter the following command

java -jar rhpam-installer-700jar -console

The command-line interactive process will start and display the End-User License Agreement

press 1 to continue 2 to quit 3 to redisplay

2 Read the license agreement enter 1 and press Enter to continue

Specify the home directory of one of the following servers Red Hat JBoss EAP 71 or Red Hat JBoss Web Server 50

3 Enter the parent directory of an existing Red Hat JBoss EAP 71 installationThe installer will verify the location of the installation at the location provided Enter 1 toconfirm and continue

NOTE

You can install Business Central and Process Server on the same serverHowever you should install Business Central and Process Server on differentservers in production environments

4 Follow the instructions in the installer to complete the installation

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

10

NOTE

When you create the user name and password make sure that the specified username does not conflict with any known title of a role or a group For example ifthere is a role called admin you should not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character (not including the character amp)

Make a note of the user name and password You will need them to accessBusiness Central and Process Server

5 When the installation has completed you will see this message

Would you like to generate an automatic installation script and properties file

6 Enter y to create an XML file that contains the installation data or n to complete theinstallation If you enter y you are prompted to specify a path for the XML file

7 Enter a path or press the Enter key to accept the suggested path

8 If you installed only Business Central repeat these steps to install Process Server on aseparate server

43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITHTHE PROCESS AUTOMATION MANAGER CONTROLLER

Process Server can be managed by the Process Automation Manager controller or it can beunmanaged If Process Server is unmanaged you must manually create and maintain containers IfProcess Server is managed the Process Automation Manager controller manages the Process Serverconfiguration and you interact with the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

You can use the installer in interactive or CLI mode to install Business Central and Process Server andthen configure Process Server with the Process Automation Manager controller

NOTE

If you do not install Business Central see Chapter 7 Installing and running the headlessProcess Automation Manager controller for information about using the headless ProcessAutomation Manager controller

Prerequisites

Two computers with backed-up Red Hat JBoss EAP 71 or higher server installations areavailable

Sufficient user permissions to complete the installation are granted

Procedure

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

11

1 On the first computer run the installer in interactive mode or CLI mode See one of thefollowing sections for more information

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

2 On the Component Selection page clear the Process Server box

3 Complete the Business Central installation

4 On the second computer run the installer in interactive mode or CLI mode

5 On the Component Selection page clear the Business Central box

6 On the Configure Runtime Environment page select Perform Advanced Configuration

7 Select Customize Process Server properties and click Next

8 On the Process Server Properties Configuration page click New Server Configuration to adda Process Server and specify a unique name for that Process Server This name will appear inBusiness Central and enable you to distinguish between different Process Servers

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

12

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATIONMANAGER FROM ZIP FILES

The Red Hat Process Automation Manager ZIP files (one for Business Central and one for ProcessServer) do not require a graphical user interface so you can install Red Hat Process AutomationManager using SSH

NOTE

You should install Business Central and the Process Server on different servers inproduction environments

For information about installing the headless Process Automation Manager controllersee Chapter 7 Installing and running the headless Process Automation Manager controller

51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE

Business Central is a web console that enables you to perform the following tasks over individualcomponents in a unified web-based environment

Create manage and edit your rules processes and related assets

Manage connected Process Server instances and their containers

Execute runtime operations against processes and tasks in Process Server instancesconnected to Business Central

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-business-central-eap7-deployablezip

Procedure

1 Extract the rhpam-700-business-central-eap7-deployablezip file to atemporary directory In the following examples this directory is called TEMP_DIR

2 Copy the contents of the TEMP_DIRrhpam-700-business-central-eap7-deployablejboss-eap-71 directory to EAP_HOME When prompted merge or replacefiles

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

13

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 14: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

NOTE

When you create the user name and password make sure that the specified username does not conflict with any known title of a role or a group For example ifthere is a role called admin you should not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character (not including the character amp)

Make a note of the user name and password You will need them to accessBusiness Central and Process Server

5 When the installation has completed you will see this message

Would you like to generate an automatic installation script and properties file

6 Enter y to create an XML file that contains the installation data or n to complete theinstallation If you enter y you are prompted to specify a path for the XML file

7 Enter a path or press the Enter key to accept the suggested path

8 If you installed only Business Central repeat these steps to install Process Server on aseparate server

43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITHTHE PROCESS AUTOMATION MANAGER CONTROLLER

Process Server can be managed by the Process Automation Manager controller or it can beunmanaged If Process Server is unmanaged you must manually create and maintain containers IfProcess Server is managed the Process Automation Manager controller manages the Process Serverconfiguration and you interact with the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

You can use the installer in interactive or CLI mode to install Business Central and Process Server andthen configure Process Server with the Process Automation Manager controller

NOTE

If you do not install Business Central see Chapter 7 Installing and running the headlessProcess Automation Manager controller for information about using the headless ProcessAutomation Manager controller

Prerequisites

Two computers with backed-up Red Hat JBoss EAP 71 or higher server installations areavailable

Sufficient user permissions to complete the installation are granted

Procedure

CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER

11

1 On the first computer run the installer in interactive mode or CLI mode See one of thefollowing sections for more information

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

2 On the Component Selection page clear the Process Server box

3 Complete the Business Central installation

4 On the second computer run the installer in interactive mode or CLI mode

5 On the Component Selection page clear the Business Central box

6 On the Configure Runtime Environment page select Perform Advanced Configuration

7 Select Customize Process Server properties and click Next

8 On the Process Server Properties Configuration page click New Server Configuration to adda Process Server and specify a unique name for that Process Server This name will appear inBusiness Central and enable you to distinguish between different Process Servers

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

12

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATIONMANAGER FROM ZIP FILES

The Red Hat Process Automation Manager ZIP files (one for Business Central and one for ProcessServer) do not require a graphical user interface so you can install Red Hat Process AutomationManager using SSH

NOTE

You should install Business Central and the Process Server on different servers inproduction environments

For information about installing the headless Process Automation Manager controllersee Chapter 7 Installing and running the headless Process Automation Manager controller

51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE

Business Central is a web console that enables you to perform the following tasks over individualcomponents in a unified web-based environment

Create manage and edit your rules processes and related assets

Manage connected Process Server instances and their containers

Execute runtime operations against processes and tasks in Process Server instancesconnected to Business Central

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-business-central-eap7-deployablezip

Procedure

1 Extract the rhpam-700-business-central-eap7-deployablezip file to atemporary directory In the following examples this directory is called TEMP_DIR

2 Copy the contents of the TEMP_DIRrhpam-700-business-central-eap7-deployablejboss-eap-71 directory to EAP_HOME When prompted merge or replacefiles

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

13

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 15: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

1 On the first computer run the installer in interactive mode or CLI mode See one of thefollowing sections for more information

Section 41 ldquoUsing the installer in interactive moderdquo

Section 42 ldquoUsing the installer in CLI moderdquo

2 On the Component Selection page clear the Process Server box

3 Complete the Business Central installation

4 On the second computer run the installer in interactive mode or CLI mode

5 On the Component Selection page clear the Business Central box

6 On the Configure Runtime Environment page select Perform Advanced Configuration

7 Select Customize Process Server properties and click Next

8 On the Process Server Properties Configuration page click New Server Configuration to adda Process Server and specify a unique name for that Process Server This name will appear inBusiness Central and enable you to distinguish between different Process Servers

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

12

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATIONMANAGER FROM ZIP FILES

The Red Hat Process Automation Manager ZIP files (one for Business Central and one for ProcessServer) do not require a graphical user interface so you can install Red Hat Process AutomationManager using SSH

NOTE

You should install Business Central and the Process Server on different servers inproduction environments

For information about installing the headless Process Automation Manager controllersee Chapter 7 Installing and running the headless Process Automation Manager controller

51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE

Business Central is a web console that enables you to perform the following tasks over individualcomponents in a unified web-based environment

Create manage and edit your rules processes and related assets

Manage connected Process Server instances and their containers

Execute runtime operations against processes and tasks in Process Server instancesconnected to Business Central

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-business-central-eap7-deployablezip

Procedure

1 Extract the rhpam-700-business-central-eap7-deployablezip file to atemporary directory In the following examples this directory is called TEMP_DIR

2 Copy the contents of the TEMP_DIRrhpam-700-business-central-eap7-deployablejboss-eap-71 directory to EAP_HOME When prompted merge or replacefiles

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

13

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 16: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATIONMANAGER FROM ZIP FILES

The Red Hat Process Automation Manager ZIP files (one for Business Central and one for ProcessServer) do not require a graphical user interface so you can install Red Hat Process AutomationManager using SSH

NOTE

You should install Business Central and the Process Server on different servers inproduction environments

For information about installing the headless Process Automation Manager controllersee Chapter 7 Installing and running the headless Process Automation Manager controller

51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE

Business Central is a web console that enables you to perform the following tasks over individualcomponents in a unified web-based environment

Create manage and edit your rules processes and related assets

Manage connected Process Server instances and their containers

Execute runtime operations against processes and tasks in Process Server instancesconnected to Business Central

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-business-central-eap7-deployablezip

Procedure

1 Extract the rhpam-700-business-central-eap7-deployablezip file to atemporary directory In the following examples this directory is called TEMP_DIR

2 Copy the contents of the TEMP_DIRrhpam-700-business-central-eap7-deployablejboss-eap-71 directory to EAP_HOME When prompted merge or replacefiles

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

13

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 17: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

52 INSTALLING PROCESS SERVER FROM THE ZIP FILE

Process Server provides the runtime environment for business assets and accesses the data stored inthe assets repository (knowledge store)

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

The following file is downloaded from the Red Hat Customer Portal rhpam-700-kie-server-ee7zip

Procedure

1 Extract the rhpam-700-kie-server-ee7zip archive to a temporary directory In thefollowing examples this directory is called TEMP_DIR

2 Copy the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7kie-serverwar directory to EAP_HOMEstandalonedeployments

WARNING

Ensure the names of the Red Hat Process Automation Managerdeployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

3 Copy the contents of the TEMP_DIRrhpam-700-kie-server-ee7rhpam-700-kie-server-ee7SecurityPolicy to EAP_HOMEbin When asked to overwrite files clickReplace

4 In the EAP_HOMEstandalonedeployments directory create an empty file named kie-serverwardodeploy This file ensures that Process Server is automatically deployed whenthe server starts

53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

14

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 18: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

A data source is an object that enables a Java Database Connectivity (JDBC) client such as anapplication server to establish a connection with a database Applications look up the data source onthe Java Naming and Directory Interface (JNDI) tree or in the local application context and request adatabase connection to retrieve data You must configure data sources for Process Server to ensureproper data exchange between the servers and the designated database

Prerequisite

The JDBC providers that you want to use to create database connections are configured on all serverson which you want to deploy Process Server

Procedure

1 Open EAP_HOMEstandaloneconfigurationstandalone-fullxml in a text editorand locate the ltsystem-propertiesgt tag

2 Add the following properties to the ltsystem-propertiesgt tag where ltDATASOURCEgt is thename of your data source and ltHIBERNATE_DIALECTgt is the hibernate dialect for yourdatabase

NOTE

The default value of the orgkieserverpersistenceds property is javajbossdatasourcesExampleDS The default value of the orgkieserverpersistencedialect property is orghibernatedialectH2Dialect

For example

ltproperty name=orgkieserverpersistenceds value=ltDATASOURCEgtgtltproperty name=orgkieserverpersistencedialect value=ltHIBERNATE_DIALECTgtgt

ltsystem-propertiesgt ltproperty name=orgkieserverrepo value=$jbossserverdatadirgt ltproperty name=orgkieexample value=truegt ltproperty name=orgjbpmdesignerperspective value=fullgt ltproperty name=designerdataobjects value=falsegt ltproperty name=orgkieserveruser value=rhpamUsergt ltproperty name=orgkieserverpwd value=rhpam123gt ltproperty name=orgkieserverlocation value=httplocalhost8080kie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=httplocalhost8080business-centralrestcontrollergt ltproperty name=orgkieservercontrolleruser value=kieservergt ltproperty name=orgkieservercontrollerpwd value=kieserver1gt ltproperty name=orgkieserverid value=local-server-123gt

lt-- Data source properties --gt ltproperty name=orgkieserverpersistenceds

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

15

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 19: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

The following dialects are supported

DB2 orghibernatedialectDB2Dialect

MSSQL orghibernatedialectSQLServer2012Dialect

MySQL orghibernatedialectMySQL5InnoDBDialect

MariaDB orghibernatedialectMySQL5InnoDBDialect

Oracle orghibernatedialectOracle10gDialect

PostgreSQL orghibernatedialectPostgreSQL82Dialect

PostgreSQL plus orghibernatedialectPostgresPlusDialect

Sybase orghibernatedialectSybaseASE157Dialect

54 CREATING USERS

Before you can log in to Business Central or Process Server you must create users This section showsyou how to create a Business Central user with the admin rest-all and kie-server roles and aProcess Server user that has the kie-server role For information about roles see Chapter 2 Rolesand users

Prerequisites

Red Hat Process Automation Manager is installed in the base directory of the Red Hat JBoss EAPinstallation (EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager fromZIP files

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Create a user with the admin role that you will use to log in to Business Central In thefollowing command replace ltusernamegt and ltpasswordgt with the user name and passwordof your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

value=javajbossdatasourcesKieServerDSgt ltproperty name=orgkieserverpersistencedialect value=orghibernatedialectPostgreSQLDialectgtltsystem-propertiesgt

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-all

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

16

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 20: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

3 Create a user with the kie-server role that you will use to log in to Process Server

4 Make a note of your user names and passwords

NOTE

If you installed Business Central and Process Server in the same serverinstance you can create a single user that has both of these roles

You should install Business Central and Process Server on different servers inproduction environments

55 CONFIGURING PROCESS SERVER WITH THE INTEGRATEDPROCESS AUTOMATION MANAGER CONTROLLER

NOTE

Only make the changes described in this section if Process Server will be managed byBusiness Central and you installed Red Hat Process Automation Manager from the ZIPfiles If you did not install Business Central you can use the headless ProcessAutomation Manager controller to manage Process Server as described in Chapter 7Installing and running the headless Process Automation Manager controller

Process Server can be managed or it can be unmanaged If Process Server is unmanaged you mustmanually create and maintain containers If Process Server is managed the Process AutomationManager controller manages the Process Server configuration and you interact with the controller tocreate and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral you can use the Execution Server page in Business Central to interact with the controller

If you installed Red Hat Process Automation Manager from the ZIP files you must edit the standalone-fullxml file in both the Process Server and Business Central installations toconfigure Process Server with the integrated Process Automation Manager controller

Prerequisites

Business Central and Process Server are installed in the base directory of the Red Hat JBossEAP installation (EAP_HOME)

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role kie-server

$ add-usersh -a --user ltUSERNAMEgt --password ltPASSWORDgt --role adminrest-allkie-server

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

17

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 21: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

NOTE

You should install Business Central and Process Server on different servers inproduction environments However if you install Process Server and BusinessCentral on the same server for example in a development environment makethe changes described in this section in the shared standalone-fullxmlfile

On Business Central server nodes a user with the rest-all role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the Business Central EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section and replace ltUSERNAMEgt and ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile uncomment the following properties in the ltsystem-propertiesgt section

3 Replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the rest-all role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam700-process-server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of Business Central Process Server connectsto this URL during startup

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

18

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 22: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

If you installed Business Central using the installer or Red Hat JBoss EAP zipinstallations ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtbusiness-centralrestcontroller

If you are running Business Central using the standalonejar file ltCONTROLLER_URLgt has this formathttpltHOSTgtltPORTgtrestcontroller

CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES

19

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 23: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATIONMANAGER

Use this procedure to run the Red Hat Process Automation Manager on Red Hat JBoss EAP instandalone mode

Prerequisite

Red Hat Process Automation Manager is installed and configured

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Run the standalone configuration

On Linux or UNIX-based systems

On Windows

NOTE

If you deployed Business Central without Process Server you can startBusiness Central with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make anyconfiguration changes to the standalonexml file before startingBusiness Central

On Linux or UNIX-based systems

$ standalonesh

On Windows

3 In a web browser open the URL localhost8080business-central

4 Log in using the credentials of the user that you created for Business Central in Section 54ldquoCreating usersrdquo

$ standalonesh -c standalone-fullxml

standalonebat -c standalone-fullxml

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

20

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 24: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESSPROCESS AUTOMATION MANAGER CONTROLLER

You can configure Process Server to run in managed or unmanaged mode If Process Server isunmanaged you must manually create and maintain containers If Process Server is managed theProcess Automation Manager controller manages the Process Server configuration and you interactwith the controller to create and maintain containers

The Process Automation Manager controller is integrated with Business Central If you install BusinessCentral use the Execution Server page to create and maintain containers However if you do notinstall Business Central you can install the headless Process Automation Manager controller and usethe REST API or the Process Server Java Client API to interact with it

71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

You can install the headless Process Automation Manager controller and use the REST API or theProcess Server Java Client API to interact with it

Prerequisites

A backed-up Red Hat JBoss EAP installation version 71 or higher is available The basedirectory of the Red Hat JBoss EAP installation is referred to as EAP_HOME

Sufficient user permissions to complete the installation are granted

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 700 Add Ons (the rhpam-700-add-onszip file)

3 Unzip the rhpam-700-add-onszip file The rhpam-70-controller-ee7zip file isin the unzipped directory

4 Extract the rhpam-70-controller-ee7 archive to a temporary directory In the followingexamples this directory is called TEMP_DIR

5 Copy the TEMP_DIRrhpam-70-controller-ee7controllerwar directory to EAP_HOMEstandalonedeployments

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

21

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 25: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

WARNING

Ensure that the names of the headless Process Automation Managercontroller deployments you are copying do not conflict with your existingdeployments in the Red Hat JBoss EAP instance

6 Copy the contents of the TEMP_DIRrhpam-70-controller-ee7SecurityPolicydirectory to EAP_HOMEbin When asked to overwrite files select Yes

7 In the EAP_HOMEstandalonedeployments directory create an empty file named controllerwardodeploy This file ensures that the headless Process AutomationManager controller is automatically deployed when the server starts

711 Creating a controller user

Before you can use the headless Process Automation Manager controller you must create a user thathas the kie-server role

Prerequisite

The controller is installed in the base directory of the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to the EAP_HOMEbin directory

2 Enter the following command and replace ltUSER_NAMEgt and ltPASSWORDgt with the user nameand password of your choice

NOTE

Make sure that the specified user name is not the same as an existing user roleor group For example do not create a user with the user name admin

The password must have at least eight characters and must contain at least onenumber and one non-alphanumeric character but not amp (ampersand)

3 Make a note of your user name and password

712 Configuring Process Server and the headless Process Automation Managercontroller

If Process Server will be managed by the headless Process Automation Manager controller you mustedit the standalone-fullxml file in both the Process Server and headless Process AutomationManager controller installations as described in this section

$ add-usersh -a --user ltUSER_NAMEgt --password ltPASSWORDgt --role kie-server

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

22

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 26: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

Prerequisites

Process Server is installed in the base directory of the Red Hat JBoss EAP installation(EAP_HOME) as described in Chapter 5 Installing Red Hat Process Automation Manager from ZIPfiles section

The controller is installed in an EAP_HOME

NOTE

You should install Process Server and the headless Process AutomationManager controller on different servers in production environments However ifyou install Process Server and the headless Process Automation Managercontroller on the same server for example in a development environment makethese changes in the shared standalone-fullxml file

On Process Server nodes a user with the kie-server role exists

On the controller server nodes a user with the kie-server role existsFor more information see Section 54 ldquoCreating usersrdquo

Procedure

1 In the controller EAP_HOMEstandaloneconfigurationstandalone-fullxml fileadd the following properties to the ltsystem-propertiesgt section and replace ltUSERNAMEgtand ltUSER_PWDgt with the credentials of a user with the kie-server role

2 In the Process Server EAP_HOMEstandaloneconfigurationstandalone-fullxmlfile add the following properties to the ltsystem-propertiesgt section

3 In this file replace the following values

Replace ltCONTROLLER_USERgt and ltCONTROLLER_PWDgt with the credentials of a userwith the kie-server role

Replace ltKIE_SERVER_IDgt with the ID or name of the Process Server installation forexample rhpam-700-process_server-1

Replace ltHOSTgt with the ID or name of the Process Server host for example localhostor 192789

ltproperty name=orgkieserveruser value=ltUSERNAMEgtgt ltproperty name=orgkieserverpwd value=ltUSER_PWDgtgt

ltproperty name=orgkieservercontrolleruser value=ltCONTROLLER_USERgtgt ltproperty name=orgkieservercontrollerpwd value=ltCONTROLLER_PWDgtgt ltproperty name=orgkieserverid value=ltKIE_SERVER_IDgtgt ltproperty name=orgkieserverlocation value=httpltHOSTgtltPORTgtkie-serverservicesrestservergt ltproperty name=orgkieservercontroller value=ltCONTROLLER_URLgtgt

CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER

23

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 27: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

Replace ltPORTgt with the port of the Process Server host for example 8080

NOTE

The orgkieserverlocation property specifies the location ofProcess Server

Replace ltCONTROLLER_URLgt with the URL of the headless Process Automation Managercontroller

4 Process Server connects to this URL during startup

72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGERCONTROLLER

After you have installed the headless Process Automation Manager controller on Red Hat JBoss EAPuse this procedure to run the headless Process Automation Manager controller

Prerequisite

The headless Process Automation Manager controller is installed and configured in the base directoryof the Red Hat JBoss EAP installation (EAP_HOME)

Procedure

1 In a terminal application navigate to EAP_HOMEbin

2 Enter the following command

On Linux or UNIX-based systems

On Windows

3 To verify that the controller is working on Red Hat JBoss EAP enter the following commandwhere ltCONTROLLERgt and ltCONTROLLER_PWDgt is the user name and password combinationthat you created in Section 711 ldquoCreating a controller userrdquo The output of this commandprovides information about the Process Server instance

curl -X GET httpltHOSTgtltPORTgtcontrollerrestcontrollermanagementservers -H accept applicationxml -u ltCONTROLLERgtltCONTROLLER_PWDgt

NOTE

Alternatively you can use the Process Server Java API Client to access the headlessProcess Automation Manager controller

$ standalonesh

standalonebat

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

24

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 28: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRALYou can use the Business Central standalone JAR file to run Business Central without needing todeploy it to an application server such as Red Hat JBoss EAP

NOTE

Red Hat supports this installation type only when it is installed on Red Hat EnterpriseLinux

Procedure

1 Navigate to the Software Downloads page in the Red Hat Customer Portal (login required) andselect the product and version from the drop-down options

Product Red Hat Process Automation Manager

Version 70

2 Download Red Hat Process Automation Manager 70 Business Central Standalone (rhpam-700-business-central-standalonejar)

3 Create a directory and move the rhpam-700-business-central-standalonejar fileto this directory

4 In a terminal window navigate to the directory that contains the standalone JAR file

5 Create the application-usersproperties file Include an administrative user and if thisBusiness Central instance will be a controller for Process Server include a controller user forexample

rhpamAdmin=password1controllerUser=controllerUser1234

6 Create the application-rolesproperties file to assign roles to the users that youincluded in the application-usersproperties file for example

rhpamAdmin=admincontrollerUser=kie-server

7 Create the application-configyaml configuration file with the following contents whereltAPPLICATION_USERSgt is the path to the application-usersproperties file and ltAPPLICATION_ROLESgt is the path to the application-rolesproperties file

swarm security security-domains other classic-authentication login-modules myloginmodule code orgkiesecurityjaasKieLoginModule flag optional module deploymentkie-wb-webappwar

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

25

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 29: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

management security-realms ApplicationRealm local-authentication default-user local allowed-users local skip-group-loading true properties-authentication path ltAPPLICATION_USERSgt plain-text true properties-authorization path ltAPPLICATION_ROLESgtdatasource management wildfly admin admin

8 Enter the following command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml

In addition you can set any properties supported by Business Central by including the -Dltpropertygt=ltvaluegt parameter in this command for example

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

See Section 81 ldquoSupported propertiesrdquo for more information

81 SUPPORTED PROPERTIES

When you install standalone Business Central you can use the properties listed in this section in thefollowing command

java -jar rhpam-700-business-central-standalonejar -s application-configyaml -Dltpropertygt=ltvaluegt -Dltpropertygt=ltvaluegt

In this command ltpropertygt is a property from the following list and ltvaluegt is a value that youassign to that property

orguberfireniogitdir Location of the Process Server Git directory

orguberfireniogitdirname Name of the Process Server Git directory Default valueniogit

orguberfireniogitdaemonenabled Enables or disables the Git daemon Defaultvalue true

orguberfireniogitdaemonhost If the Git daemon is enabled it uses this propertyas the local host identifier Default value localhost

orguberfireniogitdaemonport If the Git daemon is enabled it uses this propertyas the port number Default value 9418

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

26

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 30: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

orguberfireniogitsshenabled Enables or disables the SSH daemon Default valuetrue

orguberfireniogitsshhost If the SSH daemon enabled it uses this property as thelocal host identifier Default value localhost

orguberfireniogitSSHport If the SSH daemon is enabled it uses this property asthe port number Default value 8001

orguberfireniogitsshcertdir Location of the security directory where localcertificates are stored Default the working directory

orguberfireniogitsshpassphrase Pass phrase used to access the public keystore of your operating system when cloning git repositories with SCP style URLs Example gitgithubcomuserrepositorygit

orguberfireniogitsshalgorithm Algorithm used by SSH Default value DSA

NOTE

If you plan to use RSA or any algorithm other than DSA make sure you set upyour application server to use the Bouncy Castle JCE library

orguberfiremetadataindexdir Place where the Lucene index directory is storedDefault the working directory

orguberfireldapregexrole_mapper Regex pattern used to map LDAP principalnames to the application role name Note that the variable role must be part of the patternbecause it is substituted by the application role name when matching a principal value to a rolename Default Not used

orguberfiresysrepomonitordisabled Disables the configuration monitor Do notdisable unless you are sure Default value false

orguberfiresecurekey Password used by password encryption Default value orguberfireadmin

orguberfiresecurealg Crypto algorithm used by password encryption Default value PBEWithMD5AndDES

orguberfiredomain Security-domain name used by uberfire Default value ApplicationRealm

orgguvnorm2repodir Place where the Maven repository folder is stored Default value ltworking-directorygtrepositorieskie

orgguvnorprojectgavcheckdisabled Disables group ID artifact ID and version(GAV) checks Default value false

orgkieexample Enables external cloning of a demo application from GitHub

orgkiebuilddisable-project-explorer Disables automatic build of a selectedproject in Project Explorer Default value false

orgkieverificationdisable-dtable-realtime-verification Disables the real-

CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL

27

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 31: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

time validation and verification of decision tables Default value false

orgkieservercontroller URL for connecting with a Kie Server controller forexample wslocalhost8080business-centralwebsocketcontroller

orgkieserveruser User name used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

orgkieserverpwd Password used to connect with the Process Server nodes from thecontroller This property is only required when using this Business Central installation as acontroller

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

28

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 32: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOURPROJECT

You can use an external Maven repository to deploy a project When you create a project BusinessCentral uses the Maven repositories that are configured for Business Central You can use the Mavenglobal or user settings to direct all Red Hat Process Automation Manager projects to retrievedependencies from the public Red Hat Process Automation Manager repository by modifying thefollowing files

The Maven settingsxml file

The Maven project object model (POM) file (pomxml)

For more information see Packaging and deploying a project

91 MODIFY THE MAVEN SETTINGS FILE

You can configure Business Central and Process Server to use an external Maven repository such asNexus instead of the built-in repository In this case when you build projects in Business Central allbuilt project KJAR files are pushed into this external repository You can progress these files throughthe repository as necessary to implement your integration process and deploy the KJAR files usingBusiness Central or the Process Server REST API

Prerequisite

Business Central and Process Server are installed For installation options see Planning a Red HatProcess Automation Manager installation

Procedure

1 Create a Maven settingsxml file with connection and access details for your externalrepository For details about the settingsxml file see the Maven Settings Reference

2 Save the file in a known location for example optcustom-configsettingsxml

3 In your Red Hat Process Automation Manager installation directory navigate to the standalone-fullxml file For example if you use a Red Hat JBoss EAP installation for RedHat Process Automation Manager go to $EAP_HOMEstandaloneconfigurationstandalone-fullxml

4 Open standalone-fullxml and under the ltsystem-propertiesgt tag set the kiemavensettingscustom property to the full path name of the settingsxml fileFor example

5 Start or restart Business Central and Process Server

92 MODIFY THE MAVEN POM FILE

To use the correct Maven dependencies in your Red Hat Process Automation Manager project youmust add relevant bill of materials (BOM) files to the projectrsquos pomxml file When you add the BOM

ltproperty name=kiemavensettingscustom value=optcustom-configsettingsxmlgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

29

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 33: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

files the correct versions of transitive dependencies from the provided Maven repositories areincluded in the project

For more information see What is the mapping between RHPAM product and maven library version

Procedure

1 Declare the BOM in the pomxml file For example

2 Declare dependencies required for your project in the ltdependenciesgt tag After you importthe product BOM into your project the versions of the user-facing product dependencies aredefined so you do not need to specify the ltversiongt sub-element of these ltdependencygtelements However you must use the ltdependencygt element to declare dependencies whichyou want to use in your project

3 For standalone projects that are not authored in Business Central specify all dependenciesrequired for your projects In projects that you author in Business Central the basic Drools andjBPM engine dependencies are provided automatically by Business Central

For a basic Red Hat Process Automation Manager project declare the followingdependencies depending on the features that you want to use

Embedded jBPM engine dependencies

ltdependencyManagementgt ltdependenciesgt ltdependencygt ltgroupIdgtorgjbossbomltgroupIdgt ltartifactIdgtrhpam-platform-bomltartifactIdgt ltversiongt700-redhat-3ltversiongt lttypegtpomlttypegt ltscopegtimportltscopegt ltdependencygt ltdependenciesgtltdependencyManagementgtltdependenciesgtlt-- Your dependencies --gtltdependenciesgt

lt-- Public KIE API --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

lt-- jBPM engine core dependencies --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-flowltartifactIdgtltdependencygt

ltdependencygt ltartifactIdgtjbpm-flow-builderltartifactIdgtltdependencygt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

30

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 34: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

For a Red Hat Process Automation Manager project that uses CDI you typically declarethe following dependencies

CDI-enabled jBPM engine dependencies

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-bpmn2ltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-runtime-managerltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-persistence-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-query-jpaltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-auditltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

lt-- Dependency needed for default WorkItemHandler implementations --gtltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-workitems-coreltartifactIdgtltdependencygt

lt-- Logging dependency You can use any logging framework compatible with slf4j --gtltdependencygt ltgroupIdgtchqoslogbackltgroupIdgt ltartifactIdgtlogback-classicltartifactIdgt ltversiongt$logbackversionltversiongtltdependencygt

ltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-apiltartifactIdgtltdependencygt

ltdependencygt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

31

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 35: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

For a basic Red Hat Process Automation Manager project declare the followingdependencies

Embedded Drools engine dependencies

To use the Process Server declare the following dependencies

Client application Process Server dependencies

ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-kie-servicesltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgjbpmltgroupIdgt ltartifactIdgtjbpm-services-cdiltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-compilerltartifactIdgtltdependencygt

lt-- Dependency for persistence support --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-persistence-jpaltartifactIdgtltdependencygt

lt-- Dependencies for decision tables templates and scorecardsFor other assets declare orgdroolsdrools-workbench-models- dependencies --gtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-decisiontablesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-templatesltartifactIdgtltdependencygtltdependencygt ltgroupIdgtorgdroolsltgroupIdgt ltartifactIdgtdrools-scorecardsltartifactIdgtltdependencygt

lt-- Dependency for loading KJARs from a Maven repository using KieScanner --gtltdependencygt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-ciltartifactIdgtltdependencygt

ltdependencygt ltgroupIdgtorgkieserverltgroupIdgt ltartifactIdgtkie-server-clientltartifactIdgt

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

32

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 36: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

To create a remote client for Red Hat Process Automation Manager declare the followingdependency

Client dependency

When creating a JAR file that includes assets such as rules and process definitionsspecify the packaging type for your Maven project as kjar and use orgkiekie-maven-plugin to process the kjar packaging type located under the ltprojectgtelement In the following example $kieversion is the Maven library version listed inWhat is the mapping between RHPAM product and maven library version

ltdependencygt

ltdependencygt ltgroupIdgtorguberfireltgroupIdgt ltartifactIdgtuberfire-rest-clientltartifactIdgtltdependencygt

ltpackaginggtkjarltpackaginggtltbuildgt ltpluginsgt ltplugingt ltgroupIdgtorgkieltgroupIdgt ltartifactIdgtkie-maven-pluginltartifactIdgt ltversiongt$kieversionltversiongt ltextensionsgttrueltextensionsgt ltplugingt ltpluginsgtltbuildgt

CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT

33

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 37: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

CHAPTER 10 IMPORTING PROJECTS FROM GITREPOSITORIES

Git is a distributed version control system It implements revisions as commit objects When you saveyour changes to a repository a new commit object in the Git repository is created

Business Central uses Git to store project data including assets such as rules and processes When youcreate a project in Business Central it is added to a Git repository that is connected to BusinessCentral If you have projects in Git repositories you can import those projects into the Business CentralGit repository through Business Central spaces

Prerequisites

Red Hat Process Automation Manager projects exist in an external Git repository

Credentials required for read access to that external Git repository are available

Procedure

1 In Business Central click Menu rarr Design rarr Projects

2 Select or create the space into which you want to import the projects The default space ismySpace

3 Click the three vertical dots on the right side of the screen and select Import Project

4 In the Import Project window enter the URL and credentials for the Git repository thatcontains the projects that you want to import and click Import The projects are added to theBusiness Central Git repository and are available from the current space

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

34

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 38: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

CHAPTER 11 VERIFYING THE RED HAT PROCESSAUTOMATION MANAGER INSTALLATION

After you have installed Red Hat Process Automation Manager create an asset to verify that theinstallation is working

Procedure

1 In a terminal window navigate to the EAP_HOMEbin directory and enter the followingcommand to start Red Hat Process Automation Manager

standalonesh -c standalone-fullxml

NOTE

If you deployed Business Central without Process Server you can start BusinessCentral with the standalonesh script without specifying the standalone-fullxml file In this case ensure that you make any configuration changes tothe standalonexml file before starting Business Central

2 In a web browser enter localhost8080business-central

If Red Hat Process Automation Manager has been configured to run from a domain namereplace localhost with the domain name for examplehttpwwwexamplecom8080business-central

If Red Hat Process Automation Manager has been configured to run in a cluster replace localhost with the IP address of a particular node for examplehttpltnode_IP_addressgt8080business-central

3 Enter the admin user credentials that you created during installation The Business Centralhome page appears

4 Select Menu rarr Design rarr Projects

5 Click Try Samples rarr Mortgages rarr OK The Assets window appears

6 Click Create New Asset rarr Data Object

7 Enter MyDataObject in the Data Object field and click OK

8 Click Spaces rarr myteam rarr Mortgages and confirm that MyDataObject is in the list of assets

9 Delete MyDataObject

CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION

35

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 39: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

CHAPTER 12 CUSTOMIZING BUSINESS CENTRALYou can customize the Business Central login page and application header

121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE

You can customize the company logo and the project logo on the Business Central login page

Procedure

1 Start Red Hat JBoss EAP and open Business Central in a web browser

2 Copy a PNG format image to the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directory in your Red Hat Process Automation Manager installation

3 In the EAP_HOMEstandalonedeploymentsbusiness-centralwarimg directoryeither move or rename the existing login-screen-logopng file

4 Rename your PNG file login-screen-logopng

5 To change the project logo that appears above the User name and Password fields replacethe default image RHPAM_Logosvg with a new SVG file

6 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER

You can customize the Business Central application header

Procedure

1 Start Red Hat JBoss EAP open Business Central in a web browser and log in with your usercredentials

2 Copy your new application header image in the SVG format to the EAP_HOMEstandalonedeploymentsbusiness-centralwarbanner directory inyour Red Hat Process Automation Manager installation

3 Open the EAP_HOMEstandalonedeploymentsbusiness-centralwarbannerbannerhtml file in a text editor

4 Replace logosvg in the ltimggt tag with the file name of your new image

ltimg src=bannerlogosvggt

5 Force a full reload of the login page bypassing the cache to view the changes For example inmost Linux and Windows web browsers press Ctrl+F5

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

36

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 40: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

CHAPTER 13 INTEGRATING LDAP AND SSLWith Red Hat Process Automation Manager you can integrate LDAP and SSL through RH-SSO Formore information see the Red Hat Single Sign-On Server Administration Guide

CHAPTER 13 INTEGRATING LDAP AND SSL

37

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 41: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

CHAPTER 14 RELATED INFORMATIONIntegrating Red Hat JBoss Developer Studio with Red Hat Process Automation Manager

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

38

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 42: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

CHAPTER 15 NEXT STEPSGetting started with business processes

CHAPTER 15 NEXT STEPS

39

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION
Page 43: Red Hat Process Automation Manager 7.0 Installing …...Installing and configuring Process Server on IBM WebSphere Application Server Installing and configuring Process Server on Oracle

APPENDIX A VERSIONING INFORMATIONDocumentation last updated on Thursday August 23 2018

Red Hat Process Automation Manager 70 Installing and configuring Red Hat Process Automation Manager on Red Hat JBoss EAP 71

40

  • Table of Contents
  • PREFACE
  • CHAPTER 1 ABOUT RED HAT PROCESS AUTOMATION MANAGER
  • CHAPTER 2 ROLES AND USERS
  • CHAPTER 3 DOWNLOADING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION FILES
  • CHAPTER 4 USING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLER
    • 41 USING THE INSTALLER IN INTERACTIVE MODE
    • 42 USING THE INSTALLER IN CLI MODE
    • 43 USING THE INSTALLER TO CONFIGURE PROCESS SERVER WITH THE PROCESS AUTOMATION MANAGER CONTROLLER
      • CHAPTER 5 INSTALLING RED HAT PROCESS AUTOMATION MANAGER FROM ZIP FILES
        • 51 INSTALLING BUSINESS CENTRAL FROM THE ZIP FILE
        • 52 INSTALLING PROCESS SERVER FROM THE ZIP FILE
        • 53 CONFIGURING JDBC DATA SOURCES FOR PROCESS SERVER
        • 54 CREATING USERS
        • 55 CONFIGURING PROCESS SERVER WITH THE INTEGRATED PROCESS AUTOMATION MANAGER CONTROLLER
          • CHAPTER 6 RUNNING RED HAT PROCESS AUTOMATION MANAGER
          • CHAPTER 7 INSTALLING AND RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
            • 71 INSTALLING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
              • 711 Creating a controller user
              • 712 Configuring Process Server and the headless Process Automation Manager controller
                • 72 RUNNING THE HEADLESS PROCESS AUTOMATION MANAGER CONTROLLER
                  • CHAPTER 8 RUNNING STANDALONE BUSINESS CENTRAL
                    • 81 SUPPORTED PROPERTIES
                      • CHAPTER 9 SETTING MAVEN DEPENDENCIES IN YOUR PROJECT
                        • 91 MODIFY THE MAVEN SETTINGS FILE
                        • 92 MODIFY THE MAVEN POM FILE
                          • CHAPTER 10 IMPORTING PROJECTS FROM GIT REPOSITORIES
                          • CHAPTER 11 VERIFYING THE RED HAT PROCESS AUTOMATION MANAGER INSTALLATION
                          • CHAPTER 12 CUSTOMIZING BUSINESS CENTRAL
                            • 121 CUSTOMIZING THE BUSINESS CENTRAL LOGIN PAGE
                            • 122 CUSTOMIZING BUSINESS CENTRAL APPLICATION HEADER
                              • CHAPTER 13 INTEGRATING LDAP AND SSL
                              • CHAPTER 14 RELATED INFORMATION
                              • CHAPTER 15 NEXT STEPS
                              • APPENDIX A VERSIONING INFORMATION