wiki/ci.md
... ...
@@ -17,6 +17,24 @@ Initially we had trouble with Jenkins and the GIT plug-in. However, https://issu
17 17
18 18
Note, though that the Xvnc plug-in in version 1.16 seems to be causing some trouble (https://issues.jenkins-ci.org/browse/JENKINS-22105). Downgrading to 1.14 helps. The 1.14 .hpi file can be obtained, e.g., here: http://www.filewatcher.com/m/xvnc.hpi.21882-0.html.
19 19
20
+Make sure that the environment used to run Hudson/Jenkins uses a UTF-8 locale. Under Linux, it's a good idea to set the environment variables
21
+<pre>
22
+ export LC_ALL=en_US.UTF-8
23
+ export LANG=us_US.UTF-8
24
+</pre>
25
+which can, depending on how your Hudson/Jenkins is started, be included, e.g., in `/etc/init/jenkins` which then should have a section that looks like this:
26
+<pre>
27
+script
28
+ [ -r /etc/default/jenkins ] && . /etc/default/jenkins
29
+ export JENKINS_HOME
30
+ export LC_ALL=en_US.UTF-8
31
+ export LANG=us_US.UTF-8
32
+ exec start-stop-daemon --start -c $JENKINS_USER --exec $JAVA --name jenkins \
33
+ -- $JAVA_ARGS -jar $JENKINS_WAR $JENKINS_ARGS --logfile=$JENKINS_LOG
34
+end script
35
+</pre>
36
+Other options for setting the locale include adding the LC_ALL and LANG variables to the `/etc/environment` file.
37
+
20 38
The basic idea of setting up a build job is to create a so-called "free-style software project" which then executes our `configuration/buildAndUpdateProduct.sh` script using the `build` parameter. Top-down, the following adjustments to a default free-style job that are required for a successful build are these:
21 39
22 40
* select "Git"