Deploying on Apache Tomcat

You can deploy the Rational® Publishing Engine web services on the 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. Make sure that a supported server container such as Apache Tomcat 6.0 or later is configured to run with a supported IBM Java Runtime Environment 6.0 or later on 32 bit.

Procedure

  1. Start the Apache Tomcat Manager. You can access it using http://hostname:port/manager/html. For example, http://localhost:8080/manager/html.
  2. Enter the administrator credentials that you defined during the Apache Tomcat installation procedure to authenticate the server.
  3. In the Deploy > WAR file to deploy section, click Browse.
  4. Select the web archive file %RPE_HOME%\web services\engine\rpe.war file.
  5. Click Deploy.
  6. Confirm that the application has been deployed:
    1. Verify that the Rational Publishing Engine entry appears in the Applications list.
    2. Verify that the path http://servername:port/rpe/ points to an introductory page of the Rational Publishing Engine web services.
  7. In the introductory page of the web services, copy the either of the links to the web services definition schema: http://servername:port/rpe/services/RPEService?wsdl or http://servername:port/rpe/wsgate These links are required to complete the Configuring the client applications task.
    Note: The link http://servername:port/rpe/wsgate also works if a load balancer is deployed. See, What’s new in Rational Publishing Engine 1.1.2.1

What to do next

On Linux, set the following environment variables before starting the server.
Variable Name Value
RPE_HOME The path to the root folder of the Rational Publishing Engine installation.
LD_LIBRARY_PATH The path to the lib folder in the Rational Publishing Engine installation.

Feedback