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.

On Linux
computers, set these environment variables before deploying the web
services:
Table 1. Rational Publishing Engine environment
variables for LinuxVariable 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
- Open the administrative console in a browser. Example: http://localhost:9043/ibm/console/logon.jsp
- Expand Applications and
click New Application.
- Click New Enterprise Application.
- 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.
- Click Next.
- Select Fast Path - Prompt only
when additional information is required and click Next.
- Select these installation options:
- Optional: You can rename the application.
- Clear the Create MBeans for resources option.
- Select the Deploy Web services option.
- Click Next.
- In the Map modules to servers window,
select the Rational Publishing Engine module
and click Next.
- In the Map virtual hosts for Web
modules window, select Rational Publishing Engine and
click Next.
- 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.
- Review the Summary and
click Finish. Application rpe.war_application installed
successfully displays in the process log.
- Click Save.
- Click . The rpe.war application
you added is listed as the application name you entered.
- Open the Rational Publishing Engine application
properties by clicking the rpe.war_application.
- In the Detail Properties section, click Class
loading and update detection.
- In the Class loader order section, select Classes
loaded with local class loader first (parent last).
- In the WAR class loader
policy section, select Single class loader for application.
- Click OK and Save.
- In the Modules section, click Manage Modules.
- Click the Rational Publishing Engine module.
- In the Class loader order section, select Classes
loaded with local class loader first (parent last).
- Click OK and Save.
- Click .
- 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:
- Select the Use Java 2 security to restrict
application access to local resources option. The Warn if applications are granted custom
permissions becomes enabled.
- Clear the Warn if applications are granted
custom permissions option.
- Clear the Use Java 2 security to restrict
application access to local resources option.
- Click OK.
- Select the rpe.war_application check
box and click Start.
What to do next
Confirm that the application is deployed:
- Open the introductory page of the Rational Publishing Engine web
services in a browser: http://server:port/rpe/.
- 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.
- 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.