# README ## JavaTest™ Harness Version 3.2.1 #### November 09, 2005

## 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 Java virtual machine (JVM™) to run the JavaTest harness properly. We recommend that you allocate 150M when running a large test suite. To allocate 150M of memory to the JVM, 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 JVM, 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.

Note: The terms "Java virtual machine" and "JVM" mean a virtual machine for the Java platform.

## 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.

NOTE: The PDF documentation files can be read with Adobe(R) Acrobat(R) Reader, available from Adobe Systems Inc.

Copyright © 2005 Sun Microsystems, Inc. All rights reserved.
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 © 2005 Sun Microsystems, Inc. Tous droits réservés.
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.