z2-Environment

h1. 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):

<pre><code class="ruby">

#

# 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

</code></pre>

h2. 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

<pre><code class="ruby">

#

# 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

</code></pre>