Skip to content

Commit

Permalink
p to uppercase in platform TCK
Browse files Browse the repository at this point in the history
Signed-off-by: alwin-joseph <alwin.joseph@oracle.com>
  • Loading branch information
alwin-joseph committed Oct 30, 2020
1 parent 699b947 commit 61bba15
Show file tree
Hide file tree
Showing 14 changed files with 126 additions and 126 deletions.
6 changes: 3 additions & 3 deletions user_guides/jakartaee/src/main/jbake/content/TCKpreface.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -33,10 +33,10 @@ 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 9 Compatibility Test Suite (Jakarta
EE 9 platform TCK) is a portable, configurable automated test suite for verifying
EE 9 Platform TCK) is a portable, configurable automated test suite for verifying
the compatibility of an implementer's compliance with the Jakarta EE 9
Specification (hereafter referred to as the implementer's implementation, or VI).
The Jakarta EE 9 platform TCK uses the JavaTest harness version 5.0 to run the
The Jakarta EE 9 Platform TCK uses the JavaTest harness version 5.0 to run the
test suite.


Expand Down Expand Up @@ -72,7 +72,7 @@ programming language, the Jakarta Platform, Enterprise Edition 9 (Jakarta EE
The Jakarta Platform, Enterprise Edition 9 (Jakarta EE 9) Specification can be
downloaded from `https://projects.eclipse.org/projects/ee4j.jakartaee-platform`.

For documentation on the test harness used for running the Jakarta EE 9 platform TCK
For documentation on the test harness used for running the Jakarta EE 9 Platform TCK
test suite, see
`https://wiki.openjdk.java.net/display/CodeTools/Documentation`.

Expand Down
68 changes: 34 additions & 34 deletions user_guides/jakartaee/src/main/jbake/content/config.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Setup and Configuration
5 Setup and Configuration
-------------------------

This chapter describes how to set up the Jakarta EE 9 platform TCK test suite and
This chapter describes how to set up the Jakarta EE 9 Platform TCK test suite and
configure it to work with your test environment. It is recommended that
you first set up the testing environment using the Jakarta EE 9 CI and then
with your Jakarta EE 9 server.
Expand Down Expand Up @@ -86,7 +86,7 @@ backslashes (`\`) for Windows.
platform to be tested for certification.
2. Implement the porting package APIs. +
Some functionality in the Jakarta EE 9 platform is not completely specified
by an API. To handle this situation, the Jakarta EE 9 platform TCK test suite
by an API. To handle this situation, the Jakarta EE 9 Platform TCK test suite
defines a set of interfaces in the `com.sun.cts.porting` package, which
serve to abstract any implementation-specific code. You must create your
own implementations of the porting package interfaces to work with your
Expand Down Expand Up @@ -142,23 +142,23 @@ you may choose to run the Jakarta EE 9 CI as the VI
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

There are three general scenarios for configuring Jakarta EE 9 servers for
Jakarta EE 9 platform TCK testing (Note: in the following images, Java EE refers to Jakarta EE.
Jakarta EE 9 Platform TCK testing (Note: in the following images, Java EE refers to Jakarta EE.
RI should be replaced with CI for Compatible Implementation):

* Configure the Jakarta EE 9 CI as the server under test +
image:img/serverpath-ri.png["CI as Server Under Test"]

Use the Jakarta EE 9 CI as the Jakarta EE 9 VI; you may want to do this as a
sanity check to make sure you are comfortable with using the Jakarta EE 9
platform TCK against a known standard CI with certified sample applications
Platform TCK against a known standard CI with certified sample applications
before proceeding with tests against your Jakarta EE 9 VI. See
link:#GEWUI[Section 5.3.2, "Configuring the Jakarta EE 9 CI as the VI,"]
for instructions.

* Configure your Jakarta EE 9 VI as Server Under Test +
image:img/serverpath-vi.png["VI as Server Under Test"]

This is the primary goal of using the Jakarta EE 9 platform TCK; you will eventually
This is the primary goal of using the Jakarta EE 9 Platform TCK; you will eventually
need to configure the Jakarta EE 9 implementation you want to certify. See
link:#GEWWA[Section 5.3.3, "Configuring Your Application Server as the
VI,"] for instructions.
Expand All @@ -172,7 +172,7 @@ VI running a database of your choice with JDBC 4.1-compliant drivers.
The second server must be the Jakarta EE 9 CI using the bundled Java DB
database.

In terms of the Jakarta EE 9 platform TCK, all configuration settings are made
In terms of the Jakarta EE 9 Platform TCK, all configuration settings are made
in the `<TS_HOME>/bin/ts.jte` file. When configuring a Jakarta EE 9 server,
the important thing is to make sure that the settings you use for your
server match those in the `ts.jte` file.
Expand All @@ -189,7 +189,7 @@ the Jakarta EE 9 CI as the VI) follow the steps listed below. In this
scenario, the goal is simply to test the Jakarta EE 9 CI against the TCK
for the purposes of familiarizing yourself with TCK test procedures. You
may also want to refer to the Quick Start guides included with the Jakarta
EE 9 platform TCK for similar instructions.
EE 9 Platform TCK for similar instructions.

. Set server properties in your `<TS_HOME>/bin/ts.jte` file to suit
your test environment. +
Expand Down Expand Up @@ -466,7 +466,7 @@ initialization targets.

.. Set up database users and passwords that are used for JDBC
connections. +
The Jakarta EE 9 platform TCK requires several user names, passwords, and
The Jakarta EE 9 Platform TCK requires several user names, passwords, and
user-to-role mappings. These need to match those set in your `ts.jte`
file. By default, `user1`, `user2`, `user3, password1`, `password2`, and
`password3` are set to `cts1`.
Expand Down Expand Up @@ -654,7 +654,7 @@ back to their original values:
5.4 Modifying Environment Settings for Specific Technology Tests
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Before you can run any of the technology-specific Jakarta EE 9 platform TCK tests,
Before you can run any of the technology-specific Jakarta EE 9 Platform TCK tests,
you must supply certain information that JavaTest needs to run the tests
in your particular environment. This information exists in the
`<TS_HOME>/bin/ts.jte` environment file. This file contains sets of
Expand Down Expand Up @@ -762,15 +762,15 @@ will write temporary files.
5.4.2 Windows-Specific Properties
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

When configuring the Jakarta EE 9 platform TCK for the Windows environment, set the
When configuring the Jakarta EE 9 Platform TCK for the Windows environment, set the
following properties in `<TS_HOME>/bin/ts.jte`:

* `pathsep` to semicolon (pathsep=`;`)

* `s1as.applicationRoot` to the drive on which you have installed platform TCK
* `s1as.applicationRoot` to the drive on which you have installed Platform TCK
(for example, `s1as.applicationRoot=C:`) +
When installing in the Windows environment, the Jakarta Platform,
Enterprise Edition CI, JDK, and platform TCK should all be installed on the same
Enterprise Edition CI, JDK, and Platform TCK should all be installed on the same
drive. If you must install these components on different drives, also
change the `ri.applicationRoot` property in addition to the `pathsep`
and `s1as.applicationRoot` properties; for example: +
Expand All @@ -783,7 +783,7 @@ ri.applicationRoot=C:
[NOTE]
=======================================================================
When configuring the CI and platform TCK for the Windows environment, never
When configuring the CI and Platform TCK for the Windows environment, never
specify drive letters in any path properties in `ts.jte`.
=======================================================================
Expand Down Expand Up @@ -930,7 +930,7 @@ properties.
The SSL related tests under
`/ts/javaeetck/src/com/sun/ts/tests/websocket/platform/jakarta/websocket/server/handshakerequest/authenticatedssl/`
use self signed certificate bundled with the platform TCK bundle. These
use self signed certificate bundled with the Platform TCK bundle. These
certificates are generated with localhost as the hostname and would work
only when orb.host value is set to localhost in ts.jte. If the server's
hostname is used instead of the localhost, the tests in this suite might
Expand Down Expand Up @@ -1040,7 +1040,7 @@ directory contains packaging instructions.
5.4.8.2 To Package WAR files for Deployment on the Jakarta EE 9 CI
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

The Jakarta EE 9 platform TCK test suite does not come with prebuilt test WAR files
The Jakarta EE 9 Platform TCK test suite does not come with prebuilt test WAR files
for deployment on Jakarta EE 9 CI. The test suite includes a command to
generate the test WAR files that will be deployed on the Jakarta EE 9 CI.
The WAR files are Jersey-specific, with Jersey's servlet class and
Expand Down Expand Up @@ -1106,10 +1106,10 @@ VI-specific Servlet class will be included instead of the Jakarta EE 9
CI-specific Servlet class.

All resource and application class files are already compiled. The
Vendor needs to package these files. Jakarta EE 9 platform TCK makes this task
Vendor needs to package these files. Jakarta EE 9 Platform TCK makes this task
easier by including template WAR files that contain all of the necessary
files except for the VI-specific servlet adaptor class. The Jakarta EE 9
platform TCK also provides a tool to help with the repackaging task.
Platform TCK also provides a tool to help with the repackaging task.

Each test that has a Jakarta RESTful Web Services resource class to publish comes with a
template deployment descriptor file. For example, the file
Expand Down Expand Up @@ -1176,7 +1176,7 @@ http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
</web-app>
----

The Jakarta EE 9 platform TCK test suite provides a tool,
The Jakarta EE 9 Platform TCK test suite provides a tool,
`${ts.home}/bin/xml/impl/glassfish/jersey.xml`, for the Jakarta EE 9 CI
that you can use as a model to help you create your own VI-specific Web
test application.
Expand Down Expand Up @@ -1279,8 +1279,8 @@ extension library. The `whitebox.jar` file is a Shared Library that must
be deployed as a separate entity that all the Jakarta Connector RAR files
access. This extension library is needed to address classloading issues.
The RAR files that are used with Jakarta EE 9 platform TCK test suite differ from
those that were used in earlier test suites. Jakarta EE 9 platform TCK no longer
The RAR files that are used with Jakarta EE 9 Platform TCK test suite differ from
those that were used in earlier test suites. Jakarta EE 9 Platform TCK no longer
bundles the same common classes into every RAR file. Duplicate common
classes have been removed and now exist in the `whitebox.jar` file, an
Installed Library that is deployed and is made available before any
Expand All @@ -1303,7 +1303,7 @@ requirements that are listed in section 20.3 in the specification.
5.4.9.2 Connector Resource Adapters and Classloading
+++++++++++++++++++++++++++++++++++++++++++++++++++++

Jakarta EE 9 platform TCK has scenarios in which multiple standalone RAR files that
Jakarta EE 9 Platform TCK has scenarios in which multiple standalone RAR files that
use the same shared library (for example, `whitebox.jar`) are referenced
from an application component.

Expand Down Expand Up @@ -1366,7 +1366,7 @@ copied.
5.4.9.4 Required Porting Package
+++++++++++++++++++++++++++++++++

The Jakarta EE 9 platform TCK treats the `whitebox.jar` dependency as an
The Jakarta EE 9 Platform TCK treats the `whitebox.jar` dependency as an
Installed Library dependency instead of bundling the dependency (or
dependencies) with every RAR file. Each RAR file now contains a
reference to the `whitebox.jar` file through its Manifest files
Expand Down Expand Up @@ -1527,7 +1527,7 @@ asadmin create-jdbc-resource --connectionpoolid cts-derby-XA-pool \
----
+
If two or more JDBC resource elements point to the same connection pool
element, they use the same pool connection at runtime. Jakarta EE 9 platform TCK
element, they use the same pool connection at runtime. Jakarta EE 9 Platform TCK
does reuse the same connection pool ID for testing the Jakarta EE 9 CI Eclipse GlassFish 6.0.

. Make sure that the following EIS and RAR files have been deployed
Expand Down Expand Up @@ -1669,7 +1669,7 @@ interval timers. The default setting and recommended minimum value is
for results from the `ejbTimeout()` method. The default setting and
recommended minimum value is `60000` milliseconds.

Jakarta EE 9 platform TCK does not have a property that you can set to configure the
Jakarta EE 9 Platform TCK does not have a property that you can set to configure the
date for date timers.

The timer tests use the specific `jndi-name` jdbc`/DBTimer` for the
Expand Down Expand Up @@ -1703,7 +1703,7 @@ CI as the VI].

Your Jakarta Platform, Enterprise Edition implementation should map the
following instance variables to a backend datastore. These are needed to
run the platform TCK entity bean container-managed persistence (cmp1.1) tests.
run the Platform TCK entity bean container-managed persistence (cmp1.1) tests.

The Jakarta Platform, Enterprise Edition CI creates the table used by
container-managed persistence by appending `"Table"` to the bean name.
Expand Down Expand Up @@ -1784,7 +1784,7 @@ stubbed-out legacy JPA 2.1 implementation, which is located in the
`src/com/sun/ts/jpa/common/pluggibility/altprovider` directory.
In Java EE 7 CTS, the Persistence API pluggability tests required
special setup to run. This is no longer the case, since Jakarta EE 9 platform TCK
special setup to run. This is no longer the case, since Jakarta EE 9 Platform TCK
now enables the pluggability tests to be executed automatically along
with all the other Persistence tests. The Jakarta Persistence tests have a new
directory structure. In Java EE 7 CTS, the tests were in the
Expand All @@ -1798,7 +1798,7 @@ the `src/com/sun/ts/tests/jpa` directory.

Jakarta Persistence supports the use of a second-level cache by the
persistence provider. The `ts.jte` file provides a property that
controls the platform TCK test suite's use of the second-level cache.
controls the Platform TCK test suite's use of the second-level cache.

The `persistence.second.level.caching.supported` property is used to
determine if the persistence provider supports the use of a second-level
Expand Down Expand Up @@ -1874,7 +1874,7 @@ supports the use of SEQUENCE. If it does not, this property should be
set to false so the test is not run. The default value is true.

If the database under test is not one of the databases defined and
supported by platform TCK, the user will need to create an entry similar to the
supported by Platform TCK, the user will need to create an entry similar to the
one listed in link:#GEXOO[Example 5-1].

[[GEXOO]]
Expand Down Expand Up @@ -1905,15 +1905,15 @@ entity managers, which correspond to a `non-jta-data-source`
5.4.15 Jakarta Messaging Test Setup
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

This section explains how to set up and configure the Jakarta EE 9 platform TCK
This section explains how to set up and configure the Jakarta EE 9 Platform TCK
suite before running the Jakarta Messaging tests.


[NOTE]
=======================================================================
The client-specified values for `JMSDeliveryMode`, `JMSExpiration`, and
`JMSPriority` must not be overridden when running the platform TCK Jakarta Messaging tests.
`JMSPriority` must not be overridden when running the Platform TCK Jakarta Messaging tests.
=======================================================================

Expand Down Expand Up @@ -2145,7 +2145,7 @@ in the `ts.jte` file.
Jakarta Authentication Service for Containers (Authentication)
1.1 tests are security tests. The Jakarta Authentication Servlet (jaspicservlet) profile is the only
required profile for Jakarta EE 9 platform TCK. There are other optional profile
required profile for Jakarta EE 9 Platform TCK. There are other optional profile
tests, such as SOAP, but you are not required to run these for
certification.
Expand Down Expand Up @@ -2923,7 +2923,7 @@ running against the Jakarta Platform, Enterprise Edition CI
5.4.21.2 Additional Signature Test Information
++++++++++++++++++++++++++++++++++++++++++++++
The Jakarta EE 9 platform TCK signature tests perform verifications in two different
The Jakarta EE 9 Platform TCK signature tests perform verifications in two different
modes: static and reflection. The test results list which signature
tests pass or fail, and the mode (static or reflection) for that test.
As a troubleshooting aid when failures occur, consider the following:
Expand Down Expand Up @@ -3004,7 +3004,7 @@ Edition server.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
You can use the JavaTest harness GUI to modify general test settings and
to quickly get started with the default platform TCK test environment. After
to quickly get started with the default Platform TCK test environment. After
familiarizing yourself with these basic configuration settings, you will
probably want to continue with the instructions in link:#GEXPP[Modifying
Environment Settings for Specific Technology Tests].
Expand Down Expand Up @@ -3064,7 +3064,7 @@ proceed with running the test.
5.5.2 The Configuration Interview
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
To configure the JavaTest harness to run the Jakarta EE 9 platform TCK tests,
To configure the JavaTest harness to run the Jakarta EE 9 Platform TCK tests,
complete the following steps. Note that you only need to complete these
steps the first time you start the JavaTest harness. After you complete
these steps, you can either run all or a subset of the tests, as
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ example, the context root for the archive `web-client.war` defaults to
`web-client`.

This covers the mapping for all servlet-based web services endpoints and
clients under the Jakarta EE 9 platform TCK test trees
clients under the Jakarta EE 9 Platform TCK test trees
Jakarta XML Web Services (`jaxws`),
Jakarta Web Services Metadata (`jws`),
webservices, webservices12, webservices13].
Expand Down

0 comments on commit 61bba15

Please sign in to comment.