Deploying the Reporting Data Services Adapters on Apache Tomcat

You can deploy the Reporting Data Services Adapters on the Apache Tomcat server.

Before you begin

You must install Apache Tomcat and Rational® Publishing Engine with the Reporting data services application before you can deploy the Reporting Data Services Adapters.

If you are using the IBM® Rational RequisitePro® adapter, configure the Apache Tomcat argument:
  1. Add JVM generic options: DRJCB_IN_MTA_ONLY='RJCB' –Xquickstart
    • If Apache Tomcat is running as a Windows service, add the parameter in the Java Options field.
    • If Apache Tomcat running from the command line, before you start Apache Tomcat, set this option as an environment parameter: set JAVA_OPTS=%JAVA_OPTS% -DRJCB_IN_MTA_ONLY='RJCB'-Xquickstart -Xmx512m
      Attention: The -Xquickstart option must include a hyphen (-) and not an en-dash () or an em-dash (). Copying the code phrase from this topic might convert the hyphen into an en-dash or an em-dash. When this conversion occurs, the error prevents Apache Tomcat from starting.
  2. In the Maximum memory pool field, enter 512MB.
    The Java tab of the Apache Tomcat 6 Properties window

About this task

This setup applies to IBM Rational ClearQuest®, IBM Rational RequisitePro, or IBM Rational ClearCase®. One data adapter provides a communication interface to many Rational Publishing Engine clients. For performance reasons, do not install the Reporting Data Services Adapters on the same server as the database. On the computer where the Reporting Data Services Adapters are installed, you must also install the native client to the database Rational RequisitePro thick client, Rational ClearQuest Eclipse client, and others). On the computer with the Reporting Data Services Adapters installed, the Reporting Data Services Adapters use the native client to communicate with the database. Many Rational Publishing Engine clients, even in different locations, connect to the Reporting Data Services Adapters by using http://server:port/DataServices/Adapter/<data>.

Procedure

  1. Add the adapter files to the Apache Tomcat data services directory. The default directory for Apache Tomcat is used:
    1. Copy the contents of the %RPE_HOME%\web services\Data Services\product_name\eclipse\plugins directory and paste them into the plugins folder in the Apache Tomcat data services directory. By default, the location of this directory is %CATALINA_HOME%\DataServices\WEB-INF\eclipse\plugins.
    2. Copy the contents of the %RPE_HOME%\web services\Data Services\product_name\eclipse\features directory and paste them into the features folder in the Apache Tomcat data services directory. By default, the location of this directory is %CATALINA_HOME%\DataServices\WEB-INF\eclipse\features.
    Do not delete any other files contained in the directory. The plug-ins for each adapter must be merged with the plug-ins for the web application.
  2. Open the Apache Tomcat Manager
    • If you are running Apache Tomcat as a Windows service, open the Control Panel and, in the Apache Tomcat row, click Admin. Then click Manager App.
    • If you are not running Apache Tomcat as a Windows service, open the Apache Tomcat Manager in a browser in the following format: http://server:port/manager/html

      Example: http://localhost:8080/manager/html.

  3. Restart the application server.

What to do next

  1. Verify that the Reporting Data Services Adapters are deployed correctly. Enter http://server:port/DataServices.war_context_path in a browser. If the deployment is correct, the page displays an XML list of each installed adapter.
  2. Configure the Reporting Data Services Adapters for your product, if necessary.

Feedback