Eclipse Foundation™
Who Should Use This Book
Before You Read This Book
Typographic Conventions
Shell Prompts in Command Examples
1.1 Compatibility Testing
1.1.1 Why Compatibility Testing is Important
1.1.2 Compatibility Rules
1.1.3 CTS Overview
1.1.4 Jakarta Specification Community Process Program and Compatibility Testing
1.2 About Jakarta EE 8 CTS
1.2.1 Jakarta EE 8 Technologies Tested with Jakarta EE 8 CTS
1.2.2 Jakarta EE 8 Web Profile Technologies Tested With Jakarta EE 8 CTS
1.2.3 CTS Tests
1.2.4 JavaTest Harness
1.2.5 Exclude Lists
1.2.6 Apache Ant
1.3 Hardware Requirements
1.4 Software Requirements
1.5 Additional Jakarta EE 8 CTS Requirements
1.6 Getting Started With the Jakarta EE 8 CTS Test Suite
2.1 Certification Overview
2.2 Compatibility Requirements
2.2.1 Definitions
2.2.2 Rules for Jakarta Platform, Enterprise Edition Version 8 Products
2.3 Jakarta Platform, Enterprise Edition Version 8 Test Appeals Process
2.3.1 Valid Challenges
2.3.2 Invalid Challenges
2.3.3 TCK Test Appeals Steps
2.4 Specifications for Jakarta Platform, Enterprise Edition Version 8
2.5 Libraries for Jakarta Platform, Enterprise Edition Version 8
3.1 Certification Overview
3.2 Compatibility Requirements
3.2.1 Definitions
3.2.2 Rules for Jakarta Platform, Enterprise Edition Version 8 Products
3.3 Jakarta Platform, Enterprise Edition Version 8 Test Appeals Process
3.3.1 Valid Challenges
3.3.2 Invalid Challenges
3.3.3 TCK Test Appeals Steps
3.4 Specifications for Jakarta Platform, Enterprise Edition Version 8, Web Profile
3.5 Libraries for Jakarta Platform, Enterprise Edition Version 8, Web Profile
4.1 Installing the Jakarta EE 8 Compatible Implementation
4.2 Installing the Jakarta EE 8 CTS
4.3 Verifying Your Installation (Optional)
5.1 Allowed Modifications
5.2 Configuring the Test Environment
5.3 Configuring a Jakarta EE 8 Server
5.3.1 Jakarta Platform, Enterprise Edition Server Configuration Scenarios
5.3.2 Configuring the Jakarta EE 8 CI as the VI
5.3.3 Configuring Your Application Server as the VI
5.3.4 Configuring a Jakarta Platform, Enterprise Edition CI and VI for Interop/Rebuildable Tests
5.4 Modifying Environment Settings for Specific Technology Tests
5.4.1 Test Harness Setup
5.4.2 Windows-Specific Properties
5.4.3 Test Execution Command Setup
5.4.4 Jakarta Servlet Test Setup
5.4.5 Jakarta WebSocket Test Setup
5.4.6 JDBC Test Setup
5.4.7 Standalone RMI/IIOP Server Test Setup
5.4.8 Jakarta Mail Test Setup
5.4.9 Jakarta RESTful Web Services Test Setup
5.4.10 Jakarta Connector Test Setup
5.4.11 XA Test Setup
5.4.12 Jakarta Enterprise Beans 3.2 Test Setup
5.4.13 Jakarta Enterprise Beans Timer Test Setup
5.4.14 Entity Bean Container-Managed Persistence Test Setup for Jakarta Enterprise Beans V 1.1
5.4.15 Jakarta Persistence API Test Setup
5.4.16 Jakarta Messaging Test Setup
5.4.17 Transaction Interoperability Testing
5.4.18 Jakarta Authentication Service Test Setup
5.4.19 CSIv2 Test Setup
5.4.20 Jakarta Authorization Test Setup
5.4.21 Jakarta Batch Test Setup
5.4.22 WSDL: Webservice Test and Runtime Notes
5.4.23 Jakarta Security API Test Setup
5.4.24 Signature Test Setup
5.4.25 Backend Database Setup
5.4.26 Deployment Test Setup
5.4.27 Jakarta XML Registries Test Setup
5.5 Using the JavaTest Harness Configuration GUI
5.5.1 Basic Configuration Overview
5.5.2 The Configuration Interview
6.1 Configuring the Jakarta EE 8 Web Profile Test Environment
6.1.1 To Run Tests Against a Jakarta EE 8 Web Profile Implementation
7.1 Jakarta EE 8 CTS Operating Assumptions
7.2 Starting JavaTest
7.2.1 To Start JavaTest in GUI Mode
7.2.2 To Start JavaTest in Command-Line Mode
7.3 Validating Your Test Configuration
7.3.1 To Validate Your Configuration in GUI Mode
7.3.2 To Validate Your Configuration in Command-Line Mode
7.4 Running a Subset of the Tests
7.4.1 To Run a Subset of Tests in GUI Mode
7.4.2 To Run a Subset of Tests in Command-Line Mode
7.5 Using Keywords to Test Required and Optional Technologies
7.5.1 Setting the javaee.level Property
7.5.2 Using Keywords to Create Groups and Subsets of Tests
7.7 Rebuilding Test Directories
7.8 Test Reports
7.8.1 Creating Test Reports
7.8.2 Viewing an Existing Test Report
8.1 Overview
8.2 Test Tree
8.3 Folder Information
8.4 Test Information
8.5 Report Files
8.6 Configuration Failures
9.1 Common CTS Problems and Resolutions
9.2 Support
10.1 Configuring Your Build Environment
10.2 Building the Tests
10.3 Running the Tests
10.3.1 To Run a Single Test Directory
10.3.2 To Run a Single Test Within a Test Directory
10.4 Listing the Contents of dist/classes Directories
<TS_HOME>/classes/com/sun/ts/tests/samples/ejb/ee/simpleHello
10.5 Debugging Service Tests
10.5.1 Examples
10.5.2 Obtaining Additional Debugging Information
11.1 Overview
11.2 Porting Package APIs
11.2.1 TSDeploymentInterface2
11.2.2 Ant-Based Deployment Interface
11.2.3 TSJMSAdminInterface
11.2.4 TSLoginContextInterface
11.2.5 TSURLInterface
11.2.6 TSHttpsURLConnectionInterface
11.2.7 TSJAXRPCInterface
A Common Applications Deployment
B CSIv2 Test Reference
B.1 Overview
B.1.1 Application Client-to-Jakarta Enterprise Beans Scenarios
B.1.2 Jakarta Enterprise Beans-to-Jakarta Enterprise Beans Test Scenarios
B.1.3 Web Client-to-Jakarta Enterprise Beans Scenarios
B.2 CSIv2 Logging Servlet
B.3 Naming Conventions for CSIv2 Test Directories
B.4 CSIv2 Test Directory Structure
B.5 Naming Conventions for CSIv2 Test Names
B.6 Security Elements Associated With CSIv2 Tests
B.6.1 The security-role-mapping Element
B.6.2 The ior-security-config Element
B.7 Debugging CSIv2 Test Failures
B.7.1 Debugging CTS Clients, Beans, and Servlets
B.7.2 Debugging CTS CSIv2 Interceptors
B.7.3 Debugging Logging Servlet Problems
B.8 Examining Test Logs
B.8.1 To Examine the Test Logs
Validating the following IOR against IOR.4:
Validating the following IOR against IOR.3:
Validating the following invocation:
B.8.2 Bit Mask Values for CSIv2 IOR Structures
B.9 CSIv2 Log Elements
B.9.1 Key Elements in the CSIv2 Log
B.9.2 Key Elements in the Server Interceptor Log
B.9.3 Key Elements in the Client Interceptor Log
B.9.4 Key Elements in an IOR Log
B.9.5 Comprehensive List of All CSIv2 Log Elements
B.10 IORs and Associated CSIv2 Tests
B.10.1 IOR.0
B.10.2 IOR.1
B.10.3 IOR.3
B.10.4 IOR.4
B.10.5 IOR.7
C Jakarta Authentication Technology Notes and Files
C.1 Jakarta Authentication 1.1 Technology Overview
C.2 Jakarta Authentication TSSV Files
C.2.1 tssv.jar file
C.2.2 ProviderConfiguration.xml file
C.2.3 provider-configuration.dtd file
D Configuring Your Backend Database
D.1 Overview
D.2 The init.<database> Ant Target
D.3 Database Properties in ts.jte
D.4 Database DDL and DML Files
D.5 CMP Table Creation
E EJBQL Schema
E.1 Persistence Schema Relationships
E.2 SQL Statements for CMP 1.1 Finders
E.2.1 ejb/ee/bb/entity/cmp/clientviewtest, interop/ejb/entity/cmp/clientviewtest
E.2.2 ejb/ee/bb/entity/cmp/complexpktest
E.2.3 ejb/ee/tx/txECMPbean
F Context Root Mapping Rules for Web Services Tests
F.1 Servlet-Based Web Service Endpoint Context Root Mapping
F.2 Jakarta Enterprise Bean-Based Web Service Endpoint Context Root Mapping
G Testing a Standalone Jakarta Messaging Resource Adapter
G.1 Setting Up Your Environment
G.2 Configuring Jakarta EE 8 CTS
G.3 Configuring a Jakarta EE 8 CI for the Standalone Jakarta Messaging Resource Adapter
G.4 Modifying the Runtime Deployment Descriptors for the Jakarta Messaging MDB and Resource Adapter Tests
G.5 Running the Jakarta Messaging Tests From the Command Line
G.6 Restoring the Runtime Deployment Descriptors for the Jakarta Messaging MDB and Resource Adapter Tests
G.7 Reconfiguring Jakarta EE 8 CI for Jakarta EE 8 CTS After Testing the Standalone Jakarta Messaging Resource Adapter