Proxy setup

This topic describes how to configure proxy information on Java Virtual Machines (JVMs).

In most cases, connector's data sources contain their proxy settings. For connectors that do not have a specific proxy setup, you can configure the JVM with additional proxy information.

In this topic:

Configure the proxy for Windows

This section describes how to configure Tomcat to use a proxy server in a Windows environment.

To configure the proxy for Windows:

1. In a command line, go to <Connect_installdir>\WebServer\bin

2. Run tomcat9w //ES/ConnectWebServer

3. Select the Java tab.

4. In Java Options:

   1. Append the following to the arguments list. Enter each statement on a new line:

      -Dhttp.proxySet=true

      -Djdk.http.auth.tunneling.disabledSchemes=""

      -Dhttp.proxyHost=<proxy hostname/ip>

      -Dhttp.proxyPort=<proxy port>

      -Dhttps.proxyHost=<proxy hostname/ip>

      -Dhttps.proxyPort=<proxy port>

      Note: All of the above statements are mandatory for proper proxy functionality.

   2. If the proxy requires authentication, also append the following:

      -Dhttp.proxyUser=<proxy username>

      -Dhttp.proxyPassword=<proxy password>

      -Dhttps.proxyUser=<proxy username>

      -Dhttps.proxyPassword=<proxy password>

   3. If the proxy authentication is basic, append:

      -Djdk.http.auth.proxying.disabledSchemes=""

   4. To exclude particular hosts from being proxied, append:

      -Dhttp.nonProxyHosts=*.opentext.com

   5. To exclude multiple hosts, use the pipe separator:

      -Dhttp.nonProxyHosts=*.opentext.com|*.example1.com|*.example2.com

      Note: We recommend not relying only on wildcards as they may not be evaluated accurately. Use the complete hostname, for example: -Dhttp.nonProxyHosts=octane.microfocus.com|*.microfocus.com|*.example1.com|*.example2.com

5. Click Apply.
6. Select the General tab.
7. Click Stop.
8. When enabled, click Start.

Back to top

Configure the proxy for Linux

This section describes how to configure Tomcat to use a proxy server in a Linux environment.

To configure the proxy for Linux:

1. Open the setenv.sh file in the <Connect_installdir>\WebServer\bin folder.

2. Add the following lines, and replace the IP and port numbers with those of your proxy servers:

   Copy code

   JAVA_OPTS="$JAVA_OPTS -Dhttp.proxySet=true"
   JAVA_OPTS="$JAVA_OPTS -Djdk.http.auth.proxying.disabledSchemes=\"\""
   JAVA_OPTS="$JAVA_OPTS -Djdk.http.auth.tunneling.disabledSchemes=\"\""
   JAVA_OPTS="$JAVA_OPTS -Dhttp.proxyHost=192.168.0.10"
   JAVA_OPTS="$JAVA_OPTS -Dhttp.proxyPort=1234"
   JAVA_OPTS="$JAVA_OPTS -Dhttps.proxyHost=192.168.0.10"
   JAVA_OPTS="$JAVA_OPTS -Dhttps.proxyPort=1234"
   

   Note: All of the above lines are mandatory for proper proxy functionality.

3. To exclude internal hosts from the proxy policy, add the following line with internal host or IP list, separated by the | symbol:

   Copy code

   JAVA_OPTS="$JAVA_OPTS -Dhttp.nonProxyHosts=\"*.example1.com|*.example2.com|127.*|[::1]|localhost\"" 
   

4. Restart the Tomcat server.

Back to top