红帽全球峰会此内容没有您所选择的语言版本。
Chapter 6. Installing and running the standalone Decision Server Controller
You can configure Decision Server to run in managed or unmanaged mode. If Decision Server is unmanaged, you must manually create and maintain containers. If Decision Server is managed, the standalone Decision Server Controller manages the Decision Server configuration and you interact with the Controller to create and maintain containers.
The standalone Decision Server Controller is integrated with Decision Central. If you install Decision Central, use the Exection Server page to create and maintain containers. However, if you do not install Decision Central, you can install the standalone Decision Server Controller and use the REST API or the Decision Server Java Client API to interact with it.
6.1. Downloading and extracting the Controller
You must download and extract the standalone Decision Server Controller before installing it on IBM WebSphere.
- Log in to the Red Hat Customer Portal.
- Click DOWNLOADS at the top of the page.
- On the Product Downloads page that opens, navigate to the JBOSS INTEGRATION AND AUTOMATION section, and click Red Hat Decision Manager.
- On the Software Downloads page, if necessary select Decision Manager from the Product menu and 7.0 from the Version menu.
- Click Download next to Red Hat Decision Manager 7.0.0 Add Ons.
-
Unzip the
rhdm-7.0.0.GA-add-ons.zipfile. Therhdm-7.0-controller-ee7.zipfile is in the unzipped directory. -
Extract the
rhdm-7.0-controller-ee7.zipfile to a temporary directory, for example,TEMP_DIR. Navigate to the
TEMP_DIR/controller.warfolder and run the following command:zip -r controller.war ./*
6.2. Setting environment variables for the Controller
Set the environment variables listed in this section.
Prerequisites
- Decision Server installed on an IBM WebSphere instance
The Controller installed on an IBM WebSphere instance
NoteRed Hat recommends that you install Decision Server and the standalone Decision Server Controller on different servers in production environments. However, if you install Decision Server and the standalone Decision Server Controller on the same server, for example in a development environment, make these changes on the same IBM WebSphere instance.
-
On Decision Server nodes, a user with the
kie-serverrole -
On the Controller server nodes, a user with the
kie-serverrole
Procedure
Specify the following JVM property values on the IBM WebSphere instance where the Controller is installed:
-
org.kie.server.user: A user with thekie-serverrole. -
org.kie.server.pwd: The password for the user specified in theorg.kie.server.userproperty.
-
Specify the following JVM property values on the IBM WebSphere instance where Decision Server is installed:
-
org.kie.server.controller.user: A user with thekie-serverrole -
org.kie.server.controller.pwd: The password for the user specified for theorg.kie.server.controller.userproperty -
org.kie.server.id: The ID or name of the Decision Server installation, for example,rhdm700-decision-server-1 -
org.kie.server.location:http://<HOST>:<PORT>/kie-server/services/rest/server org.kie.server.controller: The URL of the standalone Decision Server Controller, for examplehttp://<HOST>:<PORT>/controller/rest/controllerIn the preceding examples:
-
<HOST>is the ID or name of the Decision Server host, for example,localhostor192.7.8.9. -
<PORT>is the port of the Decision Server host, for example,8080.
-
6.3. Installing the Controller
This section describes how to install the Controller on IBM WebSphere Application Server.
You can install the Controller and use the REST API or the Decision Server Java Client API to interact with it.
Prerequisites
- An IBM WebSphere instance configured as described in this document
- Sufficient user permissions to complete the installation
-
The
rhdm-7.0-controller-ee7.zipfile, extracted and repacked to thecontroller.warfile
Procedure
Click Applications
Application Types WebSphere Enterprise Applications. This shows you all of the existing applications in the system and enables you to install a new one.
- Click Install.
-
Upload the Controller WAR file (
controller.war) from the local file system. Select Fast Path and click Next.
The Install New Application wizard opens.
- In the Map Virtual Hosts for Web Modules section, keep the default values and click Next.
-
Set the context root to
controller. - In the Metadata for Modules section, keep the default values and click Next.
- Click Finish to install the controller.
- Click Save to save the changes to the master configuration.
6.3.1. Mapping Groups to Roles
Map the controller role to a user or a group.
Procedure
-
Go back to the main configuration page for the newly installed
kie-serverapplication (ApplicationsApplication Types WebSphere Enterprise Applications). - Click Security Role to User/Group Mapping under Detail Properties.
-
Select the
kie-serverrole and click Map Groups to search for thekie-servergroup. -
Move the
controllergroup from the Available list to the Selected list and click OK. This mapping gives the previously created administrator user access to the Decision Server. -
Click Save and start the
kie-serverapplication.
6.3.2. Verifying the installation
After you install and start the controller, verify that it works correct.
Procedure
To verify that the Controller is working on IBM WebSphere, enter the following command:
curl -X GET "http://<HOST>:<PORT>/controller/rest/controller/management/servers" -H "accept: application/xml" -u '<CONTROLLER>:<CONTROLLER_PWD>'In this command, replace
<CONTROLLER>and<CONTROLLER_PWD>with the user credentials that you created in this section.The output of this command provides information about the Decision Server instance.
-
Check whether the Controller REST API works by sending a GET request at
http://TARGET_SERVER:PORT/kie-server/services/rest/server.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}