tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ma...@apache.org
Subject svn commit: r1521874 [5/13] - in /tomcat/site/trunk: docs/ xdocs/stylesheets/
Date Wed, 11 Sep 2013 14:30:23 GMT
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&hellip;" 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&hellip;" 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>
 &lt;%@page import="a.*"%&gt;
-&lt;% Part page = new Part(); %&gt;</code></pre></div>
+&lt;% Part page = new Part(); %&gt;</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>&lt;ContextPath&gt;/html for the HTML GUI</li>
-      <li>&lt;ContextPath&gt;/text for the text interface</li>
-      <li>&lt;ContextPath&gt;/jmxproxy for the JMX proxy</li>
-      <li>&lt;ContextPath&gt;/status for the status pages</li>
-    </ul>
     
-   <p>Note that the URL for the text interface has changed from
+<ul>
+      
+<li>&lt;ContextPath&gt;/html for the HTML GUI</li>
+      
+<li>&lt;ContextPath&gt;/text for the text interface</li>
+      
+<li>&lt;ContextPath&gt;/jmxproxy for the JMX proxy</li>
+      
+<li>&lt;ContextPath&gt;/status for the status pages</li>
+    
+</ul>
+    
+   
+<p>Note that the URL for the text interface has changed from
    "&lt;ContextPath&gt;" to "&lt;ContextPath&gt;/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>&lt;ContextPath&gt;/html for the HTML GUI</li>
-      <li>&lt;ContextPath&gt;/text for the text interface</li>
-    </ul>
     
-   <p>Note that the URL for the text interface has changed from
+<ul>
+      
+<li>&lt;ContextPath&gt;/html for the HTML GUI</li>
+      
+<li>&lt;ContextPath&gt;/text for the text interface</li>
+    
+</ul>
+    
+   
+<p>Note that the URL for the text interface has changed from
    "&lt;ContextPath&gt;" to "&lt;ContextPath&gt;/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>&lt;absolute-ordering /&gt;</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 &copy; 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&hellip;" 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&hellip;" 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>
 &lt;%@page import="a.*"%&gt;
-&lt;% ReadListener listener = new ReadListener(); %&gt;</code></pre></div>
+&lt;% ReadListener listener = new ReadListener(); %&gt;</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 &copy; 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&hellip;" 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&hellip;" 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 &copy; 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


Mime
View raw message