IBM Support

How to set up an RDz help system with a proxy

Technote (FAQ)


How do you set up an IBM Rational Developer for System z (RDz) help system when a proxy is involved?


The use of proxies for the Rational Developer for System z help system is not documented in the Rational Developer for System z information center.



You can either set up an internal server that hosts the information Center, or install the help content locally on each client workstation.

For more information on installing the help content locally, review the Configuring help content in the Eclipse client topic in the information center.

If using proxies is required, you can access the proxy configuration page by:

  1. Configure Rational Developer for System z to use Local help
  2. Access the Local Help Updater (Help > Local Help Updater)
  3. Change the last part of the URL in the browser window
    • From: http://server:port/help/updater/updatewar.jsp
    • To: http://server:port/help/updater/proxy.jsp
    This displays the Network Connections page that you can use to configure your network proxy settings.

    On the Network Connections page, enter your proxy server information.

    Active Provider - Specifies the settings profile to be used when opening connections as follows:
    • Direct provider, all of the connections are opened without using a proxy server
    • Manual setting, the settings that are defined in the help WAR file are used
    • Native provider, the settings that were discovered in the operating system are used. (only available on some platforms)

    The default is Native, if present (Manual, otherwise).

    Proxy entries - The Proxy entries are available for all of the providers. The check boxes in the first column indicate entries that are to be used for the currently selected provider.

    When you use a Manual proxy provider, you configure settings for three predefined schemas:

    Schema Default port
    HTTP 80
    SSL 443
    SOCKS 1080

    To edit settings for a particular schema, double-click the entry or select the entry, and then click Edit. If you leave the Port field blank, the default port number is used.

    Proxy bypass - Use the Proxy bypass to specify, either by name or pattern, which hosts must not use a proxy. A direct connection is always used for matching hosts. The check boxes in the first column indicate entries that are to be used for the currently selected provider.

    Note: The SOCKS proxy support in Java 1.4 has limitations. Because of these limitations, when a Java virtual machine(VM) 1.4 is used, the SOCKS system properties are not set. The SOCKS proxy might still be used by tools such as CVS when running on a 1.4 VM. However, full SOCKS proxy support, requires a 1.5 (or 5.0) VM.

    Document information

    More support for: Rational Developer for System z

    Software version: 8.5.1

    Operating system(s): Linux, Windows, z/OS

    Reference #: 1623862

    Modified date: 12 May 2014

    Translate this page: