Aus BenchIT Wiki
Wechseln zu: Navigation, Suche

How to start

To start the GUI change directory to

  • Windows: cd <BenchIT-folder>\gui\bin
  • Unix/Linux,MacOS: cd <BenchIT-folder>/gui/bin

Now run the file

  • Windows: GUI.bat See GUI-errors nr. 001
  • Unix/Linux,MacOS: ./GUI.sh

When this should contrary to expectations not start, you can try starting the file BenchIT.jar. This can be done by clicking (Windows) or running (all platforms) java -jar BenchIT.jar. Attention: If the flags, set in GUI.[sh|bat] are not set, different features won't work!

What happens when the GUI starts

Now the GUI should be in the LOCALDEF-Mode


The BenchIT-GUI requires at least JAVA 1.4 and in some cases an additional package with aXML-Decoder. A UNIX-System is recommed, but it will also work on Windows.

Restrictions under Windows: No measuring on local system

Also it uses 128 MB of RAM, if you want to use less, change the -Xmx-Option starting script (GUI.sh/GUI.bat).

Command line options

-host=[hostname] for changing the name of the actually host -hostname=[hostname] the same as -host -win for setting windows look and feel (needn't to funktion well) -restart supresses the daily tip after measurement shutdown an shows result tree after restart

First Steps

When starting the BenchIT-GUI for the first time and haven't already written your LOCALDEF-Files, some input-fields will pop-up which asks you for the basic variables.

Most of them must be filled out, but it doesn't take much time. When those questions are answered, the GUI starts.


used packages

Name Website License
jfreechart 0.9.8 http://www.jfree.org LGPL
freehep http://java.freehep.org LGPL
syntax.jedit.org http://syntax.jedit.org BSD-Style
ant tar http://ant.apache.org/ Apache Software License Version 2.0
ganymed ssh2 package http://www.ganymed.ethz.ch/ssh2 BSD-Style

Building the GUI using Ant

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



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.


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