1<?xml version="1.0" encoding="ISO-8859-1"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!-- 4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 5 This file is generated from xml source: DO NOT EDIT 6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 7 --> 8<title>Upgrading to 2.2 from 2.0 - Apache HTTP Server</title> 9<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> 10<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> 11<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" /> 12<script src="/style/scripts/prettify.js" type="text/javascript"> 13</script> 14 15<link href="/images/favicon.ico" rel="shortcut icon" /></head> 16<body id="manual-page"><div id="page-header"> 17<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p> 18<p class="apache">Apache HTTP Server Version 2.2</p> 19<img alt="" src="/images/feather.gif" /></div> 20<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div> 21<div id="path"> 22<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.2</a></div><div id="page-content"><div id="preamble"><h1>Upgrading to 2.2 from 2.0</h1> 23<div class="toplang"> 24<p><span>Available Languages: </span><a href="/de/upgrading.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | 25<a href="/en/upgrading.html" title="English"> en </a> | 26<a href="/fr/upgrading.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> | 27<a href="/ja/upgrading.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> 28</div> 29 30 <p>In order to assist folks upgrading, we maintain a document 31 describing information critical to existing Apache users. These 32 are intended to be brief notes, and you should be able to find 33 more information in either the <a href="new_features_2_2.html">New Features</a> document, or in 34 the <code>src/CHANGES</code> file.</p> 35 36 <p>This document describes only the changes from 2.0 to 2.2. If you 37 are upgrading from version 1.3, you should also consult the <a href="http://httpd.apache.org/docs/2.0/upgrading.html">1.3 to 2.0 38 upgrading document.</a></p> 39 40</div> 41<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#compile-time">Compile-Time Configuration Changes</a></li> 42<li><img alt="" src="/images/down.gif" /> <a href="#run-time">Run-Time Configuration Changes</a></li> 43<li><img alt="" src="/images/down.gif" /> <a href="#misc">Misc Changes</a></li> 44<li><img alt="" src="/images/down.gif" /> <a href="#third-party">Third Party Modules</a></li> 45</ul><h3>See also</h3><ul class="seealso"><li><a href="new_features_2_2.html">Overview of new features in 46 Apache 2.2</a></li></ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> 47<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 48<div class="section"> 49<h2><a name="compile-time" id="compile-time">Compile-Time Configuration Changes</a></h2> 50 51 52 <p>The compilation process is very similar to the one used in 53 version 2.0. Your old <code>configure</code> command line (as 54 found in <code>build/config.nice</code> in the installed server 55 directory) can be used in some cases. The most significant change 56 required will be to account for changes in module names, in 57 particular for the authentication and authorization modules. 58 Some details of changes:</p> 59 60 <ul> 61 <li>mod_imap has been renamed to <code class="module"><a href="/mod/mod_imagemap.html">mod_imagemap</a></code></li> 62 <li>mod_auth has been split up into <code class="module"><a href="/mod/mod_auth_basic.html">mod_auth_basic</a></code>, 63 <code class="module"><a href="/mod/mod_authn_file.html">mod_authn_file</a></code>, <code class="module"><a href="/mod/mod_authz_user.html">mod_authz_user</a></code>, and 64 <code class="module"><a href="/mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code></li> 65 <li>mod_access has been renamed to <code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code></li> 66 <li>mod_auth_ldap has been renamed to <code class="module"><a href="/mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></li> 67 <li>Upgraded to require the APR 1.0 API.</li> 68 <li>Updated bundled PCRE version to 5.0</li> 69 </ul> 70 71 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 72<div class="section"> 73<h2><a name="run-time" id="run-time">Run-Time Configuration Changes</a></h2> 74 75 76 <p>Your existing version 2.0 config files and startup scripts can 77 usually be used unchanged in version 2.2. Some small 78 adjustments may be necessary for particular configurations as 79 discussed below. In addition, if you dynamically load the 80 standard modules using the <code class="directive"><a href="/mod/mod_so.html#loadmodule">LoadModule</a></code> directive, then you will 81 need to account for the module name changes mentioned above.</p> 82 83 <p>If you choose to use the new default 84 configuration file for version 2.2, you will find that it has 85 been greatly simplified by removing all but the most essential 86 configuration settings. A set of example configuration settings 87 for more advanced features is present in the 88 <code>conf/extra/</code> directory of the installed server. Default 89 configuration files are installed in the <code>conf/original</code> 90 directory.</p> 91 92 <p>Some runtime configuration changes that you may notice:</p> 93 94 <ul> 95 <li>The <code class="program"><a href="/programs/apachectl.html">apachectl</a></code> option 96 <code>startssl</code> is no longer available. To enable SSL 97 support, you should edit <code>httpd.conf</code> to include the 98 relevant <code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code> directives and then use 99 <code>apachectl start</code> to start the server. An example 100 configuration to activate <code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code> has been 101 included in <code>conf/extra/httpd-ssl.conf</code>.</li> 102 103 <li>The default setting of <code class="directive"><a href="/mod/core.html#usecanonicalname">UseCanonicalName</a></code> is now 104 <code>Off</code>. If you did not have this directive in your 105 config file, you can add <code>UseCanonicalName On</code> to 106 retain the old behavior.</li> 107 108 <li>The module <code class="module"><a href="/mod/mod_userdir.html">mod_userdir</a></code> will no longer act 109 on requests unless a <code class="directive"><a href="/mod/mod_userdir.html#userdir">UserDir</a></code> directive specifying a 110 directory name is present in the config file. To restore the 111 old default behavior, place the directive <code>UserDir 112 public_html</code> in your config file.</li> 113 114 <li>The directive <code class="directive">AuthDigestFile</code> 115 from <code class="module"><a href="/mod/mod_auth_digest.html">mod_auth_digest</a></code> has been merged with 116 <code class="directive"><a href="/mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> 117 and is now part of <code class="module"><a href="/mod/mod_authn_file.html">mod_authn_file</a></code>.</li> 118 </ul> 119 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 120<div class="section"> 121<h2><a name="misc" id="misc">Misc Changes</a></h2> 122 123 124 <ul> 125 <li>The module <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code>, which was 126 experimental in Apache 2.0, is now a standard module.</li> 127 128 <li>The module <code class="module"><a href="/mod/mod_disk_cache.html">mod_disk_cache</a></code>, which was 129 experimental in Apache 2.0, is now a standard module.</li> 130 131 <li>The module <code class="module"><a href="/mod/mod_mem_cache.html">mod_mem_cache</a></code>, which was 132 experimental in Apache 2.0, is now a standard module.</li> 133 134 <li>The module <code class="module"><a href="/mod/mod_charset_lite.html">mod_charset_lite</a></code>, which was 135 experimental in Apache 2.0, is now a standard module.</li> 136 137 <li>The module <code class="module"><a href="/mod/mod_dumpio.html">mod_dumpio</a></code>, which was 138 experimental in Apache 2.0, is now a standard module.</li> 139 140 </ul> 141 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 142<div class="section"> 143<h2><a name="third-party" id="third-party">Third Party Modules</a></h2> 144 145 146 <p>Many third-party modules designed for version 2.0 will work 147 unchanged with the Apache HTTP Server version 2.2. But all 148 modules must be recompiled before being loaded.</p> 149 150 </div></div> 151<div class="bottomlang"> 152<p><span>Available Languages: </span><a href="/de/upgrading.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | 153<a href="/en/upgrading.html" title="English"> en </a> | 154<a href="/fr/upgrading.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> | 155<a href="/ja/upgrading.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> 156</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> 157<script type="text/javascript"><!--//--><![CDATA[//><!-- 158var comments_shortname = 'httpd'; 159var comments_identifier = 'http://httpd.apache.org/docs/2.2/upgrading.html'; 160(function(w, d) { 161 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 162 d.write('<div id="comments_thread"><\/div>'); 163 var s = d.createElement('script'); 164 s.type = 'text/javascript'; 165 s.async = true; 166 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 167 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 168 } 169 else { 170 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 171 } 172})(window, document); 173//--><!]]></script></div><div id="footer"> 174<p class="apache">Copyright 2013 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> 175<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- 176if (typeof(prettyPrint) !== 'undefined') { 177 prettyPrint(); 178} 179//--><!]]></script> 180</body></html>