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

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 in a browser: 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