Wiki source code of Installing and Using the Hudson build server
Version 95.1 by Pascal Robert on 2009/07/03 13:12
Show last authors
author | version | line-number | content |
---|---|---|---|
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]] |