Use the Preference page to specify a local or remote installation,
the location of the template library, the preview preferences, and
the Document Studio preferences.
About this task
You can configure the following properties from the preference
window:
- Engine preferences: Defines IBM® Rational® Publishing Engine engine remotely. By default, the local Rational Publishing Engine engine is used. Specify a remote installation with the
URL to the Rational Publishing Engine Web Services.
- Load Balancer: 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.
Earlier,
the only way to publish documents using IBM Rational Publishing Engine web service was to provide the IBM Rational Publishing Engine WebService WSDL URL in the Preferences window. To make use of load balanced IBM Rational Publishing Engine WebService, you need to configure the IBM 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
will return a URL that has the address of the web service either in
the first or second instance of the IBM Rational Publishing Engine web service. When IBM Rational Publishing Engine client sends the request to this URL, the requests goes
through the load balancer and the IBM Rational Publishing Engine Client will receive the address of the IBM Rational Publishing Engine WebService node that the load balancer has assigned. All
further communication for that document generation session occurs
directly with the assigned webservice.
This
new URL, for example http://localhost/rpe/wsgate which provides a gate to the Rational Publishing Engine web service can also be used outside the load balancer
environment. It will redirect the Rational Publishing Engine to the web service URL from the same server. The standard
web services can run in Websphere as well as Apache.
Note: The
configuration in the load balancer must use URLs that are visible
and can be resolved from all the client machines that use the Rational Publishing Engine. The local node, be visible and accessible from the Rational Publishing Engine client.
- Library locations: The template library is stored in the application's
preferences. Initially, the library locations are the example folders
from the installation folder. The library location can be folders
on the file system (local computer or shared network drive) or a URL
to an XML file that contains the library description.
- Preview preferences: The preview preference option controls the
maximum number of elements per query when running a preview.
- IBM Rational Publishing Engine Document Studio: You can synchronize the document specification
with the current template, change the way the palette works in the
template, use schema annotation for display.
Procedure
- To specify a remote installation:
- In the Preferences window, in the
left pane, expand the RPE tree, and then select Engine
preference. By default, the local RPE engine is selected.
To specify a remote engine, select Remote Engine.
- In the Web service address field,
type the URL to the web service. For example, http://machine:8080/rpe/services/RPEService?wsdl.
Contact your system administrator to get the URL for the web
service. Try the URL in a browser first. If the WSDL (XML format)
is loaded, use that value.
- To set the library locations:
- In the Preferences window, in the
left pane, expand the RPE tree, and then select Library Locations.
- In the right pane, click New to
specify the new library location.
- In the Select Library Locations window, type the path. If you do not know the path, click Browse to folder or Browse to file to select the library path. You can also specify the URL to an XML
file.
- Click OK to return to the Preferences
window.
To edit the library locations, click Remove, Up, Down.
- To set the preview preferences:
- In the Preferences window, in the
left pane, expand the RPE tree, and then select Preview
Preferences.
- In the right pane, specify the number of elements you
want to see in the Query results limit field.
- Click OK to return to the Preferences
window.
Note: Preview Current Document using remote document generation ignores the Query results
limit set in Preview Preferences. The result is the same as running a normal document generation
(all data is included).
- To set Document Studio preferences:
- In the Preferences window, click RPE Document Studio.
- In the right pane, set the following preferences:
- Select Yes or No to Keep the
document synchronized with the current template?
- Select Yes or No to Keep the
palette tool selected after insertion in template?
- Select Yes or No to Use schema
annotations for display.
- Select System default, Left to right or Right to left for Default text direction.
- Select Yes or No to Show template
element content in Outline window.
- Select Default (3 pixels) or Custom (in pixels) to define Studio template element padding (suggested
size 2-10).
- To set the color theme:
- In the Preferences window, in the
left pane, expand the RPE tree, and then select Color Preferences.
- In the right pane, expand Simple (active) and Gray. Select the elements with the associated
color and click OK.
- To set page width preferences for the Rational Publishing Engine editor:
- In the Preferences window, in the
left pane, expand the RPE tree, and then select Page Width
Preferences.
- Select default (automatic) to
retain the default page width settings or select Custom
(in pixels) and add the required Page width
size.
- To define the text direction and the preferred location
of the output file dialog:
- In the Preferences window, in the
left pane, expand the RPE tree, and then select RPE Launcher.
- Select the required option under Default
text direction to determine the direction of the text.
Select Last location or Specific
location and locate the preferred location path. Click OK.
- To specify the client set up for the Monitor and Control
servlet:
- In the Preferences window, in the
left pane, expand the RPE tree, and then select Monitor
Preferences. Enter the URL in the Monitor URL field to access the Monitor and Control servlet in the client. The
URL is <base>/rpemc/service, where <base> is the URL to the
server running RPE MC, such as http://localhost:8080.
- Add the RPEMC client User name and Password.
Note: The URL for
the Monitor and Control servlet must be set for both the Rational Publishing Engine Launcher and Rational Publishing Engine Document Studio. Also to complete the server side set
up, make sure the web service address is specified. See Step 1.
- To set Load Balancing: In the Web service
address field, type the following URL http://localhost/rpe/wsgate. This URL is the entry point for the load balancer. The server
which provides the load balancing will return a URL that has the address
of the web service either in the first or second instance of the Rational Publishing Engine web service.