Setting the remote services preferences

Enter the URL and authentication details for remote document generation, monitor and control, and Central Management component in the remote services preferences.

About this task

If a Remote services application URL was entered during installation, the URL cannot be edited from the Remote services preferences.

Procedure

  1. Click Window > Preferences > RPE > Remote Services.
  2. Specify the URL and credentials for connecting to the Remote services application through one URL or multiple URLs to each component.
    Use one URL when:
    • Your organization is using all of the Remote services components including Remote document generation, Monitor & Control, Central management, and Report scheduling, on the same server.
    • The administrator controls the setting of this URL during the installation of the client applications.
    Use individual URLs when:
    • Your organization is using several or all of the Remote services components, but they are deployed on different servers.
    • Your organization is not using the Central management component. Performance improves when Rational® Publishing Engine does not make multiple attempts to connect to the Central management component.
    • You can enter the URL and credentials one time for all of the Remote services components in the RPE Web services section. If separate user credentials are not entered for each service, the master credentials entered for the Remote services application are used for all services. URL example: http://server:port/rpews
    • You can specify each individually by selecting the check box and entering the details.

      • Remote document generation: The URL to generate documents remotely on another computer.
        • Secured example: http://server:port/rpews/docgen
        • Unsecured example: http://server:port/rpews/idocgen
        Attention: When you set the remote document generation URL, the Monitor & Control service on the same server is used. The URL that is entered for the Monitor & Control component is ignored. Example: If the remote document generation URL is http://server1:8080/rpews/docgen, then the job displays in the Monitor & Control component on http://server1:8080/rpews/ui/monitor.html.
      • Monitor and control: The URL to the Monitor & Control component where your document generation jobs can be managed by an administrator. Example: http://server:port/rpews/monitor
        Remember: The Monitor & Control component URL entered here can only be specified for local document generation jobs. For remote document generation jobs, the Monitor & Control component that is on the same server as the remote generation application is used, and then the URL for the Monitor & Control component entered here is ignored.
      • Central management: The URL to the Central Management component where you can access reusable assets for your organization when you are designing templates. Example: http://server:port/rpews/library
        CAUTION:
        The central management URL must be in the format: http://server:port/rpews/library.

        DO NOT enter the URL for the central management administrative user interface: http://server:port/rpews/ui/library.html.

      • Report scheduling: The URL to the Report scheduling component where you can schedule remote document generation jobs to run at specific times or intervals. Example: http://server:port/rpews/scheduler
  3. Specify the Maximum number of times to retry if the service is unavailable. This field controls the number of times that Document Studio and Launcher will attempt to access the Remote service if it is unavailable. You can decrease this value to improve performance of Document Studio and Launcher.
  4. Click OK to save the changes to the preference.

What to do next

If you entered URLs for remote document generation, also set the Remote generation preference to Yes. See Setting the engine preferences.

When remote document generation is enabled, you can switch between local and remote document generations on a document by document basis by toggling the Remote document generation icon.


Feedback