Installing Rule Scenario Manager on Tomcat 6.0

Welcome to ILOG JRules > Installing the JRules Modules > Installing JRules Modules on Tomcat 6.0 > Installing Rule Scenario Manager on Tomcat 6.0

Installing Rule Scenario Manager on Tomcat 6.0

PREVIOUS NEXT

Installing Rule Scenario Manager on Tomcat requires the prior deployment of the Rule Execution Server. For information on configuring the Rule Execution Server, see Installing Rule Execution Server on Tomcat 6.0.

The procedure to install Rule Scenario Manager on Tomcat 6.0 typically involves setting the classpath to the execution JAR and configuring Tomcat for management facilities, such as:

Managing security, if required.
Adding your database JAR to Tomcat's lib directory. For example, if your database is Derby, add the derby.jar in {TOMCAT_HOME}/lib.
Deploying <InstallDir>/scenariomanager/applicationservers/tomcat6/rsm.war into the Tomcat webapps container.

For information on configuring the persistence mode of Rule Execution Server (see Installing Rule Execution Server on Tomcat 6.0).

Deploying Rule Scenario Manager on Tomcat 6.0

To deploy Rule Scenario Manager on Tomcat 6.0, perform the following steps.

Copy the <InstallDir>/scenariomanager/applicationservers/tomcat6/rsm.war into {TOMCAT_HOME}/webapps.
Add the following lines to {TOMCAT_HOME}/conf/tomcat-users.xml:

<role rolename="rsm_user"/>

<user username="rsm" password="rsm" roles="rsm_user"/>

You can add other users as required. Note that all users of Rule Scenario Manager must have the role rsm_user defined to them.

Copy your database driver to the {TOMCAT_HOME}/lib directory. Declare the database just before the tag closing global resources definitions </GlobalNamingResources> in the {TOMCAT_HOME}/conf/server.xml file.

For example if you are using Pointbase add the following lines:

<Resource name="jdbc/rsmdatasource" type="javax.sql.DataSource"

    auth="Container"

    username="PBPUBLIC" password="PBPUBLIC"

    driverClassName="com.pointbase.jdbc.jdbcUniversalDriver"

    url="jdbc:pointbase:server://localhost:9092/tests"/>

Add the link to your database for rsm.war just before the tag closing the localhost definition |</Host>| in the {TOMCAT_HOME}/conf/server.xml file:

<Context path="/jrules-rsm-management"

        docBase="jrules-rsm-management.war"

        debug="0"

        reloadable="true"

        crossContext="true">

   <Logger className="org.apache.catalina.logger.FileLogger"

        prefix="localhost_rsm_log."

        suffix=".txt" timestamp="true"/>

   <ResourceLink name="jdbc/rsmdatasource"

        global="jdbc/rsmdatasource"

        type="javax.sql.DataSource"/>

</Context>

For more information on how to set the JNDI name of the data source, see http://jakarta.apache.org/tomcat/tomcat-6.0-doc/jndi-datasource-examples-howto.html.

Deploying the Rule Scenario Manager Online Help

To install the online help for the Rule Scenario Manager Console running on Tomcat, you first need to extract the rsmonlinehelp.war file from:

<InstallDir>/scenariomanager/online-help/rsmonlinehelp.ear

Then copy this WAR file into the webapps directory of your Tomcat installation.

Opening the Rule Scenario Manager Console

Verify that the Rule Scenario Manager Console has been successfully installed by launching it in a browser. Type rsm at the root URL on the host machine:

http://localhost:8080/rsm

If your browser is not running on the same host as the application server, replace localhost with the address of the machine. If your Web application is mapped to a host which is defined on a port that is different to 8080, change the port number from 8080 to the host port number.

According to the application server security assignment, enter the login name and password of a Rule Scenario Manager user and click Sign in. The rsm_user role must be assigned a user with a password. The default username/password for Rule Scenario Manager is rsm/rsm.