Deploying the data source adapters on Apache Tomcat

You can deploy the data source adapters on the Apache Tomcat server.

Before you begin

You must install Apache Tomcat and Rational® Publishing Engine with the data services feature before you can deploy the data source 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 and 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. Open the Apache Tomcat Manager in a browser: http://server:port/manager/html. Example: http://localhost:8080/manager/html.
  2. Add the adapter plug-ins to the web application by copying the adapter archive files to the library directory of the web application.
    1. Locate the plug-ins for the adapters. By default, the plug-ins are installed in a subdirectory of the %RPE_HOME%\web services\data services directory. For example, the plug-ins are in %RPE_HOME%\web services\data services\eclipse\plugins.
    2. Locate the file system directory of the web application at %CATALINA_HOME%\DataServices\WEB-INF\eclipse.
    3. Copy the contents of the eclipse directory of substep (a) to the directory of substep (b). Make sure that the contents of the eclipse/features directory is copied to the features directory and the contents of the eclipse/plug-ins directories is copied to the plugins directory. Do not to delete any files in the deployed web application. The features and plug-ins for each adapter must be merged with the features and plug-ins of the web application.
  3. Restart the application server.

What to do next

Verify that the data services 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.

Feedback