Configuring proxy settings

To access your document library using a proxy, you are required to set preferences both on the Rational Team Concert Client and to the Jazz Team Server.

Configuring the client to work with a proxy

To configure client-side proxy settings:
  1. From the Rational Team Concert application, open Window > Preferences…, and select the General > Network Connections category. The following dialog opens:

    The Network Connections settings dialog in the Rational Team Concert Client.

  2. Select one of the following options:
    • Direct connection to the Internet. Select this option to connect to the Document Site directly, i.e. not through a proxy.
    • Manual proxy configuration. Select this option if you wish to manually define the settings for your proxy server:
      • HTTP proxy. Use this option to specify the server and port to use when making HTTP connections. If the port field is left empty, the default port 80 is used. If the Use this proxy server for SSL check box is selected, the HTTP proxy server is used for SSL connections as well.
      • SSL proxy. Use this option to specify the server and port to be used when making SSL connections. If the port field is empty, the default port 443 is used.
      • SOCKS proxy. Use this option to specify the server and port to be used when making SOCKS connections. If the port field is empty, the default port 1080 is used.
      • No Proxy for. Use this table to specify which hosts should not use any proxy but instead should always be connected to directly.
      • Enable proxy authentication. Enable this option to specify a user name and password to use when connecting to the proxy server.

Configuring the server to work with a proxy

To configure server-side proxy settings:
  1. Create a new text file with the name org.eclipse.core.net.prefs in a directory on the Jazz server, depending on application server:
    • For Apache Tomcat: JazzInstallDir/server/tomcat/work/Catalina/localhost/jazz/eclipse/workspace/.metadata/.plugins/org.eclipse.core.runtime/.settings/
    • For IBM WebSphere Application Server: WASInstallDir/profiles/profile/temp/node/server1/jazz_war/jazz.war/eclipse/workspace/.metadata/.plugins/org.eclipse.core.runtime/.settings/
  2. Paste the following contents to org.eclipse.core.net.prefs and edit it according to you proxy configuration: 
    # General proxy settings
org.eclipse.core.net.hasMigrated=true
eclipse.preferences.version=1
proxiesEnabled=true
# HTTP proxy settings
proxyData/HTTP/host=<proxy hostname>
proxyData/HTTP/port=<proxy port>
proxyData/HTTP/hasAuth=false
# HTTPS proxy settings
# proxyData/HTTPS/host=<proxy hostname>
# proxyData/HTTPS/port=<proxy port>
# proxyData/HTTPS/hasAuth=false
# Hosts that will not use proxy 
# nonProxiedHosts=<hostname1|hostname2|…>
nonProxiedHosts=127.0.0.1|localhost
  3. Restart the Jazz Team Server.
Note: If you issue a server reset request, the proxy settings will be reset as well.
Note: Configuring server-side proxies that require authentication is not supported by Document Collaboration.