9.2. Installing the headless Decision Manager controller
You can install the headless Decision Manager controller and use the REST API or the KIE Server Java Client API to interact with it.
Prerequisites
-
A backed-up Red Hat JBoss EAP installation version 7.3 is available. The base directory of the Red Hat JBoss EAP installation is referred to as
EAP_HOME. - Sufficient user permissions to complete the installation are granted.
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: Decision Manager
- Version: 7.10
-
Download Red Hat Decision Manager 7.10.0 Add Ons (the
rhdm-7.10.0-add-ons.zipfile). -
Extract the
rhdm-7.10.0-add-ons.zipfile. Therhdm-7.10.0-controller-ee7.zipfile is in the extracted directory. -
Extract the
rhdm-7.10.0-controller-ee7archive to a temporary directory. In the following examples this directory is calledTEMP_DIR. Copy the
TEMP_DIR/rhdm-7.10.0-controller-ee7/controller.wardirectory toEAP_HOME/standalone/deployments/.警告Ensure that the names of the headless Decision Manager controller deployments you copy do not conflict with your existing deployments in the Red Hat JBoss EAP instance.
-
Copy the contents of the
TEMP_DIR/rhdm-7.10.0-controller-ee7/SecurityPolicy/directory toEAP_HOME/bin. - When prompted to overwrite files, select Yes.
-
In the
EAP_HOME/standalone/deployments/directory, create an empty file namedcontroller.war.dodeploy. This file ensures that the headless Decision Manager controller is automatically deployed when the server starts.
9.2.1. Creating a headless Decision Manager controller user リンクのコピーリンクがクリップボードにコピーされました!
Before you can use the headless Decision Manager controller, you must create a user that has the kie-server role.
Prerequisites
-
The headless Decision Manager controller is installed in the base directory of the Red Hat JBoss EAP installation (
EAP_HOME).
Procedure
-
In a terminal application, navigate to the
EAP_HOME/bindirectory. Enter the following command and replace
<USER_NAME>and<PASSWORD>with the user name and password of your choice.$ ./add-user.sh -a --user <username> --password <password> --role kie-server注記Make sure that the specified user name is not the same as an existing user, role, or 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 one number and one non-alphanumeric character, but not & (ampersand).
- Make a note of your user name and password.
9.2.2. Configuring KIE Server and the headless Decision Manager controller リンクのコピーリンクがクリップボードにコピーされました!
If KIE Server will be managed by the headless Decision Manager controller, you must edit the standalone-full.xml file in KIE Server installation and the standalone.xml file in the headless Decision Manager controller installation.
Prerequisites
-
KIE Server is installed in an
EAP_HOME. The headless Decision Manager controller is installed in an
EAP_HOME.注記You should install KIE Server and the headless Decision Manager controller on different servers in production environments. However, if you install KIE Server and the headless Decision Manager controller on the same server, for example in a development environment, make these changes in the shared
standalone-full.xmlfile.-
On KIE Server nodes, a user with the
kie-serverrole exists. On the server nodes, a user with the
kie-serverrole exists.Procedure
In the
EAP_HOME/standalone/configuration/standalone-full.xmlfile, add the following properties to the<system-properties>section and replace<USERNAME>and<USER_PWD>with the credentials of a user with thekie-serverrole:<property name="org.kie.server.user" value="<USERNAME>"/> <property name="org.kie.server.pwd" value="<USER_PWD>"/>In the KIE Server
EAP_HOME/standalone/configuration/standalone-full.xmlfile, add the following properties to the<system-properties>section:<property name="org.kie.server.controller.user" value="<CONTROLLER_USER>"/> <property name="org.kie.server.controller.pwd" value="<CONTROLLER_PWD>"/> <property name="org.kie.server.id" value="<KIE_SERVER_ID>"/> <property name="org.kie.server.location" value="http://<HOST>:<PORT>/kie-server/services/rest/server"/> <property name="org.kie.server.controller" value="<CONTROLLER_URL>"/>- In this file, replace the following values:
-
Replace
<CONTROLLER_USER>and<CONTROLLER_PWD>with the credentials of a user with thekie-serverrole. -
Replace
<KIE_SERVER_ID>with the ID or name of the KIE Server installation, for example,rhdm-7.10.0-kie-server-1. -
Replace
<HOST>with the ID or name of the KIE Server host, for example,localhostor192.7.8.9. Replace
<PORT>with the port of the KIE Server host, for example,8080.注記The
org.kie.server.locationproperty specifies the location of KIE Server.-
Replace
<CONTROLLER_URL>with the URL of the headless Decision Manager controller. KIE Server connects to this URL during startup.