The Lite Harness

Topics

Overview

The lite harness (jtlite.jar) can run test suites on devices that have either of two limitations:

Supported Commands

The lite harness supports all test harness commands and options, except the following:

Device Requirements

Although operating system-level networking support on the device is convenient for transfering files and running the lite harness remotely, the lite harness does not have any dependencies on networking APIs or services.

Installing

To install the lite harness on the test device, transfer a copy of javaTestInstallDir/lib/jtlite.jar to the test device's file system.

You must also install the test suite on the device. Consult the test suite documentation for instructions.

Launching

Assuming that the current directory contains the jtlite.jar you installed, and the device's java launcher command can be invoked with its unqualified name, the general form of the lite harness launch command is:

> java -jar jtlite.jar  \
-config yourConfig.jti \
-workdir yourWorkDir \
[more commands ...] \
-runTests \
-writeReport OutputReportDir

In this generic example, the \ line continuation character visually separates the command line arguments for clarity. This command line selects an existing configuration (file), an existing work directory and asks the harness to run the tests and write the default report(s). The location of the test suite is implied and will be determined from hints in the work directory. For more examples, refer to Extended Command-Line Examples, substituting the lite harness's JAR file name.

Creating a Configuration File

When you use the lite harness, you must specify the name of a configuration file on the command line with -config yourConfig.jti. The easiest and most reliable way to create and edit a configuration file is with the test harness graphical configuration editor running on a desktop or laptop computer. When you have created or updated a configuration file, copy it to the test device's file system so you can specify it when you launch the lite harness.

Working with Reports and Test Results

It may not be efficient to analyze results on the test platform itself - users have the option of relocating results to a more powerful platform. By copying work directories or reports from the test device to your desktop or laptop computer, you can examine and manipulate them with the test harness and other tools. For instance, you can use the report converter to merge reports or produce XML, and you can browse test information with the test harness GUI.

 


Copyright © 2013, Oracle and/or its affiliates. All rights reserved.