Gentoo Wiki



How To Install Cruise Control


Cruise Control is a tool used to make automated compilation on a project in development. I will complete this page during my personnal installation of this tool on my gentoo x86 server. Cruise Control can checkout sources of a CVS or Subversion repository. Cruise Control uses an ANT script system compilation tool. Image:cc-arch.png


Cruise Control requires Java (blackdown-jre or sun-jre) ANT(dev-java/ant) You can use Cruise Control with Trac by Trac Plugin, Eclipse Eclipse Plugin, CVS, Subversion. You probably need to compile Cruise Control so emerge sun-jdk or blackdown-jdk.


I didn't find an ebuild so you will have to download the sources on Official Web Site. unzip cruise control source.

And build it by using this script: CruiseControlFolder/main/

Now you can try to run cruise control by running CruiseControlFolder/main/bin/

You can move your cruise control to /usr/share/cruisecontrol mv YourCruiseControlFolder /usr/share/cruisecontrol

and link it in /usr/bin ln -s /usr/share/cruisecontrol/main/bin/ /usr/bin/cruisecontrol


a) Create a working area for cruise, eg

 mkdir /work
 mkdir /work/cruise
 export WORK_DIR=/work/cruise

b) Now create the following subdirectories:

mkdir $WORK_DIR/checkout this is where cruise checks out your project from repository (CVS/SVN/VSS). (ClearCase users do not need this folder - you will check out items from your ClearCase view.)

mkdir $WORK_DIR/logs this is where cruise will write its build reports into.

mkdir $WORK_DIR/artifacts this is where cruise can put any build output files that need to be kept.

c) Create $WORK_DIR/config.xml, like so:


Project Setup

This is an example of a configuration using Subversion. You have to add your project into config.xml into <cruisecontrol></cruisecontrol>

  <project name="build-TimeBreach-Dev">
     <svnbootstrapper file=""/>
     <antbootstrapper antscript="/usr/bin/ant"
   <modificationset quietperiod="10">
     <svn LocalWorkingCopy="checkout/dev/softwares" RepositoryLocation=""/>
   <log dir="logs/TimeBreach-Dev"/>
       <currentbuildstatuslistener file="logs/TimeBreach-Dev/buildstatus.txt"/>
   <ant antscript="/usr/bin/ant"

You need to checkout your project into WORK_DIR/checkout folder cd WORK_DIR/checkout

svn co this command will create dev folder into checkout folder.

This example compiles sources through the use of an ant script. The ant script is called build.xml and must be located in the base directory.

More information about config.xml and plugins may be obtained from [1]

Launch it

You can start cruise control by using cd YOUR_WORK_DIR and cruisecontrol

Retrieved from ""

Last modified: Sat, 27 Sep 2008 07:07:00 +0000 Hits: 9,748