Chapter 48. Installing and running KIE Server with IBM WebSphere Application Server
After you have configured all required system properties in IBM WebSphere Application Server, you can install KIE Server with IBM WebSphere to streamline Red Hat Process Automation Manager application management.
Prerequisites
- An IBM WebSphere Application Server instance is configured as described in Chapter 47, Configuring IBM WebSphere Application Server for KIE Server.
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.13.5
- Download Red Hat Process Automation Manager 7.13.5 KIE Server for All Supported EE7 Containers.
-
Extract the
rhpam-7.13.5-kie-server-ee7.zip
archive to a temporary directory. In the following examples this directory is calledTEMP_DIR
. Repackage the
kie-server.war
directory:-
Navigate to the
TEMP_DIR/rhpam-7.13.5-kie-server-ee7/kie-server.war
directory. -
Select the contents of the
TEMP_DIR/rhpam-7.13.5-kie-server-ee7/kie-server.war
directory and create thekie-server.zip
file. -
Rename
kie-server.zip
tokie-server.war
. This is the file that you will use to deploy KIE Server. -
Optional: Copy the new
kie-server.war
file to a location that is more convenient to deploy from.
-
Navigate to the
-
In the WebSphere Integrated Solutions Console, navigate to Applications
Application Types WebSphere Enterprise Applications. - Click InstCll.
-
Navigate to the
kie-server.war
file that you repackaged and select it to upload. Select Fast Path and click Next.
The Install New Application wizard opens.
-
Change the Application Name to
kie-server
and click Next. - Map the KIE Server modules to servers according to your specific requirements and click Next.
-
For Bind Listeners for Message-Driven Beans, select Activation Specification for both beans, enter
jms/activation/KIE.SERVER.REQUEST
in the Target Resource JNDI Name field, and enter thejms/cf/KIE.SERVER.REQUEST
JNDI name for theKIE.SERVER.REQUEST
connection factory. - In the Map Virtual Hosts for Web Modules section, keep the default values and click Next.
-
Set the context root to
kie-server
. - In the Metadata for Modules section, keep the default values and click Next.
- Click Finish to install KIE Server and click Save to save the changes to the primary configuration.
48.1. Creating the KIE Server group and role
After KIE Server is installed, you must create the kie-server
group and a user.
Prerequisites
- KIE Server is installed on the IBM WebSphere Application Server instance.
Procedure
-
In the WebSphere Integrated Solutions Console, click Users and Groups
Manage Groups. - In the Manage Groups screen, click Create.
-
In the Create a Group screen, enter
kie-server
in the Group name box, then click Create. -
To create a user to add to the
kie-server
group, click Users and GroupsManage Users. - In the Create a User screen, complete the required information.
- Click Group Membership.
-
In the Group Membership screen, click
kie-server
, move it to Mapped To, and click Close. - On the Create a User screen click Create.
48.2. Mapping the KIE Server group and role
After KIE Server is installed, you must map the kie-server
role to the kie-server
group in the WebSphere Integrated Solutions Console to run KIE Server.
Prerequisites
- KIE Server is installed on the IBM WebSphere Application Server instance.
-
IBM WebSphere Application Server has the
kie-server
group with at least one user.
Procedure
-
In the WebSphere Integrated Solutions Console, navigate to Applications
Application Types WebSphere Enterprise Applications and select the newly installed kie-server
application. - Under Detail Properties, click Security Role to User/Group Mapping.
-
Select the
kie-server
role and click Map Groups to search for thekie-server
group. Move the
kie-server
group from the Available list to the Selected list and click OK.This mapping gives users in the IBM WebSphere Application Server
kie-server
group access to KIE Server.- Click Save to complete the mapping.
48.3. Configuring class loading for KIE Server
After KIE Server is installed, you must configure class loading to set parent classes to load last.
Procedure
-
Navigate to Applications
Application Types WebSphere Enterprise Applications and click kie-server
. - Click Class Loading and Update Detection under the Detail Properties heading on the left.
- In the properties, change Class Loader Order to Classes loaded with local class loader first (parent last) and WAR Class Loader Policy to Single class loader for application.
- Save the changes to the primary configuration.
48.4. Verifying the installation
After you install KIE Server and define the KIE Server group mapping, verify that the server is running.
Prerequisites
- KIE Server is installed on the IBM WebSphere Application Server instance.
- You have set all required system properties for the headless Process Automation Manager controller.
- You have defined the KIE Server group mapping in IBM WebSphere Application Server.
Procedure
To verify that the server is running, complete one of the following tasks:
-
Navigate to the KIE Server URL
http://<HOST>:<PORT>/kie-server
. Send a
GET
request tohttp://<HOST>:<PORT>/kie-server/services/rest/server
to check whether the KIE Server REST API responds.In these examples, replace the following placeholders:
-
<HOST>
is the ID or name of the headless Process Automation Manager controller, for example,localhost
or192.7.8.9
. -
<PORT>
is the port number of the KIE Server host, for example,9060
.
-
-
Navigate to the KIE Server URL
- If KIE Server is not running, stop and restart the IBM WebSphere Application Server instance and try again to access the KIE Server URL or API.