Chapter 6. Installing and running the headless Process Automation Manager controller with Oracle WebLogic Server
To use the KIE Server REST API or Java Client API to interact with KIE Server, install the headless Process Automation Manager controller with Oracle WebLogic Server. The headless Process Automation Manager controller manages KIE Server configuration in a centralized way so that you can use the headless Process Automation Manager controller to create and maintain containers and perform other server-level tasks.
Prerequisites
- The Oracle WebLogic Server instance is configured as described in Chapter 4, Configuring Oracle WebLogic Server for KIE Server.
- KIE Server is installed on the Oracle WebLogic Server instance.
- You have sufficient user permissions to complete the installation.
Procedure
Navigate to the Software Downloads page in the Red Hat Customer Portal (login required), and select the product and version from the drop-down options:
- Product: Process Automation Manager
- Version: 7.8
- Download Red Hat Process Automation Manager 7.8.0 Add-Ons.
-
Extract the downloaded
rhpam-7.8.0-add-ons.zip
file to a temporary directory. -
In the WebLogic Administration Console, navigate to Security Realms
Users and Groups. -
In the kie-server group that you created previously, create a user for the headless Process Automation Manager controller, such as
controller
, and a password for this new user and click OK. For more information about creating groups and users, see Section 4.1, “Configuring the KIE Server group and users”. - Navigate to Deployments to view all existing applications.
- Click Install.
-
Navigate to the temporary directory where you downloaded and extracted the
rhpam-7.8.0-add-ons.zip
file, and go torhpam-7.8.0-add-ons/rhpam-7.8.0-controller-ee7.zip/controller.war
. -
Select the
controller.war
file and click Next to continue. - Select Install this deployment as an application as the targeting style and click Next.
-
Keep the application name as
controller
and set the security model toDD Only
. Leave the remaining options as default and click Next to continue. - In the Additional Configuration section, choose No, I will review the configuration later and click Finish.
6.1. Setting system properties for the headless Process Automation Manager controller
After you install the headless Process Automation Manager controller, set the system properties listed in this section on your application server or servers to enable proper interaction with the headless Process Automation Manager controller.
For optimal results, install KIE Server and the headless Process Automation Manager controller on different servers in production environments. In development environments, you can install KIE Server and the headless Process Automation Manager controller on the same server. In either case, be sure to make these property changes on all application servers where the headless Process Automation Manager controller is installed.
Prerequisites
- KIE Server and the headless Process Automation Manager controller are installed on the application server instance.
Procedure
Specify the following JVM property values on the application server instance where the headless Process Automation Manager controller is installed:
Table 6.1. Required properties for the headless Process Automation Manager controller Name Requirement org.kie.server.user
A user with the
kie-server
roleorg.kie.server.pwd
The password for the user specified in the
org.kie.server.user
propertySpecify the following JVM property values on the application server instance where KIE Server is installed:
Table 6.2. Required properties for KIE Server when headless Process Automation Manager controller is installed Name Requirement org.kie.server.controller.user
A user with the
kie-server
roleorg.kie.server.controller.pwd
The password for the user specified for the
org.kie.server.controller.user
propertyorg.kie.server.id
The ID or name of the KIE Server installation, such as
rhdm700-decision-server-1
org.kie.server.location
The URL of the KIE Server,
http://<HOST>:<PORT>/kie-server/services/rest/server
org.kie.server.controller
The URL of the headless Process Automation Manager controller,
http://<HOST>:<PORT>/controller/rest/controller
<HOST>
is the ID or name of the KIE Server host, for example,localhost
or192.7.8.9
.<PORT>
is the port of the KIE Server host, for example,7001
.
6.2. Verifying the installation
After you install the headless Process Automation Manager controller and define the required system properties and role requirements on the application server, verify that the headless Process Automation Manager controller works correctly.
Prerequisites
- KIE Server and the headless Process Automation Manager controller are installed on the application server instance.
- You have set all required system properties and role requirements for the headless Process Automation Manager controller on the application server.
Procedure
In your command terminal, enter the following command to verify that the headless Process Automation Manager controller is working:
curl -X GET "http://<HOST>:<PORT>/controller/rest/controller/management/servers" -H "accept: application/xml" -u '<CONTROLLER>:<CONTROLLER_PWD>'
<HOST>
is the ID or name of the KIE Server host, for example, localhost
or 192.7.8.9
.
<PORT>
is the port of the KIE Server host, for example, 7001
.
<CONTROLLER>
and <CONTROLLER_PWD>
are the user credentials that you created in this section.
The command should return information about the KIE Server instance.
Alternatively, you can use the KIE Server Java API Client to access the headless Process Automation Manager controller.
If the headless Process Automation Manager controller is not running, stop and restart the application server instance and try again to access the headless Process Automation Manager controller URL or API.