Release Notes

JT Harness
Version 3.2.2

November 2006

Introduction
Requirements
Launching JT Harness
Differences Between the JT Harness and the JavaTest™ Harness
Known Bugs

Introduction

The JT harness, Version 3.2.2 release is the inital open source distribution. JT harness is based on Sun Microsystem's JavaTest™ harness, version 3.2.2. Typically, JT Harness is redistributed to customers with a test suite that it will execute.

Requirements

JT Harness requires the technologies listed in the following table.

Technology	Where to Get It	Notes
JavaHelp 2.0_01	http://java.sun.com/products/javahelp/	JavaHelp version 2.0_02 may be used, with some limitations: On machines which have two logically separate screens (typically on X11 systems), the help viewer may default to the first screen, which may not be the screen you are running the harness on. In concrete terms, if the harness is on screen :0.1, the help viewer will appear on screen :0.0.
JDK 1.5 (or greater)	http://java.sun.com/javase/index.jsp

Technology

Where to Get It

Notes

JavaHelp 2.0_01

http://java.sun.com/products/javahelp/

JavaHelp version 2.0_02 may be used, with some limitations:

On machines which have two logically separate screens (typically on X11 systems), the help viewer may default to the first screen, which may not be the screen you are running the harness on. In concrete terms, if the harness is on screen :0.1, the help viewer will appear on screen :0.0.

JDK 1.5 (or greater)

http://java.sun.com/javase/index.jsp

Launching JT Harness

You must specify the location of jh.jar and launch JT Harness in one of the following ways:

jh.jar is located in the same directory as javatest.jar
launch via

% java -jar javatest.jar
jh.jar is located in the jre's extension directory (eg <jdk-1.4.2-dir>/jre/lib/ext)
launch via

% java -jar javatest.jar
all jars specified on the classpath
launch via
% java -classpath <javahelp path>/jh.jar:<jtharness path>/javatest.jar com.sun.javatest.tool.Main

Differences Between the JT Harness and the JavaTest™ Harness

The JT harness differs from the JavaTest™ harness, version 3.2.2 in the following ways:

JavaHelp has been unbundled from javatest.jar
The commercial product has JavaHelp bundled in the binary. In JT harness, the binary does not rebundle jh.jar inside of javatest.jar
JavaHelp must be specified when launching JT Harness
You must specify the location of jh.jar and launch JT Harness in one of the specified in the previous section.
Support for serial communications has been removed.
You can not use JT Harness with agents that communicate via a serial port.
Support for servlet reporting has been removed.
You can not use JT Harness to generate reports via servlets.

[Top]

Known Bugs

The bugs listed in the table below are the known bugs of interest to users that remain to be fixed.

BUG ID	DESCRIPTION
known issue	Online Help describes functionality for serial communications This functionality is removed from JT Harness
known issue	Online Help describes functionality for servlet reporting This functionality is removed from JT Harness