Search
SupportConsoleDevelopersStart a trialContact

Chapter 5. Installing and running Decision Server with IBM WebSphere Application Server

download PDF

After you have configured all required system properties in IBM WebSphere Application Server, you can install Decision Server with IBM WebSphere to streamline Red Hat Decision Manager application management.

Prerequisite

An IBM WebSphere Application Server instance is configured as described in Chapter 4, Configuring IBM WebSphere Application Server for Decision Server.

Procedure

  1. 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.2
  2. Download Red Hat Decision Manager 7.2.0 Decision Server for All Supported EE7 Containers.
  3. Extract the rhdm-7.2.0-kie-server-ee7.zip archive to a temporary directory. In the following examples this directory is called TEMP_DIR.

  4. Repackage the kie-server.war directory:

    1. Navigate to the TEMP_DIR/rhdm-7.2.0-kie-server-ee7/kie-server.war directory.
    2. Select the contents of the TEMP_DIR/rhdm-7.2.0-kie-server-ee7/kie-server.war directory and create the kie-server.zip file.
    3. Rename kie-server.zip to kie-server.war. This is the file that you will use to deploy Decision Server.
    4. If desired, copy the new kie-server.war file to a location that is more convenient to deploy from.
  5. In the WebSphere Integrated Solutions Console, navigate to Applications Application Types WebSphere Enterprise Applications.
  6. Click Install.
  7. Navigate to the kie-server.war file that you repackaged and select it to upload.

  8. Select Fast Path and click Next.

    The Install New Application wizard opens.

  9. Change the Application Name to kie-server and click Next.
  10. Map the Decision Server modules to servers according to your specific requirements and click Next.
  11. 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 the jms/cf/KIE.SERVER.REQUEST JNDI name for the KIE.SERVER.REQUEST connection factory.
  12. In the Map Virtual Hosts for Web Modules section, keep the default values and click Next.
  13. Set the context root to kie-server.
  14. In the Metadata for Modules section, keep the default values and click Next.
  15. Click Finish to install Decision Server and click Save to save the changes to the master configuration.

5.1. Creating the Decision Server group and role

After Decision Server is installed, you must create the kie-server group and a user.

Prerequisite

  • Decision Server is installed on the IBM WebSphere Application Server instance.

Procedure

  1. In the WebSphere Integrated Solutions Console, click Users and Groups Manage Groups.
  2. In the Manage Groups screen, click Create.
  3. In the Create a Group screen, enter kie-server in the Group name box, then click Create.
  4. To create a user to add to the kie-server group, click Users and Groups Manage Users.
  5. In the Create a User screen, complete the required information.
  6. Click Group Membership.
  7. In the Group Membership screen, click kie-server, move it to Mapped To, and click Close.
  8. On the Create a User screen click Create.

5.2. Mapping the Decision Server group and role

After Decision Server is installed, you must map the kie-server role to the kie-server group in the WebSphere Integrated Solutions Console to run Decision Server.

Prerequisites

  • Decision 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

  1. In the WebSphere Integrated Solutions Console, navigate to Applications Application Types WebSphere Enterprise Applications and select the newly installed kie-server application.
  2. Under Detail Properties, click Security Role to User/Group Mapping.
  3. Select the kie-server role and click Map Groups to search for the kie-server group.

  4. 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 Decision Server.

  5. Click Save to complete the mapping.

5.3. Configuring class loading for Decision Server

After Decision Server is installed, you must configure class loading to set parent classes to load last.

Procedure

  1. Navigate to Applications Application Types WebSphere Enterprise Applications and click kie-server.
  2. Click Class Loading and Update Detection under the Detail Properties heading on the left.
  3. 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.
  4. Save the changes to the master configuration.

5.4. Verifying the installation

After you install Decision Server and define the Decision Server group mapping, verify that the server is running.

Prerequisites

  • Decision Server is installed on the IBM WebSphere Application Server instance.
  • You have set all required system properties for the headless Decision Manager controller.
  • You have defined the Decision Server group mapping in IBM WebSphere Application Server.

Procedure

Navigate to the Decision Server URL http://<HOST>:<PORT>/kie-server to verify that the server is running, or send a GET request to http://<HOST>:<PORT>/kie-server/services/rest/server to check whether the Decision Server REST API responds.

<HOST> is the ID or name of the Decision Server host, for example, localhost or 192.7.8.9.

<PORT> is the port of the Decision Server host, for example, 9060.

If Decision Server is not running, stop and restart the IBM WebSphere Application Server instance and try again to access the Decision Server URL or API.

Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.