How to proxy settings¶

When you are working in an intranet setup it may be required to specify proxy server configuration so that your Z2 installation can reach our repositories (notable by an exception or warning at start up that indicates that our server name could not be resolved).

In that case, go to Z2_HOME/run/bin and open the file launch.properties in a text editor (e.g. notepad on windows). Add the properties proxyHost and proxyPort (and if you have, proxyUser and proxyPassword - which is unlikely).

Your launch.properties file should read similar to this afterwards (but please do NOT copy & paste this fragment! Only add the two properties mentioned (and substitute myproxyhost, myproxyport accordingly):

#
# alternative VM profiles for the home process
# VM opts
# default
#
home.vmopts=\
    -Xms32M -Xmx32M -cp z.jar \
    -DproxyHost=myproxyhost -DproxyPort=myproxyport \
    -Dcom.sun.management.config.file=management.properties \
    -Djava.util.logging.config.file=logging.properties \
    -Dcom.zfabrik.home.concurrency=5 \
    -Dcom.zfabrik.home.layout=environment/home \
    -Dcom.zfabrik.home.autoVerifyInterval=600 \
    -Dcom.zfabrik.home.attainOperationTimeOut=300000 \
    -Dcom.zfabrik.dev.local.workspace=../../.. \
    -Dcom.zfabrik.dev.local.repo=../../work/repos/dev

# override when -mode debug
home.vmopts.debug=-Xdebug -Xnoagent -Xrunjdwp:transport=dt_socket,suspend=n,server=y,address=5000 -Dworker.debug=true

# override when -mode verbose
home.vmopts.verbose=-verbose:gc -XX:+PrintClassHistogram

Proxy Authentication (#1442)¶

Starting with version 2.3 BASIC proxy authentication is supported as well. In order to make use of a built-in Proxy Authenticator set the system property com.zfabrik.proxy.auth=BASIC and specify proxyUser as well as proxyPassword. More specific settings such as http.proxyUser, https.proxyUser etc. are supported as well. The example from above then turns into

#
# alternative VM profiles for the home process
# VM opts
# default
#
home.vmopts=\
    -Xms32M -Xmx32M -cp z.jar \
    -DproxyHost=myproxyhost -DproxyPort=myproxyport \
    -DproxyUser=proxy_user -DproxyPassword=proxy_password \
    -Dcom.zfabrik.proxy.auth=BASIC \
    -Dcom.sun.management.config.file=management.properties \
    -Djava.util.logging.config.file=logging.properties \
    -Dcom.zfabrik.home.concurrency=5 \
    -Dcom.zfabrik.home.layout=environment/home \
    -Dcom.zfabrik.home.autoVerifyInterval=600 \
    -Dcom.zfabrik.home.attainOperationTimeOut=300000 \
    -Dcom.zfabrik.dev.local.workspace=../../.. \
    -Dcom.zfabrik.dev.local.repo=../../work/repos/dev

# override when -mode debug
home.vmopts.debug=-Xdebug -Xnoagent -Xrunjdwp:transport=dt_socket,suspend=n,server=y,address=5000 -Dworker.debug=true

# override when -mode verbose
home.vmopts.verbose=-verbose:gc -XX:+PrintClassHistogram