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 2013/09/11 16:30:23 UTC
svn commit: r1521874 [5/13] - in /tomcat/site/trunk: docs/ xdocs/stylesheets/
Modified: tomcat/site/trunk/docs/migration-7.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/migration-7.html?rev=1521874&r1=1521873&r2=1521874&view=diff
==============================================================================
--- tomcat/site/trunk/docs/migration-7.html (original)
+++ tomcat/site/trunk/docs/migration-7.html Wed Sep 11 14:30:22 2013
@@ -1,252 +1,683 @@
<!DOCTYPE html SYSTEM "about:legacy-compat">
-<html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><link href="stylesheets/tomcat.css" rel="stylesheet" type="text/css"><!--[if IE]><link href="stylesheets/tomcat-ie-fix.css" rel="stylesheet" type="text/css"/><![endif]--><link href="stylesheets/tomcat-printer.css" rel="stylesheet" type="text/css" media="print"><title>Apache Tomcat - Migration Guide - Tomcat 7.0.x</title><meta name="author" content="Apache Tomcat Project"></head><body><div id="wrapper"><!--[if IE]><div id="header"><![endif]--><!--[if !IE]>--><header id="header"><!--<![endif]--><div><div><div class="logo noPrint"><a href=""><img alt="Tomcat Home" src="./images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo"><a href="http://www.apache.org/" target="_blank"><img src="http://www.apache.org/images/feather.png" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1 style="margin-top: 35px;">Apache Tomcat</h1><div style="clear:
right;"></div><div class="searchbox noPrint"><form action="http://www.google.com/search" method="get"><input value="tomcat.apache.org" name="sitesearch" type="hidden"><input placeholder="Search the Site…" required="required" size="25" name="q" id="query" type="search"><button>Search</button></form></div><div style="height: 1px;"></div><div style="clear: left;"></div></div></div><!--[if IE]></div><![endif]--><!--[if !IE]>--></header><!--<![endif]--><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2><strong>Apache Tomcat</strong></h2><ul><li><a href="./index.html">Home</a></li><li><a href="./taglibs/">Taglibs</a></li><li><a href="./maven-plugin.html">Maven Plugin</a></li></ul></div><div><h2><strong>Download</strong></h2><ul><li><a href="./whichversion.html">Which version?</a></li><li><a href="./download-80.cgi">Tomcat 8.0</a></li><li><a href="./download-70.cgi">Tomcat 7.0</a></li><li><a href="./download-60.cgi">Tomcat 6.0</a></li><li><a href="./download
-connectors.cgi">Tomcat Connectors</a></li><li><a href="./download-native.cgi">Tomcat Native</a></li><li><a href="http://archive.apache.org/dist/tomcat/">Archives</a></li></ul></div><div><h2><strong>Documentation</strong></h2><ul><li><a href="./tomcat-8.0-doc/index.html">Tomcat 8.0</a></li><li><a href="./tomcat-7.0-doc/index.html">Tomcat 7.0</a></li><li><a href="./tomcat-6.0-doc/index.html">Tomcat 6.0</a></li><li><a href="./connectors-doc/">Tomcat Connectors</a></li><li><a href="./native-doc/">Tomcat Native</a></li><li><a href="http://wiki.apache.org/tomcat/FrontPage">Wiki</a></li><li><a href="./migration.html">Migration Guide</a></li></ul></div><div><h2><strong>Problems?</strong></h2><ul><li><a href="./security.html">Security Reports</a></li><li><a href="./findhelp.html">Find help</a></li><li><a href="http://wiki.apache.org/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></l
i></ul></div><div><h2><strong>Get Involved</strong></h2><ul><li><a href="./getinvolved.html">Overview</a></li><li><a href="./svn.html">SVN Repositories</a></li><li><a href="./ci.html">Buildbot</a></li><li><a href="https://reviews.apache.org/groups/tomcat/">Reviewboard</a></li><li><a href="./tools.html">Tools</a></li></ul></div><div><h2><strong>Media</strong></h2><ul><li><a href="http://blogs.apache.org/tomcat/">Blog</a></li><li><a href="http://twitter.com/theapachetomcat">Twitter</a></li></ul></div><div><h2><strong>Misc</strong></h2><ul><li><a href="./whoweare.html">Who We Are</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="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li></ul></di
v></nav></div></div><div id="mainRight"><div id="content"><main><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_6.0.x_to_7.0.x">Migrating from 6.0.x to 7.0.x</a><ol><li><a href="#Java_6_required">Java 6 required</a></li><li><a href="#Servlet_3.0_API">Servlet 3.0 API</a></li><li><a href="#Regular_expressions">Regular expressions</a></li><li><a href="#Deployment">Deployment</a></li><li><a href="#Manager_application">Manager application</a></li><li><a href="#Host_Manager_application">Host Manager application</a></li><li><a href="#Session_manager_configuration">Session manager configuration</a></li><li><a href="#Session_cookie_configuration">Session cookie configuration</a></li><li><a href="#Cookies">Cookies</a></li><li><a href="#Request_attributes">Request attributes</a></li><li><a href="#Comet">Comet</a></li><li><a href="#XML_validation">XML validation</a></li><li><a href="#System_properties">System properties</a></li><li><a href="#Processing_of_conf/web.xml_file">Processing of conf/web.xml file</a></li><li><a href="#Welcom
e_files_processing">Welcome files processing</a></li><li><a href="#Annotation_scanning">Annotation scanning</a></li><li><a href="#TLD_processing">TLD processing</a></li><li><a href="#Internal_APIs">Internal APIs</a></li></ol></li><li><a href="#Upgrading_7.0.x">Upgrading 7.0.x</a><ol><li><a href="#Tomcat_7.0.x_configuration_file_differences">Tomcat 7.0.x configuration file differences</a></li></ol></li></ul>
-</div><h3 id="General">General</h3><div class="text">
+<html lang="en">
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<link href="stylesheets/tomcat.css" rel="stylesheet" type="text/css">
+<!--[if IE]><link href="stylesheets/tomcat-ie-fix.css" rel="stylesheet" type="text/css"/><![endif]-->
+<link href="stylesheets/tomcat-printer.css" rel="stylesheet" type="text/css" media="print">
+<title>Apache Tomcat - Migration Guide - Tomcat 7.0.x</title>
+<meta name="author" content="Apache Tomcat Project">
+</head>
+<body>
+<div id="wrapper">
+<!--[if IE]><div id="header"><![endif]-->
+<!--[if !IE]>-->
+<header id="header">
+<!--<![endif]-->
+<div>
+<div>
+<div class="logo noPrint">
+<a href=""><img alt="Tomcat Home" src="./images/tomcat.png"></a>
+</div>
+<div style="height: 1px;"></div>
+<div class="asfLogo">
+<a href="http://www.apache.org/" target="_blank"><img src="http://www.apache.org/images/feather.png" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a>
+</div>
+<h1 style="margin-top: 35px;">Apache Tomcat</h1>
+<div style="clear: right;"></div>
+<div class="searchbox noPrint">
+<form action="http://www.google.com/search" method="get">
+<input value="tomcat.apache.org" name="sitesearch" type="hidden"><input placeholder="Search the Site…" required="required" size="25" name="q" id="query" type="search"><button>Search</button>
+</form>
+</div>
+<div style="height: 1px;"></div>
+<div style="clear: left;"></div>
+</div>
+</div>
+<!--[if IE]></div><![endif]-->
+<!--[if !IE]>-->
+</header>
+<!--<![endif]-->
+<div id="middle">
+<div>
+<div id="mainLeft" class="noprint">
+<div>
+<nav>
+<div>
+<h2>
+<strong>Apache Tomcat</strong>
+</h2>
+<ul>
+<li>
+<a href="./index.html">Home</a>
+</li>
+<li>
+<a href="./taglibs/">Taglibs</a>
+</li>
+<li>
+<a href="./maven-plugin.html">Maven Plugin</a>
+</li>
+</ul>
+</div>
+<div>
+<h2>
+<strong>Download</strong>
+</h2>
+<ul>
+<li>
+<a href="./whichversion.html">Which version?</a>
+</li>
+<li>
+<a href="./download-80.cgi">Tomcat 8.0</a>
+</li>
+<li>
+<a href="./download-70.cgi">Tomcat 7.0</a>
+</li>
+<li>
+<a href="./download-60.cgi">Tomcat 6.0</a>
+</li>
+<li>
+<a href="./download-connectors.cgi">Tomcat Connectors</a>
+</li>
+<li>
+<a href="./download-native.cgi">Tomcat Native</a>
+</li>
+<li>
+<a href="http://archive.apache.org/dist/tomcat/">Archives</a>
+</li>
+</ul>
+</div>
+<div>
+<h2>
+<strong>Documentation</strong>
+</h2>
+<ul>
+<li>
+<a href="./tomcat-8.0-doc/index.html">Tomcat 8.0</a>
+</li>
+<li>
+<a href="./tomcat-7.0-doc/index.html">Tomcat 7.0</a>
+</li>
+<li>
+<a href="./tomcat-6.0-doc/index.html">Tomcat 6.0</a>
+</li>
+<li>
+<a href="./connectors-doc/">Tomcat Connectors</a>
+</li>
+<li>
+<a href="./native-doc/">Tomcat Native</a>
+</li>
+<li>
+<a href="http://wiki.apache.org/tomcat/FrontPage">Wiki</a>
+</li>
+<li>
+<a href="./migration.html">Migration Guide</a>
+</li>
+</ul>
+</div>
+<div>
+<h2>
+<strong>Problems?</strong>
+</h2>
+<ul>
+<li>
+<a href="./security.html">Security Reports</a>
+</li>
+<li>
+<a href="./findhelp.html">Find help</a>
+</li>
+<li>
+<a href="http://wiki.apache.org/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>
+<strong>Get Involved</strong>
+</h2>
+<ul>
+<li>
+<a href="./getinvolved.html">Overview</a>
+</li>
+<li>
+<a href="./svn.html">SVN Repositories</a>
+</li>
+<li>
+<a href="./ci.html">Buildbot</a>
+</li>
+<li>
+<a href="https://reviews.apache.org/groups/tomcat/">Reviewboard</a>
+</li>
+<li>
+<a href="./tools.html">Tools</a>
+</li>
+</ul>
+</div>
+<div>
+<h2>
+<strong>Media</strong>
+</h2>
+<ul>
+<li>
+<a href="http://blogs.apache.org/tomcat/">Blog</a>
+</li>
+<li>
+<a href="http://twitter.com/theapachetomcat">Twitter</a>
+</li>
+</ul>
+</div>
+<div>
+<h2>
+<strong>Misc</strong>
+</h2>
+<ul>
+<li>
+<a href="./whoweare.html">Who We Are</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="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
+</li>
+<li>
+<a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</li>
+</ul>
+</div>
+</nav>
+</div>
+</div>
+<div id="mainRight">
+<div id="content">
+<main>
+<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_6.0.x_to_7.0.x">Migrating from 6.0.x to 7.0.x</a>
+<ol>
+<li>
+<a href="#Java_6_required">Java 6 required</a>
+</li>
+<li>
+<a href="#Servlet_3.0_API">Servlet 3.0 API</a>
+</li>
+<li>
+<a href="#Regular_expressions">Regular expressions</a>
+</li>
+<li>
+<a href="#Deployment">Deployment</a>
+</li>
+<li>
+<a href="#Manager_application">Manager application</a>
+</li>
+<li>
+<a href="#Host_Manager_application">Host Manager application</a>
+</li>
+<li>
+<a href="#Session_manager_configuration">Session manager configuration</a>
+</li>
+<li>
+<a href="#Session_cookie_configuration">Session cookie configuration</a>
+</li>
+<li>
+<a href="#Cookies">Cookies</a>
+</li>
+<li>
+<a href="#Request_attributes">Request attributes</a>
+</li>
+<li>
+<a href="#Comet">Comet</a>
+</li>
+<li>
+<a href="#XML_validation">XML validation</a>
+</li>
+<li>
+<a href="#System_properties">System properties</a>
+</li>
+<li>
+<a href="#Processing_of_conf/web.xml_file">Processing of conf/web.xml file</a>
+</li>
+<li>
+<a href="#Welcome_files_processing">Welcome files processing</a>
+</li>
+<li>
+<a href="#Annotation_scanning">Annotation scanning</a>
+</li>
+<li>
+<a href="#TLD_processing">TLD processing</a>
+</li>
+<li>
+<a href="#Internal_APIs">Internal APIs</a>
+</li>
+</ol>
+</li>
+<li>
+<a href="#Upgrading_7.0.x">Upgrading 7.0.x</a>
+<ol>
+<li>
+<a href="#Tomcat_7.0.x_configuration_file_differences">Tomcat 7.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_6.0.x_to_7.0.x">Migrating from 6.0.x to 7.0.x</h3><div class="text">
- <p> This section lists all the known changes between 6.0.x and 7.0.x which may
+</div>
+<h3 id="Migrating_from_6.0.x_to_7.0.x">Migrating from 6.0.x to 7.0.x</h3>
+<div class="text">
+
+
+<p> This section lists all the known changes between 6.0.x and 7.0.x which may
cause backwards compatibility problems when upgrading.</p>
- <div class="subsection"><h4 id="Java_6_required">Java 6 required</h4><div class="text">
+
+<div class="subsection">
+<h4 id="Java_6_required">Java 6 required</h4>
+<div class="text">
- <p>Apache Tomcat 7.0.x requires Java 6 or later. Apache Tomcat 6.0.x
+
+<p>Apache Tomcat 7.0.x requires Java 6 or later. Apache Tomcat 6.0.x
required Java 5.</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="Servlet_3.0_API">Servlet 3.0 API</h4><div class="text">
+
+<div class="subsection">
+<h4 id="Servlet_3.0_API">Servlet 3.0 API</h4>
+<div class="text">
- <p>Apache Tomcat 7 supports Java Servlet 3.0, JavaServer Pages 2.2 and
+
+<p>Apache Tomcat 7 supports Java Servlet 3.0, JavaServer Pages 2.2 and
Expression Language 2.2
<a href="http://wiki.apache.org/tomcat/Specifications">specifications</a>.
The changes between versions of specifications may be found in the
<em>Changes</em> appendix in each of specification documents.
</p>
- <p>In JSP pages that use wildcard import syntax the new classes added in
+
+<p>In JSP pages that use wildcard import syntax the new classes added in
Servlet API may conflict with ones in web applications.
For example, if package <code>"a"</code> contains class <code>Part</code>,
the following JSP page will cease to compile in Tomcat 7:</p>
- <div class="codeBox"><pre><code>
+
+<div class="codeBox">
+<pre>
+<code>
<%@page import="a.*"%>
-<% Part page = new Part(); %></code></pre></div>
+<% Part page = new Part(); %></code>
+</pre>
+</div>
- <p>That happens because implicit import of <code>javax.servlet.http.*</code>
+
+<p>That happens because implicit import of <code>javax.servlet.http.*</code>
and explicit import of <code>a.*</code> will provide conflicting
definitions of class <code>Part</code> that was added in Servlet 3.0.
The solution is to use explicit import, <code>import="a.Part"</code>.</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="Regular_expressions">Regular expressions</h4><div class="text">
+
+<div class="subsection">
+<h4 id="Regular_expressions">Regular expressions</h4>
+<div class="text">
- <p>All configuration options that use regular expression now require a
+
+<p>All configuration options that use regular expression now require a
single regular expression (using <code>java.util.regex</code>) rather than a
list of comma-separated or semi-colon-separated expressions.</p>
- <p>This concerns the following:</p>
+
+<p>This concerns the following:</p>
- <ul>
- <li><code>allow</code> and <code>deny</code> attributes in
+
+<ul>
+
+<li>
+<code>allow</code> and <code>deny</code> attributes in
RemoteAddrFilter, RemoteHostFilter
<a href="/tomcat-7.0-doc/config/filter.html">filters</a>
and in RemoteAddrValve, RemoteHostValve
<a href="/tomcat-7.0-doc/config/valve.html">valves</a>;
</li>
- <li><code>internalProxies</code>, <code>trustedProxies</code> attributes in
+
+<li>
+<code>internalProxies</code>, <code>trustedProxies</code> attributes in
<a href="/tomcat-7.0-doc/config/filter.html">RemoteIpFilter</a>,
<a href="/tomcat-7.0-doc/config/valve.html">RemoteIpValve</a>;
</li>
- <li><code>filter</code> attribute in
+
+<li>
+<code>filter</code> attribute in
<a href="/tomcat-7.0-doc/config/cluster-valve.html">ReplicationValve</a>;</li>
- <li><code>restrictedUserAgents</code>, <code>noCompressionUserAgents</code>
+
+<li>
+<code>restrictedUserAgents</code>, <code>noCompressionUserAgents</code>
attributes in
<a href="/tomcat-7.0-doc/config/http.html">HTTP connectors</a>.</li>
- </ul>
+
+</ul>
- <p>Note that separate regular expressions can be concatenated using the
+
+<p>Note that separate regular expressions can be concatenated using the
"<code>|</code>" operator (or). Using "<code>|</code>" works both in this
and in earlier Tomcat versions.</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="Deployment">Deployment</h4><div class="text">
- <p>XML context descriptors (<code>META-INF/context.xml</code> files)
+<div class="subsection">
+<h4 id="Deployment">Deployment</h4>
+<div class="text">
+
+
+<p>XML context descriptors (<code>META-INF/context.xml</code> files)
are no longer copied from deployed WARs and directories to the host's
<code>xmlBase</code>. The default
Tomcat 6 behavior can be enabled by setting the <code>copyXML</code>
attribute of the <strong>Host</strong> element to <code>true</code>.</p>
- <p>The WARs outside of the host's <code>appBase</code> are no longer
+
+<p>The WARs outside of the host's <code>appBase</code> are no longer
unpacked, regardless of the value of the <code>Host</code>'s
<code>unpackWARs</code> setting. See issue
<a href="https://issues.apache.org/bugzilla/show_bug.cgi?id=51294#c1">51294</a>.
</p>
- </div></div>
- <div class="subsection"><h4 id="Manager_application">Manager application</h4><div class="text">
+</div>
+</div>
- <p>The Manager application has been re-structured for Tomcat 7 onwards and
+
+<div class="subsection">
+<h4 id="Manager_application">Manager application</h4>
+<div class="text">
+
+
+<p>The Manager application has been re-structured for Tomcat 7 onwards and
some URLs have changed. All URLs used to access the Manager application
should now start with one of the following options:</p>
- <ul>
- <li><ContextPath>/html for the HTML GUI</li>
- <li><ContextPath>/text for the text interface</li>
- <li><ContextPath>/jmxproxy for the JMX proxy</li>
- <li><ContextPath>/status for the status pages</li>
- </ul>
- <p>Note that the URL for the text interface has changed from
+<ul>
+
+<li><ContextPath>/html for the HTML GUI</li>
+
+<li><ContextPath>/text for the text interface</li>
+
+<li><ContextPath>/jmxproxy for the JMX proxy</li>
+
+<li><ContextPath>/status for the status pages</li>
+
+</ul>
+
+
+<p>Note that the URL for the text interface has changed from
"<ContextPath>" to "<ContextPath>/text".</p>
- <p>The roles required to use the Manager application were changed from the
+
+<p>The roles required to use the Manager application were changed from the
single <code>manager</code> role to the following four roles. You will need to
assign the role(s) required for the functionality you wish to access.</p>
- <ul>
- <li><code>manager-gui</code> - allows access to the HTML GUI
+
+<ul>
+
+<li>
+<code>manager-gui</code> - allows access to the HTML GUI
and the status pages</li>
- <li><code>manager-script</code> - allows access to the text interface
+
+<li>
+<code>manager-script</code> - allows access to the text interface
and the status pages</li>
- <li><code>manager-jmx</code> - allows access to the JMX proxy
+
+<li>
+<code>manager-jmx</code> - allows access to the JMX proxy
and the status pages</li>
- <li><code>manager-status</code> - allows access to
+
+<li>
+<code>manager-status</code> - allows access to
the status pages only</li>
- </ul>
+
+</ul>
- <p>The HTML interface is protected against CSRF but the text and JMX
+
+<p>The HTML interface is protected against CSRF but the text and JMX
interfaces are not. To maintain the CSRF protection:</p>
- <ul>
- <li>users with the <tt>manager-gui</tt> role should not be granted
+
+<ul>
+
+<li>users with the <tt>manager-gui</tt> role should not be granted
either the <tt>manager-script</tt> or <tt>manager-jmx</tt> roles.</li>
- <li>if the Manager application is accessed through a browser by a user
+
+<li>if the Manager application is accessed through a browser by a user
who has <tt>manager-script</tt> or <tt>manager-jmx</tt> roles
(e.g. for testing the text or jmx interfaces since these interfaces
are intended for tools not humans) then all browser windows
must be closed afterwards to terminate the session.</li>
- </ul>
+
+</ul>
- <p>The roles command has been removed from the Manager application since it
+
+<p>The roles command has been removed from the Manager application since it
did not work with the default configuration and most Realms do not support
providing a list of roles.</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="Host_Manager_application">Host Manager application</h4><div class="text">
- <p>The Host Manager application has been re-structured for Tomcat 7 onwards
+<div class="subsection">
+<h4 id="Host_Manager_application">Host Manager application</h4>
+<div class="text">
+
+
+<p>The Host Manager application has been re-structured for Tomcat 7 onwards
and some URLs have changed. All URLs used to access the Host Manager
application should now start with one of the following options:</p>
- <ul>
- <li><ContextPath>/html for the HTML GUI</li>
- <li><ContextPath>/text for the text interface</li>
- </ul>
- <p>Note that the URL for the text interface has changed from
+<ul>
+
+<li><ContextPath>/html for the HTML GUI</li>
+
+<li><ContextPath>/text for the text interface</li>
+
+</ul>
+
+
+<p>Note that the URL for the text interface has changed from
"<ContextPath>" to "<ContextPath>/text".</p>
- <p>The roles required to use the Host Manager application were changed from
+
+<p>The roles required to use the Host Manager application were changed from
the single <code>admin</code> role to the following two roles. You will need to
assign the role(s) required for the functionality you wish to access.</p>
- <ul>
- <li><code>admin-gui</code> - allows access to the HTML GUI
+
+<ul>
+
+<li>
+<code>admin-gui</code> - allows access to the HTML GUI
and the status pages</li>
- <li><code>admin-script</code> - allows access to the text interface
+
+<li>
+<code>admin-script</code> - allows access to the text interface
and the status pages</li>
- </ul>
+
+</ul>
- <p>The HTML interface is protected against CSRF but the text interface is
+
+<p>The HTML interface is protected against CSRF but the text interface is
not. To maintain the CSRF protection:</p>
- <ul>
- <li>users with the <tt>admin-gui</tt> role should not be granted the
+
+<ul>
+
+<li>users with the <tt>admin-gui</tt> role should not be granted the
<tt>admin-script</tt> role.</li>
- <li>if the Host Manager application is accessed through a browser
+
+<li>if the Host Manager application is accessed through a browser
by a user who has <tt>admin-script</tt> role (e.g. for testing
the text interface since this inteface is intended for tools
not humans) then all browser windows
must be closed afterwards to terminate the session.</li>
- </ul>
+
+</ul>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="Session_manager_configuration">Session manager configuration</h4><div class="text">
- <p>A number of changes have been made to the session manager to improve the
+
+<div class="subsection">
+<h4 id="Session_manager_configuration">Session manager configuration</h4>
+<div class="text">
+
+<p>A number of changes have been made to the session manager to improve the
performance of session generation and destruction including changes to
session ID generation. The session ID generation changes take advantages of
improvements in <code>java.secure.SecureRandom</code> since the session ID
generation was first written. The configuration changes are:</p>
- <ul>
- <li><code>randomClass</code> attribute of <strong>Manager</strong>
+
+<ul>
+
+<li>
+<code>randomClass</code> attribute of <strong>Manager</strong>
has changed to <code>secureRandomClass</code> and the provided class
- must extend <code>java.secure.SecureRandom</code></li>
- <li>Two new properties <code>secureRandomAlgoithm</code> and
+ must extend <code>java.secure.SecureRandom</code>
+</li>
+
+<li>Two new properties <code>secureRandomAlgoithm</code> and
<code>secureRandomProvider</code> have been added to enable the selection
of a SecureRandom implementation.</li>
- <li>The <code>algorithm</code> attribute has been removed</li>
- <li>The <code>entropy</code> attribute has been removed</li>
- </ul>
+
+<li>The <code>algorithm</code> attribute has been removed</li>
+
+<li>The <code>entropy</code> attribute has been removed</li>
+
+</ul>
- <p>One known issue with <code>java.secure.SecureRandom</code> is that
+
+<p>One known issue with <code>java.secure.SecureRandom</code> is that
it initialization requires some random data from an entropy source. With
some entropy source implementations it may require some time to gather
enough random data. If initialization of session id generator takes
noticeable time (more than 100ms), a diagnostic message will be logged.
E.g.:</p>
- <p>
- <code><em>DATE</em> org.apache.catalina.util.SessionIdGenerator createSecureRandom</code><br>
- <code>INFO: Creation of SecureRandom instance for session ID generation using [SHA1PRNG] took [406] milliseconds.</code>
- </p>
+
+<p>
+
+<code><em>DATE</em> org.apache.catalina.util.SessionIdGenerator createSecureRandom</code>
+<br>
+
+<code>INFO: Creation of SecureRandom instance for session ID generation using [SHA1PRNG] took [406] milliseconds.</code>
+
+</p>
- <p>It is possible to change the entropy source used by JRE by defining
+
+<p>It is possible to change the entropy source used by JRE by defining
a system property. E.g.:<br>
- <code>-Djava.security.egd=file:/dev/./urandom</code></p>
+
+<code>-Djava.security.egd=file:/dev/./urandom</code>
+</p>
- <p>The "/./" characters in the above value are to workaround
+
+<p>The "/./" characters in the above value are to workaround
<a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6202721">JRE issue #6202721</a>.</p>
- </div></div>
- <div class="subsection"><h4 id="Session_cookie_configuration">Session cookie configuration</h4><div class="text">
+</div>
+</div>
+
+
+<div class="subsection">
+<h4 id="Session_cookie_configuration">Session cookie configuration</h4>
+<div class="text">
- <p>With the addition of <code>SessionCookieConfig</code> in the Servlet 3.0
+
+<p>With the addition of <code>SessionCookieConfig</code> in the Servlet 3.0
specification, a number of session cookie configuration options have been
removed to reduce configuration and code complexity.</p>
- <ul>
- <li><strong>Connector</strong><code>.emptySessionPath</code>: This has been removed. An equivalent
+
+<ul>
+
+<li>
+<strong>Connector</strong><code>.emptySessionPath</code>: This has been removed. An equivalent
effect can be obtained by configuring sessionCookiePath="/" in the global
context.xml (in <code>CATALINA_BASE/conf/context.xml</code>).</li>
- <li><code>org.apache.catalina.SESSION_COOKIE_NAME</code> system property: This has been
+
+<li>
+<code>org.apache.catalina.SESSION_COOKIE_NAME</code> system property: This has been
removed. An equivalent effect can be obtained by configuring the
<code>sessionCookieName</code> attribute for the global context.xml
(in <code>CATALINA_BASE/conf/context.xml</code>).</li>
- <li><code>org.apache.catalina.SESSION_PARAMETER_NAME</code> system property: This has
+
+<li>
+<code>org.apache.catalina.SESSION_PARAMETER_NAME</code> system property: This has
been removed. An equivalent effect can be obtained by configuring the
<code>sessionCookieName</code> attribute for the global context.xml
(in <code>CATALINA_BASE/conf/context.xml</code>).</li>
- <li><strong>Context</strong><code>.disableURLRewriting</code>: This has
+
+<li>
+<strong>Context</strong><code>.disableURLRewriting</code>: This has
been removed. An equivalent effect can be obtained by configuring the
<code>session-config/tracking-mode</code> elements in a web application
or in the global <code>CATALINA_BASE/conf/web.xml</code> file.</li>
- </ul>
+
+</ul>
- <p>The session and SSO cookies in Tomcat 7 are being sent with HttpOnly
+
+<p>The session and SSO cookies in Tomcat 7 are being sent with HttpOnly
flag by default, to instruct browsers to prevent access to those cookies
from JavaScript. This is considered more secure, but it will prevent
JavaScripts from accessing the value of the cookie.
@@ -258,41 +689,65 @@ of Apache Tomcat.</p>
a web application or in the global
<code>CATALINA_BASE/conf/context.xml</code> file).</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="Cookies">Cookies</h4><div class="text">
+
+<div class="subsection">
+<h4 id="Cookies">Cookies</h4>
+<div class="text">
- <p>Tomcat no longer accepts non-specification compliant name-only cookies by
+
+<p>Tomcat no longer accepts non-specification compliant name-only cookies by
default. However, a new system property has been added,
<code>org.apache.tomcat.util.http.ServerCookie.ALLOW_NAME_ONLY</code>, that
can be used to accept name-only cookies.</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="Request_attributes">Request attributes</h4><div class="text">
+
+<div class="subsection">
+<h4 id="Request_attributes">Request attributes</h4>
+<div class="text">
- <p>The custom request attribute
+
+<p>The custom request attribute
<code>javax.servlet.request.ssl_session</code> provided to access the SSL
session ID has been deprecated in favour of the new standard request
attribute that is defined in the Servlet specification,
<code>javax.servlet.request.ssl_session_id</code>. Support
for the custom attribute will be removed in Tomcat 8.</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="Comet">Comet</h4><div class="text">
+
+<div class="subsection">
+<h4 id="Comet">Comet</h4>
+<div class="text">
- <p>To enable Comet to work correctly when running under a security manager,
+
+<p>To enable Comet to work correctly when running under a security manager,
the Comet classes have been moved from the <code>org.apache.catalina</code>
package to the <code>org.apache.catalina.comet</code> package. Code that
uses Comet will need to be updated and recompiled to reflect the new
package name.</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="XML_validation">XML validation</h4><div class="text">
- <p>The configuration of XML validation has been simplified. The
+<div class="subsection">
+<h4 id="XML_validation">XML validation</h4>
+<div class="text">
+
+
+<p>The configuration of XML validation has been simplified. The
<code>xmlValidation</code> and <code>xmlNamespaceAware</code> attributes
have been removed from the <strong>Host</strong> element. These
attributes, along with <code>tldValidation</code> and
@@ -304,11 +759,17 @@ of Apache Tomcat.</p>
property is set to <code>true</code>, XML validation and namespace
awareness will be enabled by default.</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="System_properties">System properties</h4><div class="text">
+
+<div class="subsection">
+<h4 id="System_properties">System properties</h4>
+<div class="text">
- <p>The <code>org.apache.catalina.STRICT_SERVLET_COMPLIANCE</code> system
+
+<p>The <code>org.apache.catalina.STRICT_SERVLET_COMPLIANCE</code> system
property has been modified to provide greater control over its effects. Each
behavioural change is now controlled by a dedicated system property. The
default behaviour is unchanged. The
@@ -319,20 +780,28 @@ of Apache Tomcat.</p>
<code>true</code>, setting the individual system properties will always take
priority.</p>
- <p>The <code>org.apache.coyote.MAX_TRAILER_SIZE</code> has been removed and
+
+<p>The <code>org.apache.coyote.MAX_TRAILER_SIZE</code> has been removed and
is replaced by the maxTrailerSize attribute of the
<strong>Connector</strong>.</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="Processing_of_conf/web.xml_file">Processing of conf/web.xml file</h4><div class="text">
+
+<div class="subsection">
+<h4 id="Processing_of_conf/web.xml_file">Processing of conf/web.xml file</h4>
+<div class="text">
- <p>Servlet 3.0 specification defines how web.xml file of an application
+
+<p>Servlet 3.0 specification defines how web.xml file of an application
can be combined from web fragments and annotations. Processing of the
global <code>conf/web.xml</code> file that defines server-wide defaults
was changed as a result of implementing those rules.</p>
- <p>One noticeable
+
+<p>One noticeable
difference is that Filters defined in the global <code>conf/web.xml</code>
now follow the ones defined in a web application, instead of preceding
them. See issues
@@ -341,22 +810,34 @@ of Apache Tomcat.</p>
<a href="https://issues.apache.org/bugzilla/show_bug.cgi?id=52138#c4">52138</a>
for clarifications.</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="Welcome_files_processing">Welcome files processing</h4><div class="text">
+
+<div class="subsection">
+<h4 id="Welcome_files_processing">Welcome files processing</h4>
+<div class="text">
- <p>The welcome file processing was changed to follow clarifications in the
+
+<p>The welcome file processing was changed to follow clarifications in the
Servlet 3.0 specification. If your list of welcome files includes ones that
are processed by a servlet (such as *.jsp), you may observe the change in
behaviour. See the <code>resourceOnlyServlets</code> option on
<strong>Context</strong>.
</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="Annotation_scanning">Annotation scanning</h4><div class="text">
+
+<div class="subsection">
+<h4 id="Annotation_scanning">Annotation scanning</h4>
+<div class="text">
- <p>The annotation scanning required by the Servlet 3.0 specification
+
+<p>The annotation scanning required by the Servlet 3.0 specification
may have impact on the startup time of your web application, as well as
increase requirements on the memory needed to load scanned classes.
Note, that upon clarification from the Servlet EG, even applications
@@ -366,33 +847,41 @@ of Apache Tomcat.</p>
and related discussions on the users mailing list.
</p>
- <p>There are several ways to deal with this issue. The recommended way is
+
+<p>There are several ways to deal with this issue. The recommended way is
to mark those applications that do not require annotation scanning as such.
It can be done in the <code>WEB-INF/web.xml</code> of your application by
the following steps:</p>
- <ul>
- <li>
+
+<ul>
+
+<li>
Update the <code>web-app</code> element to indicate that the web
application is using specification version 3.0. You may copy the values
for the <code>version</code>, <code>xsi:schemaLocation</code>,
<code>xmlns</code> and <code>xmlns:xsi</code> attributes from the default
<code>conf/web.xml</code> file.
</li>
- <li>
+
+<li>
Add <code>metadata-complete="true"</code> attribute to the
<code>web-app</code> element.
</li>
- <li>
+
+<li>
Add an empty <code><absolute-ordering /></code> element.
</li>
- </ul>
+
+</ul>
- <p>The <code>metadata-complete</code> attribute is supported starting with
+
+<p>The <code>metadata-complete</code> attribute is supported starting with
Servlet 2.5 specification. The <code>absolute-ordering</code> element
requires Servlet 3.0.</p>
- <p>The second way is to configure JarScanner component to ignore certain JAR
+
+<p>The second way is to configure JarScanner component to ignore certain JAR
files according to their names. This is usually configured in the
<code>conf/catalina.properties</code> file. See documentation on the
<code>jarsToSkip</code> properties in the
@@ -403,41 +892,69 @@ of Apache Tomcat.</p>
and web application fragments), TLD scanning (tag libraries) or both.
Further versions of Tomcat may provide better ways to control this feature.</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="TLD_processing">TLD processing</h4><div class="text">
- <p>There have been a number of improvements to TLD processing. In addition
+
+<div class="subsection">
+<h4 id="TLD_processing">TLD processing</h4>
+<div class="text">
+
+<p>There have been a number of improvements to TLD processing. In addition
to some internal refactoring to improve consistency and reduce duplication,
there are a number of functional improvements. These are:</p>
- <ul>
- <li>EL processing within tag files is now consistent with the JSP version
+
+<ul>
+
+<li>EL processing within tag files is now consistent with the JSP version
declared for the tag file.</li>
- <li>The requirements of section JSP.7.3.1 of the JSP specification are
+
+<li>The requirements of section JSP.7.3.1 of the JSP specification are
now enforced and TLD files are not permitted to be placed in
<code>WEB-INF/lib</code> or <code>WEB-INF/classes</code>.</li>
- </ul>
- </div></div>
+
+</ul>
+
+</div>
+</div>
+
- <div class="subsection"><h4 id="Internal_APIs">Internal APIs</h4><div class="text">
+<div class="subsection">
+<h4 id="Internal_APIs">Internal APIs</h4>
+<div class="text">
- <p>Whilst the Tomcat 7 internal API is broadly compatible with Tomcat 6
+
+<p>Whilst the Tomcat 7 internal API is broadly compatible with Tomcat 6
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>A standard implementation of the Lifecycle interface that all
+
+<p>Of particular note are:</p>
+
+<ul>
+
+<li>A standard implementation of the Lifecycle interface that all
components extend.</li>
- <li>Use of generics.</li>
- <li>The use of Context name rather than Context path as the unique
+
+<li>Use of generics.</li>
+
+<li>The use of Context name rather than Context path as the unique
identifier for a Context within a Host.</li>
- </ul>
+
+</ul>
+
+
+</div>
+</div>
- </div></div>
-</div><h3 id="Upgrading_7.0.x">Upgrading 7.0.x</h3><div class="text">
- <p>When upgrading instances of Apache Tomcat from one version of Tomcat 7 to
+</div>
+<h3 id="Upgrading_7.0.x">Upgrading 7.0.x</h3>
+<div class="text">
+
+<p>When upgrading instances of Apache Tomcat from one version of Tomcat 7 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
@@ -445,13 +962,18 @@ of Apache Tomcat.</p>
the form below may be used to view the differences between the configuration
files in different versions of Tomcat 7.</p>
- <div class="subsection"><h4 id="Tomcat_7.0.x_configuration_file_differences">Tomcat 7.0.x configuration file differences</h4><div class="text">
+
+<div class="subsection">
+<h4 id="Tomcat_7.0.x_configuration_file_differences">Tomcat 7.0.x configuration file differences</h4>
+<div class="text">
- <p>Select a configuration file, old version and new version from the boxes
+
+<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>
- <script type="text/javascript" language="JavaScript">
+
+<script type="text/javascript" language="JavaScript">
function updateTc7ActionUrl() {
var revisions = {
"HEAD":"HEAD",
@@ -497,8 +1019,10 @@ of Apache Tomcat.</p>
}
</script>
- <form id="tc7Select" action="not-used">
- <p>Configuration file:
+
+<form id="tc7Select" action="not-used">
+
+<p>Configuration file:
<select name="filename">
<option value="conf/catalina.policy">catalina.policy</option>
<option value="conf/catalina.properties">catalina.properties</option>
@@ -508,8 +1032,10 @@ of Apache Tomcat.</p>
<option value="conf/tomcat-users.xml">tomcat-users.xml</option>
<option value="conf/web.xml">web.xml</option>
</select>
- </p>
- <p>Old version:
+
+</p>
+
+<p>Old version:
<select name="r1">
<option value="7.0.0">7.0.0</option>
<option value="7.0.2">7.0.2</option>
@@ -577,25 +1103,50 @@ of Apache Tomcat.</p>
<option value="7.0.42" selected>7.0.42</option>
<option value="HEAD">trunk (unreleased)</option>
</select>
- </p>
- </form>
- <form id="tc7Submit" action="to-be-replaced" method="get" target="_blank">
- <p>
- <input type="hidden" name="diff_format" value="h">
+
+</p>
+
+</form>
+
+<form id="tc7Submit" action="to-be-replaced" method="get" target="_blank">
+
+<p>
+
+<input type="hidden" name="diff_format" value="h">
<input type="hidden" name="r1"><input type="hidden" name="r2">
<input type="submit" value="View Differences" onClick="return updateTc7ActionUrl();">
- </p>
- </form>
- <p>You can also use Subversion command similar to the following (all on one line):</p>
- <pre> svn diff
+
+</p>
+
+</form>
+
+<p>You can also use Subversion command similar to the following (all on one line):</p>
+
+<pre> svn diff
--old=http://svn.apache.org/repos/asf/tomcat/tc7.0.x/tags/TOMCAT_7_0_27/conf/
--new=http://svn.apache.org/repos/asf/tomcat/tc7.0.x/tags/TOMCAT_7_0_28/conf/
</pre>
- </div></div>
-</div></main></div></div></div></div><!--[if IE]><div id="footer"><![endif]--><!--[if !IE]>--><footer id="footer"><!--<![endif]-->
+</div>
+</div>
+
+
+</div>
+</main>
+</div>
+</div>
+</div>
+</div>
+<!--[if IE]><div id="footer"><![endif]-->
+<!--[if !IE]>-->
+<footer id="footer">
+<!--<![endif]-->
Copyright © 1999-2013, The Apache Software Foundation
<br>
Apache Tomcat, Tomcat, Apache, the Apache feather, and the Apache Tomcat
project logo are trademarks of the Apache Software Foundation.
- <!--[if IE]></div><![endif]--><!--[if !IE]>--></footer><!--<![endif]--></div></body></html>
\ No newline at end of file
+ <!--[if IE]></div><![endif]--><!--[if !IE]>--></footer>
+<!--<![endif]-->
+</div>
+</body>
+</html>
Modified: tomcat/site/trunk/docs/migration-8.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/migration-8.html?rev=1521874&r1=1521873&r2=1521874&view=diff
==============================================================================
--- tomcat/site/trunk/docs/migration-8.html (original)
+++ tomcat/site/trunk/docs/migration-8.html Wed Sep 11 14:30:22 2013
@@ -1,68 +1,364 @@
<!DOCTYPE html SYSTEM "about:legacy-compat">
-<html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><link href="stylesheets/tomcat.css" rel="stylesheet" type="text/css"><!--[if IE]><link href="stylesheets/tomcat-ie-fix.css" rel="stylesheet" type="text/css"/><![endif]--><link href="stylesheets/tomcat-printer.css" rel="stylesheet" type="text/css" media="print"><title>Apache Tomcat - Migration Guide - Tomcat 8.0.x</title><meta name="author" content="Apache Tomcat Project"></head><body><div id="wrapper"><!--[if IE]><div id="header"><![endif]--><!--[if !IE]>--><header id="header"><!--<![endif]--><div><div><div class="logo noPrint"><a href=""><img alt="Tomcat Home" src="./images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo"><a href="http://www.apache.org/" target="_blank"><img src="http://www.apache.org/images/feather.png" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1 style="margin-top: 35px;">Apache Tomcat</h1><div style="clear:
right;"></div><div class="searchbox noPrint"><form action="http://www.google.com/search" method="get"><input value="tomcat.apache.org" name="sitesearch" type="hidden"><input placeholder="Search the Site…" required="required" size="25" name="q" id="query" type="search"><button>Search</button></form></div><div style="height: 1px;"></div><div style="clear: left;"></div></div></div><!--[if IE]></div><![endif]--><!--[if !IE]>--></header><!--<![endif]--><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2><strong>Apache Tomcat</strong></h2><ul><li><a href="./index.html">Home</a></li><li><a href="./taglibs/">Taglibs</a></li><li><a href="./maven-plugin.html">Maven Plugin</a></li></ul></div><div><h2><strong>Download</strong></h2><ul><li><a href="./whichversion.html">Which version?</a></li><li><a href="./download-80.cgi">Tomcat 8.0</a></li><li><a href="./download-70.cgi">Tomcat 7.0</a></li><li><a href="./download-60.cgi">Tomcat 6.0</a></li><li><a href="./download
-connectors.cgi">Tomcat Connectors</a></li><li><a href="./download-native.cgi">Tomcat Native</a></li><li><a href="http://archive.apache.org/dist/tomcat/">Archives</a></li></ul></div><div><h2><strong>Documentation</strong></h2><ul><li><a href="./tomcat-8.0-doc/index.html">Tomcat 8.0</a></li><li><a href="./tomcat-7.0-doc/index.html">Tomcat 7.0</a></li><li><a href="./tomcat-6.0-doc/index.html">Tomcat 6.0</a></li><li><a href="./connectors-doc/">Tomcat Connectors</a></li><li><a href="./native-doc/">Tomcat Native</a></li><li><a href="http://wiki.apache.org/tomcat/FrontPage">Wiki</a></li><li><a href="./migration.html">Migration Guide</a></li></ul></div><div><h2><strong>Problems?</strong></h2><ul><li><a href="./security.html">Security Reports</a></li><li><a href="./findhelp.html">Find help</a></li><li><a href="http://wiki.apache.org/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></l
i></ul></div><div><h2><strong>Get Involved</strong></h2><ul><li><a href="./getinvolved.html">Overview</a></li><li><a href="./svn.html">SVN Repositories</a></li><li><a href="./ci.html">Buildbot</a></li><li><a href="https://reviews.apache.org/groups/tomcat/">Reviewboard</a></li><li><a href="./tools.html">Tools</a></li></ul></div><div><h2><strong>Media</strong></h2><ul><li><a href="http://blogs.apache.org/tomcat/">Blog</a></li><li><a href="http://twitter.com/theapachetomcat">Twitter</a></li></ul></div><div><h2><strong>Misc</strong></h2><ul><li><a href="./whoweare.html">Who We Are</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="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li></ul></di
v></nav></div></div><div id="mainRight"><div id="content"><main><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_7.0.x_to_8.0.x">Migrating from 7.0.x to 8.0.x</a><ol><li><a href="#Java_7_required">Java 7 required</a></li><li><a href="#Specification_APIs">Specification APIs</a></li><li><a href="#Servlet_3.1_API">Servlet 3.1 API</a></li><li><a href="#Default_connector_implementation">Default connector implementation</a></li><li><a href="#Web_application_resources">Web application resources</a></li><li><a href="#Debugging">Debugging</a></li><li><a href="#Internal_APIs">Internal APIs</a></li></ol></li><li><a href="#Upgrading_8.0.x">Upgrading 8.0.x</a><ol><li><a href="#Tomcat_8.0.x_configuration_file_differences">Tomcat 8.0.x configuration file differences</a></li></ol></li></ul>
-</div><h3 id="General">General</h3><div class="text">
+<html lang="en">
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<link href="stylesheets/tomcat.css" rel="stylesheet" type="text/css">
+<!--[if IE]><link href="stylesheets/tomcat-ie-fix.css" rel="stylesheet" type="text/css"/><![endif]-->
+<link href="stylesheets/tomcat-printer.css" rel="stylesheet" type="text/css" media="print">
+<title>Apache Tomcat - Migration Guide - Tomcat 8.0.x</title>
+<meta name="author" content="Apache Tomcat Project">
+</head>
+<body>
+<div id="wrapper">
+<!--[if IE]><div id="header"><![endif]-->
+<!--[if !IE]>-->
+<header id="header">
+<!--<![endif]-->
+<div>
+<div>
+<div class="logo noPrint">
+<a href=""><img alt="Tomcat Home" src="./images/tomcat.png"></a>
+</div>
+<div style="height: 1px;"></div>
+<div class="asfLogo">
+<a href="http://www.apache.org/" target="_blank"><img src="http://www.apache.org/images/feather.png" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a>
+</div>
+<h1 style="margin-top: 35px;">Apache Tomcat</h1>
+<div style="clear: right;"></div>
+<div class="searchbox noPrint">
+<form action="http://www.google.com/search" method="get">
+<input value="tomcat.apache.org" name="sitesearch" type="hidden"><input placeholder="Search the Site…" required="required" size="25" name="q" id="query" type="search"><button>Search</button>
+</form>
+</div>
+<div style="height: 1px;"></div>
+<div style="clear: left;"></div>
+</div>
+</div>
+<!--[if IE]></div><![endif]-->
+<!--[if !IE]>-->
+</header>
+<!--<![endif]-->
+<div id="middle">
+<div>
+<div id="mainLeft" class="noprint">
+<div>
+<nav>
+<div>
+<h2>
+<strong>Apache Tomcat</strong>
+</h2>
+<ul>
+<li>
+<a href="./index.html">Home</a>
+</li>
+<li>
+<a href="./taglibs/">Taglibs</a>
+</li>
+<li>
+<a href="./maven-plugin.html">Maven Plugin</a>
+</li>
+</ul>
+</div>
+<div>
+<h2>
+<strong>Download</strong>
+</h2>
+<ul>
+<li>
+<a href="./whichversion.html">Which version?</a>
+</li>
+<li>
+<a href="./download-80.cgi">Tomcat 8.0</a>
+</li>
+<li>
+<a href="./download-70.cgi">Tomcat 7.0</a>
+</li>
+<li>
+<a href="./download-60.cgi">Tomcat 6.0</a>
+</li>
+<li>
+<a href="./download-connectors.cgi">Tomcat Connectors</a>
+</li>
+<li>
+<a href="./download-native.cgi">Tomcat Native</a>
+</li>
+<li>
+<a href="http://archive.apache.org/dist/tomcat/">Archives</a>
+</li>
+</ul>
+</div>
+<div>
+<h2>
+<strong>Documentation</strong>
+</h2>
+<ul>
+<li>
+<a href="./tomcat-8.0-doc/index.html">Tomcat 8.0</a>
+</li>
+<li>
+<a href="./tomcat-7.0-doc/index.html">Tomcat 7.0</a>
+</li>
+<li>
+<a href="./tomcat-6.0-doc/index.html">Tomcat 6.0</a>
+</li>
+<li>
+<a href="./connectors-doc/">Tomcat Connectors</a>
+</li>
+<li>
+<a href="./native-doc/">Tomcat Native</a>
+</li>
+<li>
+<a href="http://wiki.apache.org/tomcat/FrontPage">Wiki</a>
+</li>
+<li>
+<a href="./migration.html">Migration Guide</a>
+</li>
+</ul>
+</div>
+<div>
+<h2>
+<strong>Problems?</strong>
+</h2>
+<ul>
+<li>
+<a href="./security.html">Security Reports</a>
+</li>
+<li>
+<a href="./findhelp.html">Find help</a>
+</li>
+<li>
+<a href="http://wiki.apache.org/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>
+<strong>Get Involved</strong>
+</h2>
+<ul>
+<li>
+<a href="./getinvolved.html">Overview</a>
+</li>
+<li>
+<a href="./svn.html">SVN Repositories</a>
+</li>
+<li>
+<a href="./ci.html">Buildbot</a>
+</li>
+<li>
+<a href="https://reviews.apache.org/groups/tomcat/">Reviewboard</a>
+</li>
+<li>
+<a href="./tools.html">Tools</a>
+</li>
+</ul>
+</div>
+<div>
+<h2>
+<strong>Media</strong>
+</h2>
+<ul>
+<li>
+<a href="http://blogs.apache.org/tomcat/">Blog</a>
+</li>
+<li>
+<a href="http://twitter.com/theapachetomcat">Twitter</a>
+</li>
+</ul>
+</div>
+<div>
+<h2>
+<strong>Misc</strong>
+</h2>
+<ul>
+<li>
+<a href="./whoweare.html">Who We Are</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="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
+</li>
+<li>
+<a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</li>
+</ul>
+</div>
+</nav>
+</div>
+</div>
+<div id="mainRight">
+<div id="content">
+<main>
+<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_7.0.x_to_8.0.x">Migrating from 7.0.x to 8.0.x</a>
+<ol>
+<li>
+<a href="#Java_7_required">Java 7 required</a>
+</li>
+<li>
+<a href="#Specification_APIs">Specification APIs</a>
+</li>
+<li>
+<a href="#Servlet_3.1_API">Servlet 3.1 API</a>
+</li>
+<li>
+<a href="#Default_connector_implementation">Default connector implementation</a>
+</li>
+<li>
+<a href="#Web_application_resources">Web application resources</a>
+</li>
+<li>
+<a href="#Debugging">Debugging</a>
+</li>
+<li>
+<a href="#Internal_APIs">Internal APIs</a>
+</li>
+</ol>
+</li>
+<li>
+<a href="#Upgrading_8.0.x">Upgrading 8.0.x</a>
+<ol>
+<li>
+<a href="#Tomcat_8.0.x_configuration_file_differences">Tomcat 8.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_7.0.x_to_8.0.x">Migrating from 7.0.x to 8.0.x</h3><div class="text">
- <p> This section lists all the known changes between 7.0.x and 8.0.x which may
+</div>
+<h3 id="Migrating_from_7.0.x_to_8.0.x">Migrating from 7.0.x to 8.0.x</h3>
+<div class="text">
+
+
+<p> This section lists all the known changes between 7.0.x and 8.0.x which may
cause backwards compatibility problems when upgrading.</p>
- <div class="subsection"><h4 id="Java_7_required">Java 7 required</h4><div class="text">
+
+<div class="subsection">
+<h4 id="Java_7_required">Java 7 required</h4>
+<div class="text">
- <p>Apache Tomcat 8.0.x requires Java 7 or later. Apache Tomcat 7.0.x
+
+<p>Apache Tomcat 8.0.x requires Java 7 or later. Apache Tomcat 7.0.x
required Java 6.</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="Specification_APIs">Specification APIs</h4><div class="text">
+
+<div class="subsection">
+<h4 id="Specification_APIs">Specification APIs</h4>
+<div class="text">
- <p>Apache Tomcat 8 supports the Java Servlet 3.1, JavaServer Pages 2.3,
+
+<p>Apache Tomcat 8 supports the Java Servlet 3.1, JavaServer Pages 2.3,
Java Unified Expression Language 3.0 and Java WebSocket 1.0
<a href="http://wiki.apache.org/tomcat/Specifications">specifications</a>.
The changes between versions of specifications may be found in the
<em>Changes</em> appendix in each of specification documents.
</p>
- </div></div>
- <div class="subsection"><h4 id="Servlet_3.1_API">Servlet 3.1 API</h4><div class="text">
+</div>
+</div>
+
- <p>In JSP pages that use wildcard import syntax the new classes added in
+<div class="subsection">
+<h4 id="Servlet_3.1_API">Servlet 3.1 API</h4>
+<div class="text">
+
+
+<p>In JSP pages that use wildcard import syntax the new classes added in
Servlet API may conflict with ones in web applications.
For example, if package <code>"a"</code> contains class
<code>ReadListener</code>, the following JSP page will cease to compile in
Tomcat 8:</p>
- <div class="codeBox"><pre><code>
+
+<div class="codeBox">
+<pre>
+<code>
<%@page import="a.*"%>
-<% ReadListener listener = new ReadListener(); %></code></pre></div>
+<% ReadListener listener = new ReadListener(); %></code>
+</pre>
+</div>
- <p>This happens because implicit import of <code>javax.servlet.*</code>
+
+<p>This happens because implicit import of <code>javax.servlet.*</code>
and explicit import of <code>a.*</code> will provide conflicting
definitions of class <code>ReadListener</code> that was added in Servlet
3.1. The solution is to use the explicit import,
<code>import="a.ReadListener"</code>.</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="Default_connector_implementation">Default connector implementation</h4><div class="text">
+
+<div class="subsection">
+<h4 id="Default_connector_implementation">Default connector implementation</h4>
+<div class="text">
- <p>The default HTTP and AJP connector implementation has switched from the
+
+<p>The default HTTP and AJP connector implementation has switched from the
Java blocking IO implementation (BIO) to the Java non-blocking IO
implementation (NIO). BIO may still be used but Servlet 3.1 and WebSocket
1.0 features that use non-blocking IO will then use blocking IO instead
which may cause unexpected application behavior.</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="Web_application_resources">Web application resources</h4><div class="text">
+
+<div class="subsection">
+<h4 id="Web_application_resources">Web application resources</h4>
+<div class="text">
- <p>The Aliases, VirtualLoader, VirtualDirContext, JAR resources and external
+
+<p>The Aliases, VirtualLoader, VirtualDirContext, JAR resources and external
repositories features that all provided a way to add resources to a web
application have been replaced with a single framework rather than each
being implemented separately (this was becoming increasingly difficult to
@@ -70,40 +366,64 @@ of Apache Tomcat.</p>
documentation provides details on how the new implementation may be used.
</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="Debugging">Debugging</h4><div class="text">
+
+<div class="subsection">
+<h4 id="Debugging">Debugging</h4>
+<div class="text">
- <p>When starting Tomcat with the <code>jpda</code> option to enable remote
+
+<p>When starting Tomcat with the <code>jpda</code> option to enable remote
debugging, Tomcat 8 listens on <code>localhost:8000</code> by default.
Earlier versions listened on <code>*:8000</code>. If required, this default
can be overridden by setting the <code>JPDA_ADDRESS</code> environment
variable in, for example, <code>setenv.[bat|sh]</code>.</p>
- </div></div>
+
+</div>
+</div>
- <div class="subsection"><h4 id="Internal_APIs">Internal APIs</h4><div class="text">
- <p>Whilst the Tomcat 8 internal API is broadly compatible with Tomcat 7
+<div class="subsection">
+<h4 id="Internal_APIs">Internal APIs</h4>
+<div class="text">
+
+
+<p>Whilst the Tomcat 8 internal API is broadly compatible with Tomcat 7
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>The Manager, Loader and Resources have moved from Container to Context
+
+<p>Of particular note are:</p>
+
+<ul>
+
+<li>The Manager, Loader and Resources have moved from Container to Context
since Context is the only place they are used.</li>
- <li>The Mapper has moved from the Connector to the Service since the
+
+<li>The Mapper has moved from the Connector to the Service since the
Mapper is identical for all Connectors of a given Service.</li>
- <li>A new Resources implementation that merges Aliases, VirtualLoader,
+
+<li>A new Resources implementation that merges Aliases, VirtualLoader,
VirtualDirContext, JAR resources and external repositories into a
single framework rather than a separate one for each feature.</li>
- </ul>
+
+</ul>
+
+
+</div>
+</div>
- </div></div>
-</div><h3 id="Upgrading_8.0.x">Upgrading 8.0.x</h3><div class="text">
- <p>When upgrading instances of Apache Tomcat from one version of Tomcat 8 to
+</div>
+<h3 id="Upgrading_8.0.x">Upgrading 8.0.x</h3>
+<div class="text">
+
+<p>When upgrading instances of Apache Tomcat from one version of Tomcat 8 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
@@ -111,13 +431,18 @@ of Apache Tomcat.</p>
the form below may be used to view the differences between the configuration
files in different versions of Tomcat 8.</p>
- <div class="subsection"><h4 id="Tomcat_8.0.x_configuration_file_differences">Tomcat 8.0.x configuration file differences</h4><div class="text">
+
+<div class="subsection">
+<h4 id="Tomcat_8.0.x_configuration_file_differences">Tomcat 8.0.x configuration file differences</h4>
+<div class="text">
- <p>Select a configuration file, old version and new version from the boxes
+
+<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>
- <script type="text/javascript" language="JavaScript">
+
+<script type="text/javascript" language="JavaScript">
function updateTc8ActionUrl() {
var revisions = {
"HEAD":"HEAD",
@@ -133,8 +458,10 @@ of Apache Tomcat.</p>
}
</script>
- <form id="tc8Select" action="not-used">
- <p>Configuration file:
+
+<form id="tc8Select" action="not-used">
+
+<p>Configuration file:
<select name="filename">
<option value="conf/catalina.policy">catalina.policy</option>
<option value="conf/catalina.properties">catalina.properties</option>
@@ -144,33 +471,60 @@ of Apache Tomcat.</p>
<option value="conf/tomcat-users.xml">tomcat-users.xml</option>
<option value="conf/web.xml">web.xml</option>
</select>
- </p>
- <p>Old version:
+
+</p>
+
+<p>Old version:
<select name="r1">
<option value="8.0.0-RC1" selected>8.0.0-RC1</option>
</select>, new version:
<select name="r2">
<option value="HEAD" selected>trunk (unreleased)</option>
</select>
- </p>
- </form>
- <form id="tc8Submit" action="to-be-replaced" method="get" target="_blank">
- <p>
- <input type="hidden" name="diff_format" value="h">
+
+</p>
+
+</form>
+
+<form id="tc8Submit" action="to-be-replaced" method="get" target="_blank">
+
+<p>
+
+<input type="hidden" name="diff_format" value="h">
<input type="hidden" name="r1"><input type="hidden" name="r2">
<input type="submit" value="View Differences" onClick="return updateTc8ActionUrl();">
- </p>
- </form>
- <p>You can also use Subversion command similar to the following (all on one line):</p>
- <pre> svn diff
+
+</p>
+
+</form>
+
+<p>You can also use Subversion command similar to the following (all on one line):</p>
+
+<pre> svn diff
--old=http://svn.apache.org/repos/asf/tomcat/tags/TOMCAT_8_0_0/conf/
--new=http://svn.apache.org/repos/asf/tomcat/tags/TOMCAT_8_0_1/conf/
</pre>
- </div></div>
-</div></main></div></div></div></div><!--[if IE]><div id="footer"><![endif]--><!--[if !IE]>--><footer id="footer"><!--<![endif]-->
+</div>
+</div>
+
+
+</div>
+</main>
+</div>
+</div>
+</div>
+</div>
+<!--[if IE]><div id="footer"><![endif]-->
+<!--[if !IE]>-->
+<footer id="footer">
+<!--<![endif]-->
Copyright © 1999-2013, The Apache Software Foundation
<br>
Apache Tomcat, Tomcat, Apache, the Apache feather, and the Apache Tomcat
project logo are trademarks of the Apache Software Foundation.
- <!--[if IE]></div><![endif]--><!--[if !IE]>--></footer><!--<![endif]--></div></body></html>
\ No newline at end of file
+ <!--[if IE]></div><![endif]--><!--[if !IE]>--></footer>
+<!--<![endif]-->
+</div>
+</body>
+</html>
Modified: tomcat/site/trunk/docs/migration.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/migration.html?rev=1521874&r1=1521873&r2=1521874&view=diff
==============================================================================
--- tomcat/site/trunk/docs/migration.html (original)
+++ tomcat/site/trunk/docs/migration.html Wed Sep 11 14:30:22 2013
@@ -1,7 +1,249 @@
<!DOCTYPE html SYSTEM "about:legacy-compat">
-<html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"><link href="stylesheets/tomcat.css" rel="stylesheet" type="text/css"><!--[if IE]><link href="stylesheets/tomcat-ie-fix.css" rel="stylesheet" type="text/css"/><![endif]--><link href="stylesheets/tomcat-printer.css" rel="stylesheet" type="text/css" media="print"><title>Apache Tomcat - Migration Guide</title><meta name="author" content="Apache Tomcat Project"></head><body><div id="wrapper"><!--[if IE]><div id="header"><![endif]--><!--[if !IE]>--><header id="header"><!--<![endif]--><div><div><div class="logo noPrint"><a href=""><img alt="Tomcat Home" src="./images/tomcat.png"></a></div><div style="height: 1px;"></div><div class="asfLogo"><a href="http://www.apache.org/" target="_blank"><img src="http://www.apache.org/images/feather.png" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a></div><h1 style="margin-top: 35px;">Apache Tomcat</h1><div style="clear: right;"></div><
div class="searchbox noPrint"><form action="http://www.google.com/search" method="get"><input value="tomcat.apache.org" name="sitesearch" type="hidden"><input placeholder="Search the Site…" required="required" size="25" name="q" id="query" type="search"><button>Search</button></form></div><div style="height: 1px;"></div><div style="clear: left;"></div></div></div><!--[if IE]></div><![endif]--><!--[if !IE]>--></header><!--<![endif]--><div id="middle"><div><div id="mainLeft" class="noprint"><div><nav><div><h2><strong>Apache Tomcat</strong></h2><ul><li><a href="./index.html">Home</a></li><li><a href="./taglibs/">Taglibs</a></li><li><a href="./maven-plugin.html">Maven Plugin</a></li></ul></div><div><h2><strong>Download</strong></h2><ul><li><a href="./whichversion.html">Which version?</a></li><li><a href="./download-80.cgi">Tomcat 8.0</a></li><li><a href="./download-70.cgi">Tomcat 7.0</a></li><li><a href="./download-60.cgi">Tomcat 6.0</a></li><li><a href="./download-connectors.cgi
">Tomcat Connectors</a></li><li><a href="./download-native.cgi">Tomcat Native</a></li><li><a href="http://archive.apache.org/dist/tomcat/">Archives</a></li></ul></div><div><h2><strong>Documentation</strong></h2><ul><li><a href="./tomcat-8.0-doc/index.html">Tomcat 8.0</a></li><li><a href="./tomcat-7.0-doc/index.html">Tomcat 7.0</a></li><li><a href="./tomcat-6.0-doc/index.html">Tomcat 6.0</a></li><li><a href="./connectors-doc/">Tomcat Connectors</a></li><li><a href="./native-doc/">Tomcat Native</a></li><li><a href="http://wiki.apache.org/tomcat/FrontPage">Wiki</a></li><li><a href="./migration.html">Migration Guide</a></li></ul></div><div><h2><strong>Problems?</strong></h2><ul><li><a href="./security.html">Security Reports</a></li><li><a href="./findhelp.html">Find help</a></li><li><a href="http://wiki.apache.org/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><d
iv><h2><strong>Get Involved</strong></h2><ul><li><a href="./getinvolved.html">Overview</a></li><li><a href="./svn.html">SVN Repositories</a></li><li><a href="./ci.html">Buildbot</a></li><li><a href="https://reviews.apache.org/groups/tomcat/">Reviewboard</a></li><li><a href="./tools.html">Tools</a></li></ul></div><div><h2><strong>Media</strong></h2><ul><li><a href="http://blogs.apache.org/tomcat/">Blog</a></li><li><a href="http://twitter.com/theapachetomcat">Twitter</a></li></ul></div><div><h2><strong>Misc</strong></h2><ul><li><a href="./whoweare.html">Who We Are</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="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li></ul></div></nav></div><
/div><div id="mainRight"><div id="content"><main><h2 style="display: none;">Content</h2><h3 id="Table_of_Contents">Table of Contents</h3><div class="text">
-<ul><li><a href="#Before_upgrading_or_migrating">Before upgrading or migrating</a></li><li><a href="#Migrating_from_5.5.x_to_6.0.x">Migrating from 5.5.x to 6.0.x</a></li><li><a href="#Upgrading_between_6.0.x_versions">Upgrading between 6.0.x versions</a></li><li><a href="#Migrating_from_6.0.x_to_7.0.x">Migrating from 6.0.x to 7.0.x</a></li><li><a href="#Upgrading_between_7.0.x_versions">Upgrading between 7.0.x versions</a></li><li><a href="#Migrating_from_7.0.x_to_8.0.x">Migrating from 7.0.x to 8.0.x</a></li><li><a href="#Upgrading_between_8.0.x_versions">Upgrading between 8.0.x versions</a></li></ul>
-</div><h3 id="Before_upgrading_or_migrating">Before upgrading or migrating</h3><div class="text">
+<html lang="en">
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<link href="stylesheets/tomcat.css" rel="stylesheet" type="text/css">
+<!--[if IE]><link href="stylesheets/tomcat-ie-fix.css" rel="stylesheet" type="text/css"/><![endif]-->
+<link href="stylesheets/tomcat-printer.css" rel="stylesheet" type="text/css" media="print">
+<title>Apache Tomcat - Migration Guide</title>
+<meta name="author" content="Apache Tomcat Project">
+</head>
+<body>
+<div id="wrapper">
+<!--[if IE]><div id="header"><![endif]-->
+<!--[if !IE]>-->
+<header id="header">
+<!--<![endif]-->
+<div>
+<div>
+<div class="logo noPrint">
+<a href=""><img alt="Tomcat Home" src="./images/tomcat.png"></a>
+</div>
+<div style="height: 1px;"></div>
+<div class="asfLogo">
+<a href="http://www.apache.org/" target="_blank"><img src="http://www.apache.org/images/feather.png" alt="The Apache Software Foundation" style="width: 266px; height: 83px;"></a>
+</div>
+<h1 style="margin-top: 35px;">Apache Tomcat</h1>
+<div style="clear: right;"></div>
+<div class="searchbox noPrint">
+<form action="http://www.google.com/search" method="get">
+<input value="tomcat.apache.org" name="sitesearch" type="hidden"><input placeholder="Search the Site…" required="required" size="25" name="q" id="query" type="search"><button>Search</button>
+</form>
+</div>
+<div style="height: 1px;"></div>
+<div style="clear: left;"></div>
+</div>
+</div>
+<!--[if IE]></div><![endif]-->
+<!--[if !IE]>-->
+</header>
+<!--<![endif]-->
+<div id="middle">
+<div>
+<div id="mainLeft" class="noprint">
+<div>
+<nav>
+<div>
+<h2>
+<strong>Apache Tomcat</strong>
+</h2>
+<ul>
+<li>
+<a href="./index.html">Home</a>
+</li>
+<li>
+<a href="./taglibs/">Taglibs</a>
+</li>
+<li>
+<a href="./maven-plugin.html">Maven Plugin</a>
+</li>
+</ul>
+</div>
+<div>
+<h2>
+<strong>Download</strong>
+</h2>
+<ul>
+<li>
+<a href="./whichversion.html">Which version?</a>
+</li>
+<li>
+<a href="./download-80.cgi">Tomcat 8.0</a>
+</li>
+<li>
+<a href="./download-70.cgi">Tomcat 7.0</a>
+</li>
+<li>
+<a href="./download-60.cgi">Tomcat 6.0</a>
+</li>
+<li>
+<a href="./download-connectors.cgi">Tomcat Connectors</a>
+</li>
+<li>
+<a href="./download-native.cgi">Tomcat Native</a>
+</li>
+<li>
+<a href="http://archive.apache.org/dist/tomcat/">Archives</a>
+</li>
+</ul>
+</div>
+<div>
+<h2>
+<strong>Documentation</strong>
+</h2>
+<ul>
+<li>
+<a href="./tomcat-8.0-doc/index.html">Tomcat 8.0</a>
+</li>
+<li>
+<a href="./tomcat-7.0-doc/index.html">Tomcat 7.0</a>
+</li>
+<li>
+<a href="./tomcat-6.0-doc/index.html">Tomcat 6.0</a>
+</li>
+<li>
+<a href="./connectors-doc/">Tomcat Connectors</a>
+</li>
+<li>
+<a href="./native-doc/">Tomcat Native</a>
+</li>
+<li>
+<a href="http://wiki.apache.org/tomcat/FrontPage">Wiki</a>
+</li>
+<li>
+<a href="./migration.html">Migration Guide</a>
+</li>
+</ul>
+</div>
+<div>
+<h2>
+<strong>Problems?</strong>
+</h2>
+<ul>
+<li>
+<a href="./security.html">Security Reports</a>
+</li>
+<li>
+<a href="./findhelp.html">Find help</a>
+</li>
+<li>
+<a href="http://wiki.apache.org/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>
+<strong>Get Involved</strong>
+</h2>
+<ul>
+<li>
+<a href="./getinvolved.html">Overview</a>
+</li>
+<li>
+<a href="./svn.html">SVN Repositories</a>
+</li>
+<li>
+<a href="./ci.html">Buildbot</a>
+</li>
+<li>
+<a href="https://reviews.apache.org/groups/tomcat/">Reviewboard</a>
+</li>
+<li>
+<a href="./tools.html">Tools</a>
+</li>
+</ul>
+</div>
+<div>
+<h2>
+<strong>Media</strong>
+</h2>
+<ul>
+<li>
+<a href="http://blogs.apache.org/tomcat/">Blog</a>
+</li>
+<li>
+<a href="http://twitter.com/theapachetomcat">Twitter</a>
+</li>
+</ul>
+</div>
+<div>
+<h2>
+<strong>Misc</strong>
+</h2>
+<ul>
+<li>
+<a href="./whoweare.html">Who We Are</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="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
+</li>
+<li>
+<a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</li>
+</ul>
+</div>
+</nav>
+</div>
+</div>
+<div id="mainRight">
+<div id="content">
+<main>
+<h2 style="display: none;">Content</h2>
+<h3 id="Table_of_Contents">Table of Contents</h3>
+<div class="text">
+
+<ul>
+<li>
+<a href="#Before_upgrading_or_migrating">Before upgrading or migrating</a>
+</li>
+<li>
+<a href="#Migrating_from_5.5.x_to_6.0.x">Migrating from 5.5.x to 6.0.x</a>
+</li>
+<li>
+<a href="#Upgrading_between_6.0.x_versions">Upgrading between 6.0.x versions</a>
+</li>
+<li>
+<a href="#Migrating_from_6.0.x_to_7.0.x">Migrating from 6.0.x to 7.0.x</a>
+</li>
+<li>
+<a href="#Upgrading_between_7.0.x_versions">Upgrading between 7.0.x versions</a>
+</li>
+<li>
+<a href="#Migrating_from_7.0.x_to_8.0.x">Migrating from 7.0.x to 8.0.x</a>
+</li>
+<li>
+<a href="#Upgrading_between_8.0.x_versions">Upgrading between 8.0.x versions</a>
+</li>
+</ul>
+
+</div>
+<h3 id="Before_upgrading_or_migrating">Before upgrading or migrating</h3>
+<div class="text">
+
<p>When updating from one major Apache Tomcat version a newer one, please make
sure that the JVM that is installed on your system supports at least the
@@ -9,46 +251,86 @@ required Java version. While it is possi
not be compatible with newer JVMs, all the currently supported Apache Tomcat
versions (6.0.x and 7.0.x) are known to run correctly on Java 6 JVMs.</p>
+
<p>When migrating from one major Tomcat version to another (e.g. from Tomcat 6
to Tomcat 7), you should not blindly copy the configuration files from the old
version. The recommended approach is to start with the default configuration of
the new version of Apache Tomcat and to adjust it as necessary.</p>
+
<p>When migrating from one minor release to another minor release within the
same major release (e.g. from Tomcat 7.0.14 to Tomcat 7.0.16) you can retain the
configuration files, but you should check to see if any defaults have changed
and/or if any new elements have been added and adjust your configuration files
accordingly.</p>
-</div><h3 id="Migrating_from_5.5.x_to_6.0.x">Migrating from 5.5.x to 6.0.x</h3><div class="text">
+
+</div>
+<h3 id="Migrating_from_5.5.x_to_6.0.x">Migrating from 5.5.x to 6.0.x</h3>
+<div class="text">
+
<p>See <a href="migration-6.html">Migration Guide - Tomcat 6.0.x</a>.</p>
-</div><h3 id="Upgrading_between_6.0.x_versions">Upgrading between 6.0.x versions</h3><div class="text">
+
+</div>
+<h3 id="Upgrading_between_6.0.x_versions">Upgrading between 6.0.x versions</h3>
+<div class="text">
+
<p>See <a href="migration-6.html#Upgrading_6.0.x">Migration Guide
- Tomcat 6.0.x</a>.</p>
-</div><h3 id="Migrating_from_6.0.x_to_7.0.x">Migrating from 6.0.x to 7.0.x</h3><div class="text">
+
+</div>
+<h3 id="Migrating_from_6.0.x_to_7.0.x">Migrating from 6.0.x to 7.0.x</h3>
+<div class="text">
+
<p>See <a href="migration-7.html">Migration Guide - Tomcat 7.0.x</a>.</p>
-</div><h3 id="Upgrading_between_7.0.x_versions">Upgrading between 7.0.x versions</h3><div class="text">
+
+</div>
+<h3 id="Upgrading_between_7.0.x_versions">Upgrading between 7.0.x versions</h3>
+<div class="text">
+
<p>See <a href="migration-7.html#Upgrading_7.0.x">Migration Guide
- Tomcat 7.0.x</a>.</p>
-</div><h3 id="Migrating_from_7.0.x_to_8.0.x">Migrating from 7.0.x to 8.0.x</h3><div class="text">
+
+</div>
+<h3 id="Migrating_from_7.0.x_to_8.0.x">Migrating from 7.0.x to 8.0.x</h3>
+<div class="text">
+
<p>See <a href="migration-8.html">Migration Guide - Tomcat 8.0.x</a>.</p>
-</div><h3 id="Upgrading_between_8.0.x_versions">Upgrading between 8.0.x versions</h3><div class="text">
+
+</div>
+<h3 id="Upgrading_between_8.0.x_versions">Upgrading between 8.0.x versions</h3>
+<div class="text">
+
<p>See <a href="migration-8.html#Upgrading_8.0.x">Migration Guide
- Tomcat 8.0.x</a>.</p>
-</div></main></div></div></div></div><!--[if IE]><div id="footer"><![endif]--><!--[if !IE]>--><footer id="footer"><!--<![endif]-->
+
+</div>
+</main>
+</div>
+</div>
+</div>
+</div>
+<!--[if IE]><div id="footer"><![endif]-->
+<!--[if !IE]>-->
+<footer id="footer">
+<!--<![endif]-->
Copyright © 1999-2013, The Apache Software Foundation
<br>
Apache Tomcat, Tomcat, Apache, the Apache feather, and the Apache Tomcat
project logo are trademarks of the Apache Software Foundation.
- <!--[if IE]></div><![endif]--><!--[if !IE]>--></footer><!--<![endif]--></div></body></html>
\ No newline at end of file
+ <!--[if IE]></div><![endif]--><!--[if !IE]>--></footer>
+<!--<![endif]-->
+</div>
+</body>
+</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org