Deploying web services on WebSphere Application Server 6.1

You can deploy the IBM® Rational® Publishing Engine web services on IBM WebSphere® Application Server version 6.1 to remotely generate the documents.

Before you begin

You must install WebSphere Application Server 6.1 and Rational Publishing Engine with the web services feature before you can deploy 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 administrative console in a browser. Example: http://localhost:9043/ibm/console/logon.jsp
  2. Expand Applications and click Install New Application.
  3. In the Path to the new application window, select the path to rpe.war. By default, the archive file is located in %RPE_HOME%\web services\engine\rpe.war.
    • If you are using a local file, select Local file system. Click Browse and select the rpe.war file.
    • If you are using a remote file, select Remote file system. Click Browse and select the rpe.war file.
  4. In the Context root field, enter the context path as /rpe, and click Next. The context root is a part of the URL used for configuring the client.
  5. In the How do you want to install the application field, select Prompt me only when additional information is required and click Next.
  6. Select these installation options:
    1. Optional: You can rename the application.
    2. Clear the Create MBeans for resources option.
    3. Select the Deploy Web services option.
    4. Click Next.
  7. In the Map modules to servers window, select the Rational Publishing Engine module and click Next.
  8. In the Map virtual hosts for Web modules window, select Rational Publishing Engine and click Next.
  9. Review the Summary and click Finish. Application rpe.war_application installed successfully displays in the process log.
  10. Click Save.
  11. Expand Applications and select Enterprise Applications. The rpe.war application you added is listed as the application name you entered.
  12. Open the Rational Publishing Engine application properties by clicking the rpe.war_application.
  13. In the Detail Properties section, click Class loading and update detection.
  14. For Polling interval for updated files, enter a value in seconds.
  15. In the Class loader order section, select Classes loaded with application class loader first.
  16. In the WAR class loader policy section, select Single class loader for application.
  17. Click OK and Save.
  18. Select the rpe.war_application check box and click Start.

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