Preface

Note

The Jakarta Enterprise Edition documentation is part of the Jakarta Enterprise Edition contribution to the Eclipse Foundation and is not intended for use in relation to Java Enterprise Edition or Java Licensee requirements. This documentation is in the process of being revised to reflect the new Jakarta EE requirements and branding. Additional changes will be made as requirements and procedures evolve for Jakarta EE. Where applicable, references to Java EE or Java Enterprise Edition should be considered references to Jakarta EE.

Please see the Title page for additional license information.

This book introduces the Compatibility Test Suite (CTS) for the Jakarta Platform, Enterprise Edition 8 (Jakarta EE 8) and Jakarta Platform, Enterprise Edition 8 Web Profile (Jakarta EE 8 Web Profile), and explains how to configure and run the test suite. It also provides information for troubleshooting problems you may encounter as you run the test suite.

The Jakarta Platform, Enterprise Edition 8 Compatibility Test Suite (Jakarta EE 8 CTS) is a portable, configurable automated test suite for verifying the compatibility of an implementer’s compliance with the Jakarta EE 8 Specification (hereafter referred to as the implementer’s implementation, or VI). The Jakarta EE 8 CTS uses the JavaTest harness version 5.0 to run the test suite.

Note	URLs are provided so you can locate resources quickly. However, these URLs are subject to changes that are beyond the control of the authors of this guide.

Who Should Use This Book

This guide is for developers of the Jakarta EE 8 technology to assist them in running the test suite that verifies compatibility of their implementation of the Jakarta EE 8 Specification.

Before You Read This Book

Before reading this guide, you should familiarize yourself with the Java programming language, the Jakarta Platform, Enterprise Edition 8 (Jakarta EE 8) Specification, and the JavaTest documentation.

The Jakarta Platform, Enterprise Edition 8 (Jakarta EE 8) Specification can be downloaded from https://projects.eclipse.org/projects/ee4j.jakartaee-platform.

For documentation on the test harness used for running the Java EE 8 CTS test suite, see https://wiki.openjdk.java.net/display/CodeTools/Documentation.

Typographic Conventions

The following table describes the typographic conventions that are used in this book.

Convention Meaning Example

Convention	Meaning	Example
Boldface	Boldface type indicates graphical user interface elements associated with an action, terms defined in text, or what you type, contrasted with onscreen computer output.	From the File menu, select Open Project. A cache is a copy that is stored locally. `machine_name% su Password:`
`Monospace`	Monospace type indicates the names of files and directories, commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.	Edit your `.login` file. Use `ls` `-a` to list all files. `machine_name% you have mail.`
Italic	Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.	Read Chapter 6 in the User’s Guide. Do not save the file. The command to remove a file is `rm` filename.

Boldface

Boldface type indicates graphical user interface elements associated with an action, terms defined in text, or what you type, contrasted with onscreen computer output.

From the File menu, select Open Project.

A cache is a copy that is stored locally.

machine_name% su
Password:

Monospace

Monospace type indicates the names of files and directories, commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

Edit your .login file.

Use ls -a to list all files.

machine_name% you have mail.

Italic

Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.

Read Chapter 6 in the User’s Guide.

Do not save the file.

The command to remove a file is rm filename.

Shell Prompts in Command Examples

The following table shows the default UNIX system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Shell Prompt

Shell	Prompt
C shell	`machine_name%`
C shell for superuser	`machine_name#`
Bourne shell and Korn shell	`$`
Bourne shell and Korn shell for superuser	`#`
Bash shell	`shell_name-shell_version$`
Bash shell for superuser	`shell_name-shell_version#`

C shell

machine_name%

C shell for superuser

machine_name#

Bourne shell and Korn shell

$

Bourne shell and Korn shell for superuser

#

Bash shell

shell_name-shell_version$

Bash shell for superuser

shell_name-shell_version#