10.2. Installing the Realtime Decision Server in Other Containers

10.2.1. JBoss Web Server 2.x/3.x, Tomcat 8.x/9.x

Use the following procedure to install the Realtime Decision Server in a Tomcat container.

Procedure:

  1. Download and unzip the Tomcat distribution.
  2. Download kie-server-6.4.0.Final-webc.war and place it into TOMCAT_HOME/webapps.
  3. Configure user(s) and role(s). Make sure that TOMCAT_HOME/conf/tomcat-users.xml contains the following username and role definition. The username and password should be unique, however ensure that the user has the role kie-server:

    <role rolename="kie-server"/>
    <user username="serveruser" password="my.s3cr3t.pass" roles="kie-server"/>
  4. Start the server by running TOMCAT_HOME/bin/startup.[sh|bat]. You can check out the Tomcat logs in TOMCAT_HOME/logs to see if the application deployed successfully. See Section 10.3.1, “Bootstrap Switches” for the bootstrap switches that can be used to properly configure the instance. For instance:

    $ ./startup.sh -Dorg.kie.server.id=first-kie-server -Dorg.kie.server.location=http://localhost:8080/kie-server/services/rest/server
  5. Verify the server is running. Access http://SERVER:PORT/kie-server/services/rest/server/ and type the specified username and password. You should see simple XML message with basic information about the server.
Important

You cannot leverage the JMS interface when running on Tomcat, or any other Web container. The Web container version of the WAR contains only the REST interface.