The lite harness (jtlite.jar
) can run test suites on devices that have either of two limitations:
The lite harness supports all test harness commands and options, except the following:
-newDesktop
-resume
-laf
-onlineHelp
-type xml
(suboption of -writeReport
)-type cof
(suboption -writeReport
)java
launcher command (version 6 or later) on the test device. You can do this with a keyboard and monitor connected to the device or over a operating system-level network connection that supports a remote protocol such as ssh
. Run java -version
to verify the Java installation. scp
or sftp
. jtlite.jar
), the test suite to be executed, a work directory, and reports. The jtlite.jar
file requires about 1MB of space. For Java runtime and test suite storage requirements, consult the corresponding documentation. Work directory and report sizes depend on the tests executed and reports generated. 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.
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.
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.
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.
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.