The Kato project is built by Hudson on demand. See here http://hudson.zones.apache.org/hudson/view/Kato/ for build status.

How to build the main project

It's assumed you have ant,maven 2, subversion and java installed on your machine

There are three major projects which can be checked out. (See BuildStatus for more details)

Using the command line

(if you intend to build the native or eclipse plugins make sure your local maven settings look similar to this)

1. in a suitable directory check out the whole of the trunk
   svn co http://svn.apache.org/repos/asf/incubator/kato/trunk kato
2. enter the new directory
   cd kato
3. enter each project as required and build
   cd org.apache.kato
   mvn install
   cd ../org.apache.kato.native/
   mvn install{{monspaced
   cd cd ../org.apache.kato.eclipse/
   mvn install

Its likely that you'll have issues with the native and/or eclipse portions as this is all new.

The main project is 100% Java 6 so should build for everyone everytime.

Using Eclipse

This is a guide to setting up Maven and Eclipse, as some of the projects are Eclipse plugins.

1. First of all install Maven2 from here http://maven.apache.org/
2. Download and install Eclipse 3.4 (IDE for Java Developers) from http://www.eclipse.org/downloads/
3. Copy from your Eclipse/plugins directory the file "org.eclipse.equinox.launcher_*.jar" to startup.jar in your eclipse directory.
4. In "${user.home}/.m2/settings.xml" the property "kato.eclipseinstall" will need to be set with the location of startup.jar. See settings.xml as an example. This is required so that the plugin build knows where it is - this should be unnecessary once the Maven eclipse plugin process is updated for more recent eclipses.
5. After installing Eclipse, select "Help -> Software Updates -> Available Software" and enter the following URLs into the dialogue box "Add Site..." brings up. You'll have to do this once for each URL:
   • http://download.eclipse.org/technology/subversive/0.7/update-site/
   • http://download.eclipse.org/technology/subversive/0.7/headless-update-site/
   • http://www.polarion.org/projects/subversive/download/eclipse/2.0/update-site/
   • http://www.polarion.org/projects/subversive/download/integrations/update-site/
6. Then select the following components for installation:
   • Java Development -> Eclipse Plugin Development Environment
   • Maven Integration
   • Maven Optional Components -> Maven SCM Integration
   • Subversive SVN Team Provider Plugin -> Subversive SVN Team Provider
   • Subversive Integration Plugins -> Subversive Integration for the M2Eclipse Project
   • Subversive SVN Connectors -> as appropriate for you.
7. Then select the Install button. You will have to restart Eclipse.
   #
8. You should now be ready to checkout the code. Select New -> Other -> Maven -> Checkout Maven Projects from SCM
9. Press Finish and wait. The checkout will being and Maven will start. The build will be unsuccessful.
10. Go to the "kato" project in your workspace in a command shell.
11. Type "mvn clean"
12. Then "mvn install"
13. Go to Eclipse and Refresh the builds. The errors should go away.

There are still known problems:

1. subversion updates often don't work - the maven builds generate files. The generated files should be excluded from version control - this hasn't been done yet. The project is best just deleted and checked out again.