You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by ma...@apache.org on 2020/02/21 13:38:06 UTC
svn commit: r1874319 - in /tomcat/site/trunk: docs/migration-10.html
xdocs/migration-10.xml
Author: markt
Date: Fri Feb 21 13:38:02 2020
New Revision: 1874319
URL: http://svn.apache.org/viewvc?rev=1874319&view=rev
Log:
Add the 10.x specific file
Added:
tomcat/site/trunk/docs/migration-10.html (with props)
tomcat/site/trunk/xdocs/migration-10.xml (with props)
Added: tomcat/site/trunk/docs/migration-10.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/migration-10.html?rev=1874319&view=auto
==============================================================================
--- tomcat/site/trunk/docs/migration-10.html (added)
+++ tomcat/site/trunk/docs/migration-10.html Fri Feb 21 13:38:02 2020
@@ -0,0 +1,189 @@
+<!DOCTYPE html SYSTEM "about:legacy-compat">
+<html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1"><link href="res/css/tomcat.css" rel="stylesheet" type="text/css"><link href="res/css/fonts/fonts.css" rel="stylesheet" type="text/css"><title>Apache Tomcat® - Migration Guide - Tomcat 10.0.x</title><meta name="author" content="Apache Tomcat Project"></head><body><div id="wrapper"><header id="header"><div class="clearfix"><div class="menu-toggler pull-left" tabindex="1"><div class="hamburger"></div></div><a href="http://tomcat.apache.org/"><img class="tomcat-logo pull-left noPrint" alt="Tomcat Home" src="res/images/tomcat.png"></a><h1 class="pull-left">Apache Tomcat<sup>®</sup></h1><div class="asf-logos pull-right"><a href="https://www.apache.org/foundation/contributing.html" target="_blank" class="pull-left"><img src="https://www.apache.org/images/SupportApache-small.png" class="support-asf" alt="Support Apache"></a><a h
ref="http://www.apache.org/" target="_blank" class="pull-left"><img src="res/images/asf_logo.svg" class="asf-logo" alt="The Apache Software Foundation"></a></div></div></header><main id="middle"><div><div id="mainLeft"><div id="nav-wrapper"><form action="https://www.google.com/search" method="get"><div class="searchbox"><input value="tomcat.apache.org" name="sitesearch" type="hidden"><input aria-label="Search text" placeholder="Search…" required="required" name="q" id="query" type="search"><button>GO</button></div></form><div class="asfevents"><a href="https://www.apache.org/events/current-event.html"><img src="https://www.apache.org/events/current-event-234x60.png" alt="Next ASF event"><br>
+ Save the date!
+ </a></div><nav><div><h2>Apache Tomcat</h2><ul><li><a href="./index.html">Home</a></li><li><a href="./taglibs.html">Taglibs</a></li><li><a href="./maven-plugin.html">Maven Plugin</a></li></ul></div><div><h2>Download</h2><ul><li><a href="./whichversion.html">Which version?</a></li><li><a href="https://tomcat.apache.org/download-90.cgi">Tomcat 9</a></li><li><a href="https://tomcat.apache.org/download-80.cgi">Tomcat 8</a></li><li><a href="https://tomcat.apache.org/download-70.cgi">Tomcat 7</a></li><li><a href="https://tomcat.apache.org/download-connectors.cgi">Tomcat Connectors</a></li><li><a href="https://tomcat.apache.org/download-native.cgi">Tomcat Native</a></li><li><a href="https://tomcat.apache.org/download-taglibs.cgi">Taglibs</a></li><li><a href="https://archive.apache.org/dist/tomcat/">Archives</a></li></ul></div><div><h2>Documentation</h2><ul><li><a href="./tomcat-9.0-doc/index.html">Tomcat 9.0</a></li><li><a href="./tomcat-8.5-doc/index.html">Tomcat 8.5</a></li><l
i><a href="./tomcat-7.0-doc/index.html">Tomcat 7.0</a></li><li><a href="./connectors-doc/">Tomcat Connectors</a></li><li><a href="./native-doc/">Tomcat Native</a></li><li><a href="https://cwiki.apache.org/confluence/display/TOMCAT">Wiki</a></li><li><a href="./migration.html">Migration Guide</a></li><li><a href="./presentations.html">Presentations</a></li></ul></div><div><h2>Problems?</h2><ul><li><a href="./security.html">Security Reports</a></li><li><a href="./findhelp.html">Find help</a></li><li><a href="https://cwiki.apache.org/confluence/display/TOMCAT/FAQ">FAQ</a></li><li><a href="./lists.html">Mailing Lists</a></li><li><a href="./bugreport.html">Bug Database</a></li><li><a href="./irc.html">IRC</a></li></ul></div><div><h2>Get Involved</h2><ul><li><a href="./getinvolved.html">Overview</a></li><li><a href="./source.html">Source code</a></li><li><a href="./ci.html">Buildbot</a></li><li><a href="https://cwiki.apache.org/confluence/x/vIPzBQ">Translations</a></li><li><a href="./tools
.html">Tools</a></li></ul></div><div><h2>Media</h2><ul><li><a href="https://twitter.com/theapachetomcat">Twitter</a></li><li><a href="https://www.youtube.com/c/ApacheTomcatOfficial">YouTube</a></li><li><a href="https://blogs.apache.org/tomcat/">Blog</a></li></ul></div><div><h2>Misc</h2><ul><li><a href="./whoweare.html">Who We Are</a></li><li><a href="https://www.redbubble.com/people/comdev/works/30885254-apache-tomcat">Swag</a></li><li><a href="./heritage.html">Heritage</a></li><li><a href="http://www.apache.org">Apache Home</a></li><li><a href="./resources.html">Resources</a></li><li><a href="./contact.html">Contact</a></li><li><a href="./legal.html">Legal</a></li><li><a href="https://www.apache.org/foundation/contributing.html">Support Apache</a></li><li><a href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li><li><a href="http://www.apache.org/licenses/">License</a></li></ul></div></
nav></div></div><div id="mainRight"><div id="content"><h2 style="display: none;">Content</h2><h3 id="Table_of_Contents">Table of Contents</h3><div class="text">
+<ul><li><a href="#General">General</a></li><li><a href="#Migrating_from_9.0.x_to_10.0.x">Migrating from 9.0.x to 10.0.x</a><ol><li><a href="#Java_8_required">Java 8 required</a></li><li><a href="#Specification_APIs">Specification APIs</a></li><li><a href="#Servlet_5.0_API">Servlet 5.0 API</a></li><li><a href="#Server_Pages_3.0">Server Pages 3.0</a></li><li><a href="#Expression_Language_4.0">Expression Language 4.0</a></li><li><a href="#WebSocket_2.0">WebSocket 2.0</a></li><li><a href="#Authentication_4.0">Authentication 4.0</a></li><li><a href="#Internal_APIs">Internal APIs</a></li><li><a href="#web.xml_defaults">web.xml defaults</a></li><li><a href="#Session_management">Session management</a></li><li><a href="#HTTP/2">HTTP/2</a></li><li><a href="#Logging">Logging</a></li></ol></li><li><a href="#Upgrading_10.0.x">Upgrading 10.0.x</a><ol><li><a href="#Tomcat_10.0.x_noteable_changes">Tomcat 10.0.x noteable changes</a></li><li><a href="#Tomcat_10.0.x_configuration_file_differences">Tom
cat 10.0.x configuration file differences</a></li></ol></li></ul>
+</div><h3 id="General">General</h3><div class="text">
+
+<p>Please read general <a href="migration.html">Migration Guide page</a> first,
+for common considerations that apply to migration or upgrade between versions
+of Apache Tomcat.</p>
+
+</div><h3 id="Migrating_from_9.0.x_to_10.0.x">Migrating from 9.0.x to 10.0.x</h3><div class="text">
+
+ <p>This section lists all the known changes between 9.0.x and 10.0.x
+ which may cause backwards compatibility problems when upgrading.</p>
+
+ <p>Until Tomcat 10 is declared stable, there may be additional changes made
+ that cause backwards compatibility problems when upgrading.</p>
+
+ <div class="subsection"><h4 id="Java_8_required">Java 8 required</h4><div class="text">
+
+ <p>Apache Tomcat 10.0.x requires Java 8 or later. This is unchanged from
+ Tomcat 9.0.x.</p>
+
+ </div></div>
+
+ <div class="subsection"><h4 id="Specification_APIs">Specification APIs</h4><div class="text">
+
+ <p>Apache Tomcat 10 supports the Jakarta Servlet 5.0,
+ Jakarta Server Pages 3.0, Jakarta Expression Language 4.0,
+ JakartaWebSocket 2.0 and Jakarta Authentication 2.0
+ <a href="https://cwiki.apache.org/confluence/display/TOMCAT/Specifications">specifications</a>.
+ </p>
+ <p>There is a significant breaking change between Tomcat 9.0.x and Tomcat
+ 10.0.x. The Java package used by the specification APIs has changed from
+ <scode>javax...</scode> to <scode>jakarta...</scode>.</p>
+
+ </div></div>
+
+ <div class="subsection"><h4 id="Servlet_5.0_API">Servlet 5.0 API</h4><div class="text">
+
+ <p>The Java package has changed from <scode>javax.servlet</scode> to
+ <scode>jakarta.servlet</scode>.</p>
+
+ </div></div>
+
+ <div class="subsection"><h4 id="Server_Pages_3.0">Server Pages 3.0</h4><div class="text">
+
+ <p>The Java package has changed from <scode>javax.servlet.jsp</scode> to
+ <scode>jakarta.servlet.jsp</scode>.</p>
+
+ </div></div>
+
+ <div class="subsection"><h4 id="Expression_Language_4.0">Expression Language 4.0</h4><div class="text">
+
+ <p>The Java package has changed from <scode>javax.el</scode> to
+ <scode>jakarta.el</scode>.</p>
+
+ </div></div>
+
+ <div class="subsection"><h4 id="WebSocket_2.0">WebSocket 2.0</h4><div class="text">
+
+ <p>The Java package has changed from <scode>javax.websocket</scode> to
+ <scode>jakarta.websocket</scode>.</p>
+
+ </div></div>
+
+ <div class="subsection"><h4 id="Authentication_4.0">Authentication 4.0</h4><div class="text">
+
+ <p>The Java package has changed from <scode>javax.security.auth.message</scode> to
+ <scode>jakarta.security.auth.message</scode>.</p>
+
+ </div></div>
+
+ <div class="subsection"><h4 id="Internal_APIs">Internal APIs</h4><div class="text">
+
+ <p>Whilst the Tomcat 10 internal API is broadly compatible with Tomcat 9
+ there have been many changes at the detail level and they are not binary
+ compatible. Developers of custom components that interact with Tomcat's
+ internals should review the JavaDoc for the relevant API.</p>
+
+ <p>Of particular note are:</p>
+ <ul>
+ <li><scode>GenericPrincipal.getPassword()</scode> has been removed.</li>
+ </ul>
+
+ </div></div>
+
+ <div class="subsection"><h4 id="web.xml_defaults">web.xml defaults</h4><div class="text">
+
+ <p><code>conf/web.xml</code> sets the default request and response character
+ encoding to UTF-8.</p>
+
+ </div></div>
+
+ <div class="subsection"><h4 id="Session_management">Session management</h4><div class="text">
+
+ <p>Session persistence on restart has been disabled by default. It may be
+ re-enabled globally in <scode>conf/context.xml</scode> or per web
+ application.</p>
+
+ </div></div>
+
+ <div class="subsection"><h4 id="HTTP/2">HTTP/2</h4><div class="text">
+
+ <p>The configuration settings that were duplicated between the HTTP/1.1 and
+ HTTP/2 connectors have been removed from the HTTP/2 connector which will now
+ inherit them from the associated HTTP/1.1 connector.</p>
+
+ </div></div>
+
+ <div class="subsection"><h4 id="Logging">Logging</h4><div class="text">
+
+ <p>The logging implementation now only creates log files once there is
+ something to write to the log files.</p>
+
+ </div></div>
+
+</div><h3 id="Upgrading_10.0.x">Upgrading 10.0.x</h3><div class="text">
+
+ <p>When upgrading instances of Apache Tomcat from one version of Tomcat 9 to
+ another, particularly when using separate locations for $CATALINA_HOME and
+ $CATALINA_BASE, it is necessary to ensure that any changes in the
+ configuration files such as new attributes and changes to defaults are applied
+ as part of the upgrade. To assist with the identification of these changes,
+ the form below may be used to view the differences between the configuration
+ files in different versions of Tomcat 9.</p>
+
+ <div class="subsection"><h4 id="Tomcat_10.0.x_noteable_changes">Tomcat 10.0.x noteable changes</h4><div class="text">
+ <p>The Tomcat developers aim for each patch release to be fully backwards
+ compatible with the previous release. Occasionally, it is necessary to
+ break backwards compatibility in order to fix a bug. In most cases, these
+ changes will go unnoticed. This section lists changes that are not fully
+ backwards compatible and might cause breakage when upgrading.</p>
+ <ul>
+ <li><p>None as yet.</p></li>
+ </ul>
+ </div></div>
+
+ <div class="subsection"><h4 id="Tomcat_10.0.x_configuration_file_differences">Tomcat 10.0.x configuration file differences</h4><div class="text">
+
+ <p>Select a configuration file, old version and new version from the boxes
+ below and then click "View differences" to see the differences.
+ The differences will be shown in a new tab/window.</p>
+
+ <p><b>Note:</b> If there are no differences you will see an error page.</p>
+
+ <form action="https://gitbox.apache.org/repos/asf" method="get" target="_blank">
+
+ <input type="hidden" name="p" value="tomcat.git">
+ <input type="hidden" name="a" value="blobdiff">
+
+ <p><label>Configuration file:
+ <select name="f">
+ <option value="conf/catalina.policy">catalina.policy</option>
+ <option value="conf/catalina.properties">catalina.properties</option>
+ <option value="conf/context.xml">context.xml</option>
+ <option value="conf/logging.properties">logging.properties</option>
+ <option value="conf/server.xml">server.xml</option>
+ <option value="conf/tomcat-users.xml">tomcat-users.xml</option>
+ <option value="conf/web.xml">web.xml</option>
+ </select></label>
+ </p>
+ <p><label>Old version:
+ <select name="hpb">
+ <option value="10.0.0-M1" selected>10.0.0-M1</option>
+ </select>,</label> <label>new version:
+ <select name="hb">
+ <option value="10.0.0-M1" selected>10.0.0-M1</option>
+ <option value="HEAD">trunk (unreleased)</option>
+ </select></label>
+ </p>
+
+ <p>
+ <button>View Differences</button>
+ </p>
+ </form>
+ <p>You can also use a Git command similar to the following from within a
+ working copy:</p>
+ <div class="codeBox"><pre><code>git diff 10.0.0 10.0.12 -- conf/</code></pre></div>
+ </div></div>
+
+</div></div></div></div></main><footer id="footer">
+ Copyright © 1999-2020, The Apache Software Foundation
+ <br>
+ Apache Tomcat, Tomcat, Apache, the Apache feather, and the Apache Tomcat
+ project logo are either registered trademarks or trademarks of the Apache
+ Software Foundation.
+ </footer></div><script src="res/js/tomcat.js"></script></body></html>
\ No newline at end of file
Propchange: tomcat/site/trunk/docs/migration-10.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: tomcat/site/trunk/xdocs/migration-10.xml
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/xdocs/migration-10.xml?rev=1874319&view=auto
==============================================================================
--- tomcat/site/trunk/xdocs/migration-10.xml (added)
+++ tomcat/site/trunk/xdocs/migration-10.xml Fri Feb 21 13:38:02 2020
@@ -0,0 +1,201 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document>
+
+ <properties>
+ <author>Apache Tomcat Project</author>
+ <title>Migration Guide - Tomcat 10.0.x</title>
+ </properties>
+
+<body>
+
+<section name="Table of Contents">
+<toc/>
+</section>
+
+<section name="General">
+
+<p>Please read general <a href="migration.html">Migration Guide page</a> first,
+for common considerations that apply to migration or upgrade between versions
+of Apache Tomcat.</p>
+
+</section>
+
+<section name="Migrating from 9.0.x to 10.0.x">
+
+ <p>This section lists all the known changes between 9.0.x and 10.0.x
+ which may cause backwards compatibility problems when upgrading.</p>
+
+ <p>Until Tomcat 10 is declared stable, there may be additional changes made
+ that cause backwards compatibility problems when upgrading.</p>
+
+ <subsection name="Java 8 required">
+
+ <p>Apache Tomcat 10.0.x requires Java 8 or later. This is unchanged from
+ Tomcat 9.0.x.</p>
+
+ </subsection>
+
+ <subsection name="Specification APIs">
+
+ <p>Apache Tomcat 10 supports the Jakarta Servlet 5.0,
+ Jakarta Server Pages 3.0, Jakarta Expression Language 4.0,
+ JakartaWebSocket 2.0 and Jakarta Authentication 2.0
+ <a href="https://cwiki.apache.org/confluence/display/TOMCAT/Specifications">specifications</a>.
+ </p>
+ <p>There is a significant breaking change between Tomcat 9.0.x and Tomcat
+ 10.0.x. The Java package used by the specification APIs has changed from
+ <scode>javax...</scode> to <scode>jakarta...</scode>.</p>
+
+ </subsection>
+
+ <subsection name="Servlet 5.0 API">
+
+ <p>The Java package has changed from <scode>javax.servlet</scode> to
+ <scode>jakarta.servlet</scode>.</p>
+
+ </subsection>
+
+ <subsection name="Server Pages 3.0">
+
+ <p>The Java package has changed from <scode>javax.servlet.jsp</scode> to
+ <scode>jakarta.servlet.jsp</scode>.</p>
+
+ </subsection>
+
+ <subsection name="Expression Language 4.0">
+
+ <p>The Java package has changed from <scode>javax.el</scode> to
+ <scode>jakarta.el</scode>.</p>
+
+ </subsection>
+
+ <subsection name="WebSocket 2.0">
+
+ <p>The Java package has changed from <scode>javax.websocket</scode> to
+ <scode>jakarta.websocket</scode>.</p>
+
+ </subsection>
+
+ <subsection name="Authentication 4.0">
+
+ <p>The Java package has changed from <scode>javax.security.auth.message</scode> to
+ <scode>jakarta.security.auth.message</scode>.</p>
+
+ </subsection>
+
+ <subsection name="Internal APIs">
+
+ <p>Whilst the Tomcat 10 internal API is broadly compatible with Tomcat 9
+ there have been many changes at the detail level and they are not binary
+ compatible. Developers of custom components that interact with Tomcat's
+ internals should review the JavaDoc for the relevant API.</p>
+
+ <p>Of particular note are:</p>
+ <ul>
+ <li><scode>GenericPrincipal.getPassword()</scode> has been removed.</li>
+ </ul>
+
+ </subsection>
+
+ <subsection name="web.xml defaults">
+
+ <p><code>conf/web.xml</code> sets the default request and response character
+ encoding to UTF-8.</p>
+
+ </subsection>
+
+ <subsection name="Session management">
+
+ <p>Session persistence on restart has been disabled by default. It may be
+ re-enabled globally in <scode>conf/context.xml</scode> or per web
+ application.</p>
+
+ </subsection>
+
+ <subsection name="HTTP/2">
+
+ <p>The configuration settings that were duplicated between the HTTP/1.1 and
+ HTTP/2 connectors have been removed from the HTTP/2 connector which will now
+ inherit them from the associated HTTP/1.1 connector.</p>
+
+ </subsection>
+
+ <subsection name="Logging">
+
+ <p>The logging implementation now only creates log files once there is
+ something to write to the log files.</p>
+
+ </subsection>
+
+</section>
+
+<section name="Upgrading 10.0.x">
+
+ <p>When upgrading instances of Apache Tomcat from one version of Tomcat 9 to
+ another, particularly when using separate locations for $CATALINA_HOME and
+ $CATALINA_BASE, it is necessary to ensure that any changes in the
+ configuration files such as new attributes and changes to defaults are applied
+ as part of the upgrade. To assist with the identification of these changes,
+ the form below may be used to view the differences between the configuration
+ files in different versions of Tomcat 9.</p>
+
+ <subsection name="Tomcat 10.0.x noteable changes">
+ <p>The Tomcat developers aim for each patch release to be fully backwards
+ compatible with the previous release. Occasionally, it is necessary to
+ break backwards compatibility in order to fix a bug. In most cases, these
+ changes will go unnoticed. This section lists changes that are not fully
+ backwards compatible and might cause breakage when upgrading.</p>
+ <ul>
+ <li><p>None as yet.</p></li>
+ </ul>
+ </subsection>
+
+ <subsection name="Tomcat 10.0.x configuration file differences">
+
+ <p>Select a configuration file, old version and new version from the boxes
+ below and then click "View differences" to see the differences.
+ The differences will be shown in a new tab/window.</p>
+
+ <p><b>Note:</b> If there are no differences you will see an error page.</p>
+
+ <form action="https://gitbox.apache.org/repos/asf"
+ method="get"
+ target="_blank">
+
+ <input type="hidden" name="p" value="tomcat.git"/>
+ <input type="hidden" name="a" value="blobdiff"/>
+
+ <p><label>Configuration file:
+ <select name="f">
+ <option value="conf/catalina.policy">catalina.policy</option>
+ <option value="conf/catalina.properties">catalina.properties</option>
+ <option value="conf/context.xml">context.xml</option>
+ <option value="conf/logging.properties">logging.properties</option>
+ <option value="conf/server.xml">server.xml</option>
+ <option value="conf/tomcat-users.xml">tomcat-users.xml</option>
+ <option value="conf/web.xml">web.xml</option>
+ </select></label>
+ </p>
+ <p><label>Old version:
+ <select name="hpb">
+ <option value="10.0.0-M1" selected="selected">10.0.0-M1</option>
+ </select>,</label> <label>new version:
+ <select name="hb">
+ <option value="10.0.0-M1" selected="selected">10.0.0-M1</option>
+ <option value="HEAD">trunk (unreleased)</option>
+ </select></label>
+ </p>
+
+ <p>
+ <button>View Differences</button>
+ </p>
+ </form>
+ <p>You can also use a Git command similar to the following from within a
+ working copy:</p>
+ <source>git diff 10.0.0 10.0.12 -- conf/</source>
+ </subsection>
+
+</section>
+
+</body>
+</document>
Propchange: tomcat/site/trunk/xdocs/migration-10.xml
------------------------------------------------------------------------------
svn:eol-style = native
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org