JDistUnit version 0.1.0 (released 2009/Q4) is available from Sourceforge.

Archive Content

The distribution consists of a single jdistunit.zip, with the following content:

jdistunit.zip content

The only folder is res (resource), containing two subfolders: config, which holds a policy file for the Java security manager (you will never need to touch this), and lib, which contains the jdistunit.jar and the required libraries (only agentopia.jar). For your convenience, the libraries each have an accompanying -src.jar archive.

The remaining files are start scripts for test servers: One with GUI (useful for Windows and other GUI driven OS), and start/stop scripts for a Linux daemon (you must be root to run these), which write output to log files.

Starting the Server

For the purpose of JDistUnit, the "server" is considered to be the test servers that will access the target system, and the "client" is your developer machine, where you work within your IDE (e.g. Eclipse or Netbeans).

Unzip the jdistunit.zip archive on each of your servers and doubleclick run_jdistunit_gui.sh. A window will open to show log messages. Starting the server will occupy port 15907 on each server.

Starting the Client (in your IDE)

All the client starting will be done in Java within your test source code. As the client, you do not need the policy_all.ini file, and no special setup is necessary.

Start your favourite IDE, and copy jdistunit.jar and agentopia.jar to a location of your choice. Then, add both to your classpath. That is the entire "installation".

To run a JDistUnit test, you will need an ITestBox instance -- I recommend learning more about it in the documentation section.