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>

   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. Create a file named setenv.sh in the <Connect_installdir>\WebServer\bin folder.

2. Add the following lines:

   Copy code

   export "CATALINA_OPTS=-Dhttp.proxySet=true"
   export "CATALINA_OPTS=$CATALINA_OPTS -Djdk.http.auth.proxying.disabledSchemes=\"\""
   export "CATALINA_OPTS=$CATALINA_OPTS -Djdk.http.auth.tunneling.disabledSchemes=\"\""
   export "CATALINA_OPTS=$CATALINA_OPTS -Dhttp.proxyHost=192.168.0.10"
   export "CATALINA_OPTS=$CATALINA_OPTS -Dhttp.proxyPort=1234"
   export "CATALINA_OPTS=$CATALINA_OPTS -Dhttps.proxyHost=192.168.0.10"
   export "CATALINA_OPTS=$CATALINA_OPTS -Dhttps.proxyPort=1234"
   export "CATALINA_OPTS=$CATALINA_OPTS -Dhttp.nonProxyHosts=\"*.example1.com|*.example2.com\""
   

3. In the above lines, replace the IP and port numbers with those of your proxy servers. If required, update the nonProxyHosts list.

4. Restart the Tomcat server.

Back to top