Project

General

Profile

How to proxy settings » History » Version 2

Henning Blohm, 27.03.2014 16:26

1 1 Henning Blohm
h1. How to proxy settings
2
3
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).
4
5
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).
6
7
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):
8
9
<pre><code class="ruby">
10
#
11
# alternative VM profiles for the home process
12
# VM opts
13
# default
14
#
15
home.vmopts=\
16
    -Xms32M -Xmx32M -cp z.jar \
17
    -DproxyHost=myproxyhost -DproxyPort=myproxyport \
18
    -Dcom.sun.management.config.file=management.properties \
19
    -Djava.util.logging.config.file=logging.properties \
20
    -Dcom.zfabrik.home.concurrency=5 \
21
    -Dcom.zfabrik.home.layout=environment/home \
22
    -Dcom.zfabrik.home.autoVerifyInterval=600 \
23
    -Dcom.zfabrik.home.attainOperationTimeOut=300000 \
24
    -Dcom.zfabrik.dev.local.workspace=../../.. \
25
    -Dcom.zfabrik.dev.local.repo=../../work/repos/dev
26
   
27
   
28
# override when -mode debug
29
home.vmopts.debug=-Xdebug -Xnoagent -Xrunjdwp:transport=dt_socket,suspend=n,server=y,address=5000 -Dworker.debug=true
30
31
# override when -mode verbose
32
home.vmopts.verbose=-verbose:gc -XX:+PrintClassHistogram
33
</code></pre>
34 2 Henning Blohm
35
h2. Proxy Authentication (#1442)
36
37
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
38
39
<pre><code class="ruby">
40
#
41
# alternative VM profiles for the home process
42
# VM opts
43
# default
44
#
45
home.vmopts=\
46
    -Xms32M -Xmx32M -cp z.jar \
47
    -DproxyHost=myproxyhost -DproxyPort=myproxyport \
48
    -DproxyUser=proxy_user -DproxyPassword=proxy_password \
49
    -Dcom.zfabrik.proxy.auth=BASIC \
50
    -Dcom.sun.management.config.file=management.properties \
51
    -Djava.util.logging.config.file=logging.properties \
52
    -Dcom.zfabrik.home.concurrency=5 \
53
    -Dcom.zfabrik.home.layout=environment/home \
54
    -Dcom.zfabrik.home.autoVerifyInterval=600 \
55
    -Dcom.zfabrik.home.attainOperationTimeOut=300000 \
56
    -Dcom.zfabrik.dev.local.workspace=../../.. \
57
    -Dcom.zfabrik.dev.local.repo=../../work/repos/dev
58
   
59
   
60
# override when -mode debug
61
home.vmopts.debug=-Xdebug -Xnoagent -Xrunjdwp:transport=dt_socket,suspend=n,server=y,address=5000 -Dworker.debug=true
62
63
# override when -mode verbose
64
home.vmopts.verbose=-verbose:gc -XX:+PrintClassHistogram
65
</code></pre>