Version 95.1 by Pascal Robert on 2009/07/03 13:12

Show last authors
1 Hudson is a build server that takes the chore of the building and can do it automatically, based on all kinds of variables.
2
3 The complete introduction has been show on wowodc-west in 2009.
4
5 There are a couple different ways to run Hudson. The easiest is to run it as a standalone application.
6
7 === Standalone Installation ===
8
9 {{info}}
10 These instructions are based on David Avendasora's setup. You may have different preferences as to where to install Hudson at or where to set its home directory to.
11 {{/info}}
12
13 1. Create a /Developer/Hudson/Home directory
14 1. Download Hudson From [[http://hudson.dev.java.net]]. Save the hudson.war file to /Developer/Hudson
15 1. Launch Hudson with the following command in Terminal.app:
16
17 {{code}}
18
19 java -DHUDSON_HOME=/Developer/Hudson/Home -jar /Developer/Hudson/hudson.war &
20
21 {{/code}}
22
23 1. Point your browser to: http:~/~/localhost:8080/hudson
24 1. Start setting up jobs!
25
26 === Servlet Container Installation ===
27
28 1. Install Tomcat from [[http://www.macports.org]] with the command
29
30 {{noformat}}
31
32 sudo /opt/local/bin/port install tomcat6
33
34 {{/noformat}}
35
36 1. Create an administrative user in /opt/local/share/java/tomcat6/conf/tomcat-users.xml (20 mins to find out where the user should be and how not to restart tomcat). Something along the line of:
37
38 {{code value="xml"}}
39
40 <?xml version='1.0' encoding='utf-8'?>
41 <tomcat-users>
42 <role rolename="manager"/>
43 <role rolename="admin"/>
44 <user username="tomcat" password="tomcat" roles="admin,manager"/>
45 </tomcat-users>
46
47 {{/code}}
48
49 {{panel bgColor="#F7D6C1"}}
50
51 Don't forget to change the username and password after you have finished checking out the build server and start using it in production.
52
53 {{/panel}}
54
55 1. Start tomcat
56
57 {{noformat}}
58
59 sudo launchctl load -w /Library/LaunchDaemons/org.macports.tomcat6.plist
60
61 {{/noformat}}
62
63 1. download Hudson from [[http://hudson.dev.java.net]], take care that you use the contextual menu to download the link hudson war file
64 1. create a folder /opt/local/var/db/hudson (this will be the place where hudson will store it's stuff
65 1. change ownership of that folder with ownership //www:_www//
66 1. add to /opt/local/share/java/tomcat6/conf/setenv.local:
67
68 {{noformat}}
69
70 export HUDSON_HOME=/opt/local/var/db/hudson
71 export JAVA_OPTS=-Djava.awt.headless=true
72
73 {{/noformat}}
74
75 1. Install Hudson in Tomcat: goto [[http://localhost:8080]], login with the user and password that you have created in the tomcat-users.xml, and upload hudson.war to the tomcat server.
76 1. Goto [[http://localhost:8080/hudson]] and you can start configuring your Hudson build server
77
78
79 === Building WO Apps ===
80
81 * Check out [[^setupWorkspace.sh]]