Deploying the data source adapters

You can deploy the data services WAR file on the Apache Tomcat server.

Before you begin

Install the data services and then deploy the plug-in files for the adapters on the web server.

Procedure

  1. Start the Tomcat Manager. By default it is located at http://localhost:8080/manager/html.
  2. Supply the administrator credentials for server authentication. The credentials are defined during Tomcat installation.
  3. In the WAR file for deploy section, click Browse and locate the DataServices.war file where IBM® Rational® Publishing Engine was installed. The default is C:\Program Files\IBM\Rational\Publishing Engine\RPEn.n\web services\data services\DataServices.war.
  4. Click Deploy.
  5. 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 C:\Program Files\IBM\Rational\Publishing Engine\RPEn.n\web services\data services directory. For example, the plugins are located at C:\Program Files\IBM\Rational\Publishing Engine\1.1.2\web services\data services\eclipse\plugins.
    2. Locate the file system directory of the web application at CATALINA_HOME\DataServices\WEB-INF\eclipse. The CATALINA_HOME location depends on your installed instance of Tomcat Application Server. The default is C:\Program Files\Apache Software Foundation\Tomcat 6.0.
    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.
  6. If you are using the RequisitePro Adaptor, configure the Apache Tomcat argument. If you are using any other data services adaptor, you can skip this step. To 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 running from the command line, set this option as an environment parameter, prior to starting Tomcat: set JAVA_OPTS=%JAVA_OPTS% -DRJCB_IN_MTA_ONLY='RJCB'-Xquickstart -Xmx512m
        Attention: The -Xquickstart option must include a hyphen (-) and not an endash (–) or an emdash (—). Copying the code phrase from this topic might convert the hyphen into an endash or an emdash and when this occurs, the error prevents Apache Tomcat from starting.
    2. Set max heap size to 512M.
  7. Restart the web server.
  8. Verify that the data services deployed correctly by opening: http://localhost:8080/DataServices. If the deployment is correct, you see an XML document that lists each installed adapter.

Feedback