Installing Hudson and Connecting to CVS Part 2

Hudson is an Open Source application used to monitor executions of repeated jobs such as building a software project. Hudson provides an easy-to-use continuous integration system to make it easier for developers to integrate changes to their projects, and to make it easier for users to obtain a fresh build. These are the steps of setting up Hudson using CVS on a Windows System for a Java project. However, Hudson can also be used to .Net projects as well. These installation instructions work for version 1.337 of Hudson, and we will be using Ant version 1.7.

1) You will need to download the War file from this website: http://hudson-ci.org/

2) You should already have Java Installed. If you don't, you should install it. To verify your Java version on a Windows System, you can open a command prompt and type: java -version. You should have Java 1.5 or greater.

3)Open a command prompt and navigate to the directory containing the downloaded hudson.war file. If you want to run Hudson with the default configurations, issue the following command:
java -jar hudson.war

To change the directory Hudson works from and the port that Hudson runs on, use this command:

java -DHUDSON_HOME=<dir> -jar hudson.war --httpPort=<port>

4) If you installed Hudson on the default port, you should be able to see it by visiting this URL: http://localhost:8080/ If you change the port number, modify 8080 to your new port number.

5) To install Hudson as a service, you should open Hudson and select Manage Hudson. You should see a link to install Hudson as as service. After installing Hudson as a service, you should see hudson listed under your computer management. However, if you changed the port from your default port, you need to do an extra step. You should change the port located in hudson.xml from 8080 to the new port and then restart the service. After installing it as a service, you can close your command prompt that you used to start hudson.

6) Ant is a build script commonly used in Java. If you are using Ant, you will need to set it up to be used with Hudson. You can download Ant from this website. http://ant.apache.org/bindownload.cgi. You should download the most current zip file and unzip it somewhere on your hard drive. These instructions are using ant 1.7.1.

7) You should select Manage Hudson, and Configure System. Under the Ant Section, you should put a name which will represent the version of this ant. You should input the ANT_HOME variable as a path like this: C:\apache-ant-1.7.1 This path is the path to the ant installation you downloaded already.

8) You should download the cvs.exe file from the related assets and place the file under your Windows/System32 folder.

9) create a .cvspass file by typing echo ":pserver:login@192.168.0.5:/cvs password" > .cvspass in a command prompt. This is the password file to connect to your cvs repository that you will be using. The login should be your CVS login, the 192.168.0.5 is your CVS ip address, and /cvs is your cvs path and password is the cvs password. Place this file in your HUDSON_HOME directory.

10) Go to Manage Hudson, Configure System and input your CVS information under the CVS section. The cvs executable should read cvs which is the name of your cvs.exe file. You should input the path to your .cvspass file. An example is: /HUDSON_HOME/.cvspass


Go To Part 3