Development Tools

From BenchIT-Wiki

Jump to: navigation, search

Several build tools are used by the BenchIT project, which will be explained here.

Contents

Version Control Systems

Our version control server is hosted at TU Dresden, and is only reachable by authorized people - that said, there is no anonymous or guest access to CVS or SVN. Weekly snapshots can be found at our projects [Download Section].

CVS

CVS is used for historical reasons to manage development. However, the website has switched to svn since quite a while, so only the Core and GUI components are actively developed using CVS.

SVN

We're in the process of switching the development to subversion and a new repository is beeing built around the new stable release. For internal development, there are also several website and server repositories.

  • svn+ssh://rupert.zih.tu-dresden.de/svn-base/benchit-root/stable-v6
  • svn+ssh://rupert.zih.tu-dresden.de/svn-base/benchit-root/benchit-web
  • svn+ssh://rupert.zih.tu-dresden.de/svn-base/benchit-root/benchit-server

Ant Build Scripts

Currently, there is only one Ant build script located at

  • gui/build.xml

GUI's build.xml

This Apache Ant script is used to manage the complete build process of the BenchIT-GUI. For an easier start, there is a help target, that will be executed, when no options are given to ant.

To use this script, either set up an eclipse or netbeans external tool script and configure it, or use Apache Ant from the command line.

  1. Navigate to the GUI's root directory gui/
  2. Issue the approriate Ant commands

Usage:

ant

will display all the targets available together with a short description.

ant clean

will erase all previous build data including the BenchIT.jar. This must be commented within build.xml to preserve the jar.

ant compile

will compile all source classes and put the class-files within build/classes .

ant pack.up

will update the BenchIT.jar with new compiled classes and new libraries from lib/ .

ant pack.noup

will regenerate the BenchIT.jar from scratch and include all jar from the lib/ directory.


The three bcc.* targets are used to regenerate the Apache Axis2 client classes. Instructions for doing so can be found by calling

ant bcc.help

In order to recreate the web service client classes, a fully installed Apache Axis2 distribution is needed on the local machine.

Notes

The compile target is set to create Java 1.4 compatible class files, but in order to do so, Ant must be running on a Java 1.4 JDK. The easiest way is to get and unpack IBM's or Sun's JDK 1.4 and use the JAVA_HOME environment variable to call ant:

JAVA_HOME=/usr/lib/jvm/java-1.4.2-sun ant help

In addition, you can tell ant to print out debugging informations to see which Java version will be used.

ant -d