Deploying web services on WebSphere Application Server 7.0

You can deploy the Rational® Publishing Engine web services on WebSphere® Application Server version 7.0 to run remote reports, the REST data services, and the data adapter services.

Before you begin

You must install WebSphere Application Server 7.0 and Rational Publishing Engine with the web services feature 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 administrative console in a browser. Example: http://localhost:9043/ibm/console/logon.jsp
  2. Expand Applications and click New Application.
  3. Click New Enterprise Application.
  4. In the Preparing for the application installation 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.
  5. Click Next.
  6. Select Fast Path - Prompt only when additional information is required and click Next.
  7. 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.
  8. In the Map modules to servers window, select the Rational Publishing Engine module and click Next.
  9. In the Map virtual hosts for Web modules window, select Rational Publishing Engine and click Next.
  10. In Map context roots for web modules, enter the context root as /rpe. This entry is a part of the URL used for configuring the client.
  11. Review the Summary and click Finish. Application rpe.war_application installed successfully displays in the process log.
  12. Click Save.
  13. Click Applications > Application Types > Websphere enterprise applications. The rpe.war application you added is listed as the application name you entered.
  14. Open the Rational Publishing Engine application properties by clicking the rpe.war_application.
  15. In the Detail Properties section, click Class loading and update detection.
  16. In the Class loader order section, select Classes loaded with local class loader first (parent last).
  17. In the WAR class loader policy section, select Single class loader for application.
  18. Click OK and Save.
  19. In the Modules section, click Manage Modules.
  20. Click the Rational Publishing Engine module.
  21. In the Class loader order section, select Classes loaded with local class loader first (parent last).
  22. Click OK and Save.
  23. Click Security > Global Security.
  24. In the Java 2 security section, clear all of the options. If the Warn if applications are granted custom permissions option is selected and cannot be edited:
    1. Select the Use Java 2 security to restrict application access to local resources option. The Warn if applications are granted custom permissions becomes enabled.
    2. Clear the Warn if applications are granted custom permissions option.
    3. Clear the Use Java 2 security to restrict application access to local resources option.
  25. Click OK.
  26. 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