Deploying web services on Apache Tomcat

You can deploy the Rational® Publishing Engine web services on a Apache Tomcat server to run the remote reports, the REST data services, and the data adapter services.

Before you begin

You must install Rational Publishing Engine on the server before deploying the web services.
Linux icon On Linux computers, set these environment variables before deploying the web services:
Table 1. Rational Publishing Engine environment variables for Linux
Variable Name Description Example
RPE_HOME The path to the root folder of the Rational Publishing Engine installation. /opt/IBM/Rational/Publishing Engine/version
LD_LIBRARY_PATH The path to the lib folder in the Rational Publishing Engine installation. /opt/IBM/Rational/Publishing Engine/version/lib

Procedure

  1. Open the Apache Tomcat Manager in a browser: http://server:port/manager/html. Example: http://localhost:8080/manager/html.
  2. In the Deploy section, enter the details for the rpe.war file.
    • If the .war file is on a different server than Apache Tomcat, enter the following information in the Deploy directory or WAR file located on server section:
      1. Context Path: Enter /rpe as the name for the web services application. This entry is a part of the URL used for configuring the client.
      2. XML Configuration file URL: You are not required to enter a value in this field.
      3. WAR or Directory URL: The path to rpe.war. Example: %RPE_HOME%\web services\engine\rpe.war
    • If the .war file is on the same server as Apache Tomcat, enter the following information in the WAR file to deploy section:
      1. Select WAR to upload: The path to rpe.war. Example: %RPE_HOME%\web services\engine\rpe.war
  3. Click Deploy.

What to do next

Confirm that the application is deployed:
  1. Open the introductory page of the Rational Publishing Engine web services in a browser: http://server:port/rpe/.
    Web services definition link in the browser
  2. Copy the link to the web services definition schema: http://server:port/rpe/services/RPEService?wsdl. This link is required to complete the Configuring the client applications for remote publishing task.
  3. If a load balancer is deployed, enter http://server:port/rpe/wsgate into a browser to verify that the same web services definition schema link displays: http://server:port/rpe/services/RPEService?wsdl.

Feedback