README

JavaTest™ Harness
Version 3.2.2_01

November 06, 2006

 

Table of Contents

Introduction
System Requirements
Installation
Files and Directories

Introduction

The JavaTest harness is designed to run test programs on a wide-variety of Java™ platforms.

This README contains basic information about this version of the JavaTest harness. Please see the release notes and online help for more information.

NOTE: To display the JavaTest harness online help without launching the JavaTest harness GUI, use the command that your test suite uses to start the JavaTest harness followed by the -onlineHelp command. For example, if your current directory is the /lib/ directory containing javatest.jar, you could use the following command to display online help:

> java -jar javatest.jar -onlineHelp

In the example command, > represents the command prompt. For Unix systems the command prompt may be either a shell prompt, such as %, or a user defined value. For win32 systems, the command prompt may be c: or another appropriate drive identifier.

System Requirements

The following sections provide the recommended system requirements for running the JavaTest harness.

Java platform

Java 2 Standard Edition (J2SE™), version 1.4.0 is required and version 1.4.2 or later is strongly recommended. See your testsuite documentation for any other requirements related to running your specific testsuite.

Memory

It is recommended that you run the JavaTest harness on a computer having 256M of physical memory. Use an agent in conjunction with the JavaTest harness to run test programs on platforms with limited amounts of memory.

If you are running a large test suite (10000+ tests), you must allocate a large amount of memory to the virtual machine (VM). We recommend that you allocate 150M when running a large test suite. To allocate 150M of memory to the VM, add -Xmx150m to the command string when starting the JavaTest harness from a writeable directory. You must include the path of the directory where the javatest.jar file is installed (represented as <test_suite>/lib/ in the following examples). The javatest.jar file is usually installed in the test suite lib directory when the JavaTest harness is bundled with a test suite.

On UNIX systems use:

% java -Xmx150m -jar <test_suite>/lib/javatest.jar

On WIN32 systems use:

c:\> java -Xmx150m -jar <test_suite>\lib\javatest.jar

NOTE: When allocating memory to the VM, do not exceed the actual amount of memory available on your system.

Your test suite documentation may also provide additional details about the memory allocation required for running tests.

Installation Instructions

The JavaTest harness is included with your test suite. Refer to your test suite documentation for detailed information about installing the test suite and the JavaTest harness on your test system.

Files and Directories

Name Description
doc/javatest/README-javatest.html This file
COPYRIGHT-javatest.html Copyright information
doc/javatest/ReleaseNotes-javatest.html Details about this release
doc/javatest/javatestGUI.pdf The JavaTest User's Guide: Graphical User Interface. This document is also available as a section of the JavaTest command-line online help.
doc/javatest/javatestCLI.pdf The JavaTest User's Guide: Command-Line Interface. This document is also available as a section of the JavaTest command-line online help.
doc/javatest/javatestAgent.pdf (optional) The JavaTest Agent User's Guide. Only certain test suites provide this document. See your test suite documentation for details. This document is also available as a section of the JavaTest command-line online help.
lib/javatest.jar Executable JAR file containing the class files and resources needed to run the JavaTest harness and the JavaTest Agent.
linux/bin/ Miscellaneous utility script(s) for use on Linux.
solaris/bin/ Miscellaneous utility script(s) for use on Solaris.
win32/bin/ Miscellaneous utility script(s) for use with MKS on Microsoft Windows platforms.

Copyright © 2006 Sun Microsystems, Inc. All rights reserved.
Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.sun.com/patents and one or more additional patents or pending patent applications in the U.S. and in other countries.
U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements.
Use is subject to license terms. Sun, Sun Microsystems, the Sun logo, Java and JavaTest harness are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.
UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd.

Copyright © 2006 Sun Microsystems, Inc. Tous droits réservés.
Sun Microsystems, Inc. détient les droits de propriété intellectuels relatifs à la technologie incorporée dans le produit qui est décrit dans ce document. En particulier, et ce sans limitation, ces droits de propriété intellectuelle peuvent inclure un ou plus des brevets américains listés à l'adresse http://www.sun.com/patents et un ou les brevets supplémentaires ou les applications de brevet en attente aux Etats - Unis et dans les autres pays.
L'utilisation est soumise aux termes du contrat de licence.
Sun, Sun Microsystems, le logo Sun, Java et JavaTest harness sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.
UNIX est une marque déposée aux Etats-Unis et dans d'autres pays et licenciée exclusivement par X/Open Company, Ltd.