Setting engine preferences

In the Engine preferences window, you can define the IBM® Rational® Publishing Engine engine as remote or local.

Before you begin

Deploy the web services application. Contact your system administrator for the web service address URL in this format: http://server:port/rpe/services/RPEService?wsdl. To verify that you have the correct URL, open the link in a browser.

About this task

Using the load balancing feature, you can reduce the work load directed to a single web server instance by providing a larger set of web service instances to publish documents.

In earlier versions of Rational Publishing Engine, to publish documents using Rational Publishing Engine web service, you had to provide the Rational Publishing Engine web service WSDL URL in the Preferences window. To make use of load balanced Rational Publishing Engine Web Service, you must configure the Rational Publishing Engine client with the gateway entry, which is a new URL. You can then publish documents using the load balancer or using the existing web service instance. The server which provides the load balancing returns a URL that has the address of the web service either in the first or second instance of the Rational Publishing Engine web service. When the Rational Publishing Engine client sends the request to this URL, the requests goes through the load balancer and the Rational Publishing Engine client receives the address of the Rational Publishing Engine web service node that the load balancer has assigned. All further communication for that document generation session occurs directly with the assigned web service.

This new URL, for example http://server:port/rpe/wsgate, which provides a gate to the Rational Publishing Engine web service, can also be used outside of the load balancer environment. The URL redirects the Rational Publishing Engine to the web service URL from the same server. The standard web services can run in WebSphere Application Server as well as Apache Tomcat.

Note: The configuration in the load balancer must use URLs that are visible and can be resolved from all of the client machines that use Rational Publishing Engine. The local node must be visible and accessible from the Rational Publishing Engine client.

Procedure

  1. Click Window > Preferences > RPE > Engine Preferences.
  2. Select Local or Remote. Local is the default selection.
  3. If you selected Remote, enter the Web service address URL to the Rational Publishing Engine Web Services. For example: http://server:port/rpe/services/RPEService?wsdl
    1. To set load balancing: In the Web service address field, type the following URL http://server:port/rpe/wsgate. This URL is the entry point for the load balancer. The server which provides the load balancing returns a URL that has the address of the web service either in the first or second instance of the Rational Publishing Engine web service.
  4. To log detailed system processes for troubleshooting purposes, in the RPE core debug mode field, select Yes.
  5. Click OK to save the changes.

What to do next

For more information on Rational Publishing Engine core debug mode, see Log files.

Feedback