Updating JVM configuration settings for proxies
Learn how to add proxy-related Java™ system properties to the Java Virtual Machine in which the on-premises Integration Server runs.
Procedure
-
Depending on your networking and security requirements, you need to set Java system properties that are related to proxy servers. As the connection between
the on-premises Integration Server and webMethods Integration is over HTTPS, set some or all the following properties.
- https.proxyHost
- https:proxyPort
- http:nonProxyHosts
- https.proxyUser
- https.proxyPassword
- You need to set the proxy property values for the Java Virtual Machine (JVM) in which Integration Server runs. Update the custom_wrapper.conf file to help ensure that the proxy parameter values are supplied when the JVM starts.
- Specifically, add a wrapper.java.additional.n property that
specifies the property name and value that you want to pass to Integration Server, where n is a
unique sequence number. Precede the property name by -D.
For example, the wrapper.java.additional properties in the custom_wrapper.conf file look similar to the following.
wrapper.java.additional.204=-Dhttps.proxyHost=YOUR_PROXY_HOST wrapper.java.additional.205=-Dhttps.proxyPort=YOUR_PROXY_PORT wrapper.java.additional.206=-Dhttps.proxyUser=YOUR_PROXY_USER wrapper.java.additional.207=-Dhttps.proxyPassword=YOUR_PROXY_PASSWORD wrapper.java.additional.208=-Dhttp.nonProxyHosts=localhost|127.0.0.1 wrapper.java.additional.209=-DHPROXY=YOUR_PROXY_HOST:YOUR_PROXY_PORT wrapper.java.additional.210=-DHAUTH=YOUR_PROXY_USER:YOUR_PROXY_PASSWORD
For instructions to pass the Java system properties to Integration Server and the JVM used by Integration Server, see the Integration Server Administrator's Guide.
To pass system properties to Microservices Runtime, update the JAVA_CUSTOM_OPTS property in Integration Server_directory /bin/server.bat(sh).
For more information about passing system properties to Microservices Runtime, see the Developing Microservices with webMethods Microservices Runtime document.
If Integration Server uses Java SE Development Kit 8, Update 111 or later and the internet proxy is configured to enforce HTTPS Basic authentication, add the following system properties to custom_wrapper.conf.
- jdk.http.auth.proxying.disabledSchemes
- jdk.http.auth.tunneling.disabledSchemes