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!
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
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.
- Graphical LOCALDEF-Editor
- Source-Code-Editor with syntax-highlighting
- Result Plotter with many features
|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
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.
- Navigate to the GUI's root directory gui/
- Issue the approriate Ant commands
will display all the targets available together with a short description.
will erase all previous build data including the BenchIT.jar. This must be commented within build.xml to preserve the jar.
will compile all source classes and put the class-files within build/classes .
will update the BenchIT.jar with new compiled classes and new libraries from lib/ .
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
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.