Skip to content

Commit

Permalink
update Connectors documentation to 2.1
Browse files Browse the repository at this point in the history 
Signed-off-by: Scott Marlow <smarlow@redhat.com>
  • Loading branch information
@scottmarlow
scottmarlow committed Mar 24, 2022
1 parent 100baca commit 107ddad
Show file tree
Hide file tree
Showing 7 changed files with 12,300 additions and 7,030 deletions.
252 changes: 120 additions & 132 deletions .../connector/docs/ReleaseNotes-JCA-2.0.html → .../connector/docs/ReleaseNotes-JCA-2.1.html
View file
@@ -1,132 +1,120 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=windows-1252">
<title>Jakarta Connectors TCK Release Notes</title>
<!--
Copyright (c) 2018, 2021 Oracle and/or its affiliates. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v. 2.0, which is available at http://www.eclipse.org/legal/epl-2.0. This Source Code may also be made available under the following Secondary
Licenses when the conditions for such availability set forth in the Eclipse Public License v. 2.0 are satisfied: GNU General Public License, version 2 with the GNU Classpath Exception, which is available at https://www.gnu.org/software/classpath/license.html. SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0-->
<style type="text/css">
-->
body { background-color: #ffffdd; color: #000000}
pre { background-color: #eeeeee; color: #000099; font-size: smaller}
code { color: #000099; font-size: smaller}
h1 { color: #000099}
h2 { color: #000099}
h3 { color: #000099; text-decoration: underline}
h4 { font-style: italic; color: #000099}
.tabletitle { font-style: italic; color: #ffffcc; font-size: small; font-variant: small-caps}
.subtitle { font-style: italic; color: #ffffcc; font-variant: small-caps}
.emphasize { font-style: italic; color: #000099}
.step { font-weight: bold}
.note { background-color: #fffff0; border-bottom-width: thin; border-top-width: thin; border-top-style: inset; border-bottom-style: inset; font-size: -10%;}
th { background-color: #eeeeee; padding-left: 2pt; padding-right: 2pt;}
-->
</style></head>
<body>
<div align="center">
<h1>Jakarta EE Connectors Specification Technology Compatibility Kit,
Version 2.0</h1>
<h2> <em class="emphasize">Release Notes, May 2021</em></h2>
</div>
<h2><a name="kit_contents">Kit Contents</a></h2>
<p>The Jakarta EE Connectors, Version 2.0 Technology Compatibility Kit (TCK)
includes the following items:</p>
<ul>
<li>
<p><strong>Jakarta EE Connectors TCK tests for signature, API, and
End-to-End tests:</strong></p>
</li>
<ul type="square">
<li>
<p>A <strong>signature test</strong> checks that all of the public
APIs are supported in the Jakarta EE Connectors Version 2.0
implementation that is being tested</p>
</li>
<li>
<p><strong>API tests</strong> for all of the public APIs under the <code>jakarta.resource</code>
package (and its sub-packages)</p>
</li>
<li>
<p><strong>End-To-End tests</strong> that demonstrate compliance with
the <em>Jakarta EE Connectors 2.0 Specification</em></p>
</li>
</ul>
<li>Jakarta EE Connectors TCK User's Guide (<a href="./html-usersguide/title.html"
title="Jakarta EE Connectors 2.0 TCK User's Guide (HTML)">HTML</a>, <a
href="./pdf-usersguide/Jakarta-Connectors-TCK-Users-Guide.pdf" title="Jakarta EE Connectors 2.0 TCK User's Guide (PDF)">PDF</a>)</li>
<ul type="square">
</ul>
</ul>
<hr>
<h2><a name="platform">Platform Notes</a></h2>
<p>The Jakarta EE Connectors TCK tests have been built with JDK 8 (1.8) and
is tested with JDK 8 (1.8), and JDK 11.</p>
<p>The Jakarta EE Connectors TCK tests have been run on the following
platforms:</p>
<ul>
<li>CentOS Linux 7, Alpine Linux v3.12 </li>
</ul>
<ul>
</ul>
<p>The Jakarta EE Connectors 2.0 TCK tests have been verified using the
Jakarta EE Connectors 2.0 Compatible Implementation, Eclipse GlassFish 6
and Eclipse GlassFish 6.1</p>
<hr>
<h2><a name="install_setup_run">Installing, Setting Up, and Running the
Jakarta EE Connectors TCK</a></h2>
<p>Refer to the <cite><a href="./html-usersguide/title.html" title="Jakarta EE Connectors 2.0 TCK User's Guide (HTML)">Jakarta
EE Connectors 2.0 TCK User's Guide</a></cite> for complete
instructions on installing, setting up, and running the Jakarta EE
Connectors TCK. The online version of the JT Harness version 5.0
documentation is available <a href="https://wiki.openjdk.java.net/display/CodeTools/Documentation">here</a>.</p>
<hr>
<h2>Jakarta EE Connectors TCK Requirements, Facts, and Figures</h2>
<blockquote>
<p>The Jakarta EE Connectors TCK requires a minimum of 203 MB of free disk
space:</p>
<ul>
<li>Jakarta EE Connectors TCK (zipped): 31 MB</li>
<li>Jakarta EE Connectors TCK (unzipped): 164 MB</li>
<li>Space for Jakarta Connectors log/report files: 8 MB minimum </li>
</ul>
<p>The test suite bundle contains the following:</p>
<ul>
<li>EARs: 0</li>
<li>JARs: 39</li>
<li>WARs: 24</li>
<li>RARs: 17</li>
<p> </p>
<li>Total tests: 138 </li>
</ul>
</blockquote>
<hr>
<h2>Status Information</h2>
<h3>Exclude List</h3>
<blockquote>
<p>You can find the exclude list in the Jakarta EE Connectors bundle in <code>&lt;TS_HOME&gt;/bin/ts.jtx</code>.
Revisions to the Exclude List are published as updates to the TCK
bundle. You can check the Jakarta EE Connectors Specification Web Site
for updates: <a href="https://jakarta.ee/specifications/connectors/2.0/">https://jakarta.ee/specifications/connectors/2.0/</a></p>
</blockquote>
<hr>
<h2>Known Problems and Workarounds</h2>
<h3>Running the Jakarta EE Connectors TCK Against Jakarta EE CI on Windows</h3>
<blockquote>
<p>When configuring and running the Jakarta EE Connectors TCK against the
Eclipse GlassFish 6 or 6.1 Compatible Implementation (CI) on Windows,
please make sure to install all related software (Java SE, the CI, the
TCK, etc.) on the same drive (for example, <code>C:</code>). If you
want to install on a drive other than <code>C:</code>, please be sure
to change the following properties in <code>&lt;TS_HOME&gt;/bin/ts.jte:</code></p>
<pre>s1as.applicationRoot=c:
</pre> </blockquote>
<hr>
<p><cite><small></small></cite></p>
<address><small> Copyright © 2013, 2021 Oracle and/or its affiliates. All
rights reserved. </small></address>
<cite>
<p></p>
</cite>
</body>
</html>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=windows-1252">
<title>Jakarta Connectors TCK Release Notes</title>
<!--
Copyright (c) 2018, 2021 Oracle and/or its affiliates. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v. 2.0, which is available at http://www.eclipse.org/legal/epl-2.0. This Source Code may also be made available under the following Secondary Licenses when the conditions for such availability set forth in the Eclipse Public License v. 2.0 are satisfied: GNU General Public License, version 2 with the GNU Classpath Exception, which is available at https://www.gnu.org/software/classpath/license.html. SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0-->
<style type="text/css">
-->
body { background-color: #ffffdd; color: #000000}
pre { background-color: #eeeeee; color: #000099; font-size: smaller}
code { color: #000099; font-size: smaller}
h1 { color: #000099}
h2 { color: #000099}
h3 { color: #000099; text-decoration: underline}
h4 { font-style: italic; color: #000099}
.tabletitle { font-style: italic; color: #ffffcc; font-size: small; font-variant: small-caps}
.subtitle { font-style: italic; color: #ffffcc; font-variant: small-caps}
.emphasize { font-style: italic; color: #000099}
.step { font-weight: bold}
.note { background-color: #fffff0; border-bottom-width: thin; border-top-width: thin; border-top-style: inset; border-bottom-style: inset; font-size: -10%;}
th { background-color: #eeeeee; padding-left: 2pt; padding-right: 2pt;}
-->
</style></head>
<body>
<div align="center">
<h1>Jakarta EE Connectors Specification Technology Compatibility Kit,
Version 2.1</h1>
<h2> <em class="emphasize">Release Notes, May 2022</em></h2>
</div>
<h2><a name="kit_contents">Kit Contents</a></h2>
<p>The Jakarta EE Connectors, Version 2.1 Technology Compatibility Kit (TCK)
includes the following items:</p>
<ul>
<li>
<p><strong>Jakarta EE Connectors TCK tests for signature, API, and
End-to-End tests:</strong></p>
</li>
<ul type="square">
<li>
<p>A <strong>signature test</strong> checks that all of the public
APIs are supported in the Jakarta EE Connectors Version 2.1
implementation that is being tested</p>
</li>
<li>
<p><strong>API tests</strong> for all of the public APIs under the <code>jakarta.resource</code>
package (and its sub-packages)</p>
</li>
<li>
<p><strong>End-To-End tests</strong> that demonstrate compliance with
the <em>Jakarta EE Connectors 2.1 Specification</em></p>
</li>
</ul>
<li>Jakarta EE Connectors TCK User's Guide (<a href="./html-usersguide/title.html"
title="Jakarta EE Connectors 2.1 TCK User's Guide (HTML)">HTML</a>, <a
href="./pdf-usersguide/Jakarta-Connectors-TCK-Users-Guide.pdf" title="Jakarta EE Connectors 2.1 TCK User's Guide (PDF)">PDF</a>)</li>
<ul type="square">
</ul>
</ul>
<hr>
<h2><a name="platform">Platform Notes</a></h2>
<p>The Jakarta EE Connectors TCK tests have been built with JDK 11 and is
tested with JDK 11, and JDK 17.</p>
<p>The Jakarta EE Connectors TCK tests have been run on the following
platforms:</p>
<ul>
<li>CentOS Linux 7, Alpine Linux v3.12 </li>
</ul>
<ul>
</ul>
<p>The Jakarta EE Connectors 2.1 TCK tests have been verified using the
Jakarta EE Connectors 2.1 Compatible Implementation, GlassFish 7.0</p>
<hr>
<h2><a name="install_setup_run">Installing, Setting Up, and Running the
Jakarta EE Connectors TCK</a></h2>
<p>Refer to the <cite><a href="./html-usersguide/title.html" title="Jakarta EE Connectors 2.1 TCK User's Guide (HTML)">Jakarta
EE Connectors 2.1 TCK User's Guide</a></cite> for complete
instructions on installing, setting up, and running the Jakarta EE
Connectors TCK. The online version of the JT Harness version 5.0
documentation is available <a href="https://wiki.openjdk.java.net/display/CodeTools/Documentation">here</a>.</p>
<hr>
<h2>Jakarta EE Connectors TCK Requirements, Facts, and Figures</h2>
<blockquote>
<p>The Jakarta EE Connectors TCK requires a minimum of 256 MB of free disk
space:</p>
<p>The test suite bundle contains the following:</p>
<ul>
<li>Total tests: 132 </li>
</ul>
</blockquote>
<hr>
<h2>Status Information</h2>
<h3>Exclude List</h3>
<blockquote>
<p>You can find the exclude list in the Jakarta EE Connectors bundle in <code>&lt;TS_HOME&gt;/bin/ts.jtx</code>.
Revisions to the Exclude List are published as updates to the TCK
bundle. You can check the Jakarta EE Connectors Specification Web Site
for updates: <a href="https://jakarta.ee/specifications/connectors/2.0/">https://jakarta.ee/specifications/connectors/2.1/</a></p>
</blockquote>
<hr>
<h2>Known Problems and Workarounds</h2>
<h3>Running the Jakarta EE Connectors TCK Against Jakarta EE CI on Windows</h3>
<blockquote>
<p>When configuring and running the Jakarta EE Connectors TCK against the
Eclipse GlassFish 7 or Compatible Implementation (CI) on Windows, please
make sure to install all related software (Java SE, the CI, the TCK,
etc.) on the same drive (for example, <code>C:</code>). If you want to
install on a drive other than <code>C:</code>, please be sure to change
the following properties in <code>&lt;TS_HOME&gt;/bin/ts.jte:</code></p>
<pre>s1as.applicationRoot=c:
</pre> </blockquote>
<hr>
<p><cite><small></small></cite></p>
<address><small> Copyright © 2013, 2021 Oracle and/or its affiliates. All
rights reserved. </small></address>
<cite>
<p></p>
</cite>
</body>
</html>

0 comments on commit 107ddad

Please sign in to comment.