Manually deploying the Remote services application on WebSphere Application Server

You can deploy the Rational® Publishing Engine Remote services application on WebSphere® Application Server version 7.0 or 8.0 to run remote reports, the Reporting data services application, and the Reporting Data Services Adapters. If you deployed the Remote services application onto WebSphere Application Server during Rational Publishing Engine installation, you do not have to complete this task.

Before you begin

You must install WebSphere Application Server 7.0 or 8.0 and Rational Publishing Engine with the Remote services application before deploying the Remote services application.

Procedure

  1. Open the administrative console in a browser. Example: http://server:port/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 rpews.war. By default, the archive file is located in %RPE_HOME%\Remote services\rpews.war.
    • If you are using a local file, select Local file system. Click Browse and select the rpews.war file.
    • If you are using a remote file, select Remote file system. Click Browse and select the rpews.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 Remote services option.
    4. Click Next.
  8. In the Map modules to servers window, select the RPE Remote Services module and click Next.
  9. In the Map virtual hosts for Web modules window, select RPE Remote Services and click Next.
  10. In Map context roots for web modules, enter the context root as /rpews. This entry is a part of the URL used for configuring the client.
  11. Review the Summary and click Finish. Application rpews.war installed successfully displays in the process log.
  12. If you are using WebSphere Application Server 8, in the Metadata for modules window, clear the metadata-complete attribute field and click Next.
  13. Click Save.
  14. Click Applications > Application Types > WebSphere enterprise applications. The rpews.war application you added is listed as the application name you entered.
  15. Click Security > Global Security.
  16. In the Application security section, select the Enable application security option.
  17. 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.
  18. Click OK.
  19. Click Applications > Application Types > WebSphere enterprise applications.
  20. Select the rpews.war application check box and click Start.
  21. Restart the WebSphere Application Server profile where the rpews.war application is deployed.

Results

The application is deployed. You can confirm that the application is deployed by opening the introductory page of the Rational Publishing Engine Web Services application in a browser: http://server:port/rpews/.

What to do next

Configure the remote services listed on the http://server:port/rpews/ page. See Remote services URLs for an explanation of how each URL is used and tasks for configuring each of the features.

Feedback