Release NotesJavaTest™ Harness
|
The JavaTest harness, Version 3.2.1 release is a maintenance release. It provides the same features of JavaTest harness, Version 3.2. See Bugs Fixed in this Release for a description of the changes in this release.
The JavaTest harness, Version 3.2 release contains basic changes in the following areas:
.jti
) files..jti
) file checksum requirements have been reduced.
If the agent commands and options are not specified adjacent to each other on the command line, specify the agentPoolPort
option before the startAgentPool
option.
Example of previous ordering:
java -jar javatest.jar ... -startAgentPool -agentPoolPort 1234
Example of the new ordering:
java -jar javatest.jar ... -agentPoolPort 1234 ... -startAgentPool
The JavaTest harness now saves invalid input from the user for configuration questions, instead of completely rejecting the input. Consequently, invalid values provided by the user that were ignored by previous versions of the harness are now rejected by the current version of the harness.
For example, using yes
as a value on the command line for a
Yes/No question
was ignored by previous versions of the JavaTest harness. The current version
of the JavaTest harness now displays an execution-time configuration error
for invalid input from the user.
BUG ID | DESCRIPTION |
---|---|
4744381 | Misleading value for tree question response in Question log.
In the Question log, if the entire tree was selected, the response was shown as "no response" whereas "all" was more appropriate. |
4762952 | Failure to complete an interview "save" is not recorded.
For example, if an interview was not saved sucessfully because of file system permissions, the Configuration Editor behaved as though it was saved. Although it displayed the Configuration Editor after the save failed, the JavaTest harness did not indicate that you must save before closing the Configuration Editor. |
4801945 | EditJTI ignores value of -classpath argument.
|
5064094 | Tests sometimes skipped for execution (Tests to Run).
The harness might skip tests for execution when one test name is a substring of another. |
5085607 | Question Log doesn't display values of ChoiceArrayQuestion .
|
5102476 | Significant slowdown in com.sun.javatest.TestFinder .
A significant slowdown in running the JCK for Java SE 1.5 as compared to Java SE 1.4 occured when indexing tests. The algorithm was not optimized for parts of the JCK which had many tests in one folder. JDK 1.5 libraries also have a performance problem doing the string comparison in the TestFinder. Use JDK 1.4.x or JDK 6.0 (when available) to avoid this problem. |
6181535 | Names of tests are reverse sorted when they contain hash.
Sorting was added to the |
6217248 | The set command with -file option does not work properly in batch mode.
If the |
6225923 | In Configuration Editor, invoking Save As reverts to old filename.
Invoking "Save As ..." and then immediately invoking "Save" changes to the new |
6227876 | Restructure docs to emphasize TCK docs over JT docs.
The |
6265714 | Batch test execution works incorrectly with existing workdir.
If a batch test run uses a test finder other than |
The bugs listed in the table below are the known bugs of interest to users that remain to be fixed.
BUG ID | DESCRIPTION |
---|---|
4422418 | Test information not updated while test is running
Information in the Test panel status tabs is not updated while a test is running, but is updated when the test is completed. To update the information manually during a test run, switch to a different tab and then return. |
4902888 | JavaTest harness crashes when running on Linux 64 bit systems
The Virtual Machine for the Java™ platform (Java Virtual Machine or JVM™ machine) crashes when running the JavaTest harness on the Itanium platform. If you are testing such a system, run the tests in an agent configuration, with the harness itself on a different platform. |
5002276 | Tests that do not allow interrupts may hang the JavaTest agent
The JavaTest harness cannot currently force tests to stop running if they do not allow interrupts. |
5018050 | One test timeout can cause consecutive test timeouts when using an agent.
If you encounter a series of test timeouts and timeouts which contain the test
status message |
Run JavaTest harness, Version 3.2.1 with Java 2 Standard Edition (J2SE™), Version 1.4.2 or later.
Running the JavaTest harness on Linux Itanium is not supported.
Printing Pages from the Online Help and Test Reports
Because of the method the Java SE platform uses to render fonts, when you print a document from the JavaTest user interface, the fonts in the printed documents are larger than they are when rendered on the screen.
The JavaTest harness User's Guides has been provided in PDF form for you use in printing pages from the documents. While the online help viewer supports printing operations, in some cases you may be unable to use it to print a specific page. If this occurs, use the PDF version of the appropriate User's Guide to print the page.
Changing Status Colors in the GUI
The JavaTest harness allows the user to specify the status colors used in the GUI. See the online help for detailed information about changing the default status colors.
Agent Monitor Tool
The Agent Monitor tool may not apply to all test suites, even if the test suite uses an agent. See your test suite documentation for detailed information about the agent that it uses and its use of the Agent Monitor tool.
For users moving from version 2.1.x to version 3.2.1 of the JavaTest harness, the following section provides a general description of the major differences between the two versions.
The JavaTest harness, version 3.2.1 , adds to and improves both the core version 2.1.x functions and the JavaTest harness GUI. Noticeable changes in the GUI are in the test information panels, the menu bar, and the new Progress Monitor dialog box.
NOTE:
Test suites built for JavaTest harness,version 2.1.x may require
modification before the current JavaTest harness can run them. Please
contact your technical support representative for more
information.
Configuration Editor Window
The JavaTest harness Configuration Editor window replaces the stand-alone JavaTest harness version 2.1.x Configuration Wizard. The Configuration Editor window provides additional features not available in the stand-alone Configuration Wizard. See the online help for detailed information about the JavaTest harness Configuration Editor window.
Online Documentation and Context Sensitive Help
The JavaTest harness includes extensive online documentation and help. The JavaTest harness also allows test suite documentation to be displayed in the GUI. Use the Help menu to display the available online documentation. Press the F1 key to see information about the window that has keyboard focus.
NOTE:
You must establish keyboard focus in a window by highlighting
something in it before pressing the F1 key.
Test Manager Window
The Test Manager window replaces both the version 2.1.x Test Panel and Summary Pane. The new Test Manager window has three panes:
See the online help for more detailed information.
To start a test run, choose Run Tests -> Start. The configuration editor identifies and collects all configuration information required to run tests.
The JavaTest harness automatically selects the test suite root directory when you open a test suite. You no longer specify the test suite root directory as a parameter.
The JavaTest harness requires that you open or create a work directory before specifying a configuration. The work directory is no longer specified as a parameter.
Providing Configuration Information
Test suites designed to work with the JavaTest harness, version 3.2.1 ,
use the Configuration Editor window to collect required configuration information
in a single configuration file (.jti
). The JavaTest
harness uses the configuration information from the file to run tests. When
the user attempts to use an incomplete configuration to run tests, the JavaTest
harness opens the Configuration Editor window and prompts the
user for the required information. The user can change configuration information
any time tests are not running.
Existing test suites can continue to use .jte
files.
Users specify the appropriate .jte
file in the configuration
editor. However, test parameter files (.jtp
) are no longer supported
when running tests in the GUI. These values must be set in the Configuration
Editor window. The JavaTest harness incorporates these values with
the .jte
file
in a new configuration file (.jti
).
NOTE:
For compatibility, you can still specify a .jtp
file
from the command line. To see the available command-line options,
type the following command at a system prompt:
java -jar test_suite/lib/javatest.jar -help
NOTE:
Include the path of the directory where the
javatest.jar
file is installed (represented as
test_suite
in the example). When the JavaTest harness
is bundled with a test suite, the
javatest.jar
file is usually installed in the test
suite lib
directory.
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 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 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.