D-ITG 2.6 GUI 0.91.1 beta

The ITGGUI is a graphical user interface to control the D-ITG (Distributed 
Internet Traffic Generator). It is written in Java and because of that it 
virtuallly supports any plattform D-ITG is and will be ported to. It can be
used to ease configuration, handle the settings and comfortably start and stop 
the D-ITG tools.


Requirements
~~~~~~~~~~~~

Sun Java JRE 1.4 or later      http://www.javasoft.com/
D-ITG platform version 2.6     http://www.grid.unina.it/software/ITG/
Windows 98-Vista or Linux (any current)


Installation
~~~~~~~~~~~~
Unpack the ZIP file to a directory. For comfort you should use the same 
directory for the ITGGUI and the D-ITG platform files.


Usage
~~~~~
Windows: You must have administrative privileges in order to use all 
options. On newer Java versions, JAR files are already assigned to 
start with the Java. If it doesn't start from the Explorer your can 
also use the command prompt. 

- Open a command prompt and change to the directory, where you copied
  the JAR file.

  cd <program directory>

- Start the ITGGUI

  javaw -jar itggui.jar


Linux: You must have root privileges in order to use all options. Use the 
following commands in a terminal window.

  cd <program directory>
  
  javaw -jar itggui.jar


FAQ - Frequently Asked Questions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Q: Why are some directory settings in red

A: A red background of a text field in general indicates a wrongly entered
   text or value. For a directory this usually is because the directory 
   cannot be found or the use is rejected by operating system permission. 
   Try to use the folder dialog usually next to the text field.
   Also please mind, that some fields are updated only if you select a 
   different text field or press enter in the current one.


Q: The sender seems to do nothing and hangs

A: There was an issue with the ITGSend binary in version 2.6.1b, which 
   resulted the sender to hang during name resolution. Please upgrade to
   D-ITG 2.6.1c where this has been fixed.


Q: When using the Logger, and setting the Remote Receiver Log 
   to go to my Logger Server, the file ends up in the "Binary 
   Directory" instead of the "Logging Directory".
   
A: The think is, that I don't know, on which operating system the remote 
   logger and receiver runs or which directories exists. For that reason I 
   decided to keep that entry relative to the current directory, were the 
   binary exist. The logging directory is only for the local logging.
   
   
Troubleshooting
~~~~~~~~~~~~~~~
Help me to find bugs. If you encounter problems with the D-ITG using the 
GUI, please try to figure out, if it is related to the D-ITG software or 
the GUI. You can copy the command line from the GUI under the Messages tab 
and execute directly on the command line. If it works, it is related to the 
GUI. In this case, get in contact with me.

If the GUI doesn't start at all, or crashes during operation, please start 
the GUI from the command line as explained above and email the textual output 
to me. If the software doesn't behave as expected, also check for messages in 
the Messages tab. Some GUI errors are logged there together with error 
messages send from the ITG programs. If it seems to be a GUI problem, select 
and copy all messages and email me.

I can't provide much support for the D-ITG platform, although we are in close 
contact. Please refer to the authors on issues related to their software. For 
more information about the D-ITG software please see the documentation on the 
D-ITG website (http://www.grid.unina.it/software/ITG/).


Contact
~~~~~~~

Volker Semken <mailto:volker@semken.com>
