3.5. Building BELTS

To build BELTS you'll need the source. This can be obtained by following the links at the BELTS SourceForge site. Provided you have CVS installed anonymous CVS access is probably the best way to get the source. If you're unsure how to use CVS, there is plenty of documentation on the Sourceforge site.

cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/belts login
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/belts co -d belts belts-all

Once you've downloaded or fetched the source, you should have a directory that looks something like this.

[kevin@titus belts]$ ll
total 48K
drwxrwxr-x    6 kevin    kevin        4.0K Aug 15 10:25 build
drwxrwxr-x    6 kevin    kevin        4.0K Aug 15 10:25 components
drwxrwxr-x    6 kevin    kevin        4.0K Aug 15 10:25 ejb
drwxrwxr-x    4 kevin    kevin        4.0K Jul 21 14:02 mock
drwxrwxr-x    6 kevin    kevin        4.0K Aug 15 10:25 model
drwxrwxr-x    6 kevin    kevin        4.0K Aug 15 10:25 store
drwxrwxr-x    4 kevin    kevin        4.0K Jul 24 14:33 test
drwxrwxr-x   17 kevin    kevin        4.0K Aug 15 10:06 thirdparty
drwxrwxr-x    6 kevin    kevin        4.0K Jun 12 11:45 tools
drwxrwxr-x    5 kevin    kevin        4.0K Aug 15 10:26 web
[kevin@titus belts]$
            

You'll also need a local copy of JBoss. This must be version 3.2.0. No other version will work. Unpack the distribution and put it in a directory named jboss.

Copy build/etc/local.properties-example to build/local.properties
[kevin@titus belts]$ cp build/etc/local.properties-example build/local.properties
Edit build/local.properties using the text editor of your choice. At the bottom of this file is a property belts.package-path. Set this to the directory containing the jboss directory created earlier.

#
# Root Path for Thirdparty Packages
#
belts.package-path=/home/kevin/tools
            

Now all you have to do it build it using build/build.sh on Linux or build/build.bat on Windows. The output should start something like this:
[kevin@titus belts]$ ./build/build.sh
Searching for build.xml ...
Buildfile: /home/kevin/projects/belts/build/build.xml
and end something like this:
main:
 
BUILD SUCCESSFUL
Total time: 39 seconds
[kevin@titus belts]$
            

If you have any problems building BELTS, the best place to go for advice and help is the BELTS SourceForge site and the belts-developers mailing list.