Chapter 8. Configuring KIE Server to connect to Business Central
This section provides a sample setup that you can use for testing purposes. Some of the values are unsuitable for a production environment, and are marked as such.
If a KIE Server is not configured in your Red Hat Decision Manager environment, or if you require additional KIE Servers in your Red Hat Decision Manager environment, you must configure a KIE Server to connect to Business Central.
If you are deploying KIE Server on Red Hat OpenShift Container Platform, see the Deploying a Red Hat Decision Manager environment on Red Hat OpenShift Container Platform using Operators document for instructions about configuring it to connect to Business Central.
KIE Server can be managed or unmanaged. If KIE Server is unmanaged, you must manually create and maintain KIE containers (deployment units). If KIE Server is managed, the Decision Manager controller manages the KIE Server configuration and you interact with the Decision Manager controller to create and maintain the KIE containers.
Make the changes described in this section if KIE Server is managed by Business Central and you have installed Red Hat Decision Manager from the ZIP files. If you have installed Business Central, you can use the headless Decision Manager controller to manage KIE Server, as described in Chapter 9, Installing and running the headless Decision Manager controller.
Prerequisites
-
Business Central and KIE Server are installed in the base directory of the Red Hat JBoss EAP installation (
EAP_HOME).
You must install Business Central and KIE Server on different servers in production environments. In this sample situation, we use only one user named controllerUser, containing both rest-all and the kie-server roles. However, if you install KIE Server and Business Central on the same server, for example in a development environment, make the changes in the shared standalone-full.xml file as described in this section.
Users with the following roles exist:
-
In Business Central, a user with the role
rest-all -
On the KIE Server, a user with the role
kie-server
-
In Business Central, a user with the role
Procedure
-
In your Red Hat Decision Manager installation directory, navigate to the
standalone-full.xmlfile. For example, if you use a Red Hat JBoss EAP installation for Red Hat Decision Manager, go to$EAP_HOME/standalone/configuration/standalone-full.xml. Open
standalone-full.xmlfile and under the<system-properties>tag, set the following JVM properties:Table 8.1. JVM Properties for Managed KIE Server Instance
Property Value Note org.kie.server.iddefault-kie-serverThe KIE Server ID.
org.kie.server.controllerhttp://localhost:8080/decision-central/rest/controllerThe location of Business Central. The URL for connecting to the API of Business Central.
org.kie.server.controller.usercontrollerUserThe user name with the role
rest-allwho can log in to the Business Central.org.kie.server.controller.pwdcontrollerUser1234;The password of the user who can log in to the Business Central.
org.kie.server.locationhttp://localhost:8080/kie-server/services/rest/serverThe location of the KIE Server. The URL for connecting to the API of KIE Server.
Table 8.2. JVM Properties for Business Central Instance
Property Value Note org.kie.server.usercontrollerUserThe user name with the role
kie-server.org.kie.server.pwdcontrollerUser1234;The password of the user.
Example for KIE Server Instance:
<property name="org.kie.server.id" value="default-kie-server"/> <property name="org.kie.server.controller" value="http://localhost:8080/decision-central/rest/controller"/> <property name="org.kie.server.controller.user" value="controllerUser"/> <property name="org.kie.server.controller.pwd" value="controllerUser1234;"/> <property name="org.kie.server.location" value="http://localhost:8080/kie-server/services/rest/server"/>
Example for Business Central Instance:
<property name="org.kie.server.user" value="controllerUser"/> <property name="org.kie.server.pwd" value="controllerUser1234;"/>
To verify that KIE Server starts successfully, send a GET request to
http://SERVER:PORT/kie-server/services/rest/server/when KIE Server is running. For more information about running Red Hat Decision Manager on KIE Server, see Running Red Hat Decision Manager.After successful authentication, you receive an XML response similar to the following example:
<response type="SUCCESS" msg="Kie Server info"> <kie-server-info> <capabilities>KieServer</capabilities> <capabilities>BRM</capabilities> <capabilities>BPM</capabilities> <capabilities>CaseMgmt</capabilities> <capabilities>BPM-UI</capabilities> <capabilities>BRP</capabilities> <capabilities>DMN</capabilities> <capabilities>Swagger</capabilities> <location>http://localhost:8230/kie-server/services/rest/server</location> <messages> <content>Server KieServerInfo{serverId='first-kie-server', version='7.5.1.Final-redhat-1', location='http://localhost:8230/kie-server/services/rest/server', capabilities=[KieServer, BRM, BPM, CaseMgmt, BPM-UI, BRP, DMN, Swagger]}started successfully at Mon Feb 05 15:44:35 AEST 2018</content> <severity>INFO</severity> <timestamp>2018-02-05T15:44:35.355+10:00</timestamp> </messages> <name>first-kie-server</name> <id>first-kie-server</id> <version>7.5.1.Final-redhat-1</version> </kie-server-info> </response>Verify the successful registration:
- Log in to Business Central.
Click Menu → Deploy → Execution Servers.
If registration is successful, you can see the registered server ID.