<?xml version='1.0' encoding='UTF-8' ?>

<!DOCTYPE manualpage SYSTEM "/style/manualpage.dtd">

<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>

<manualpage metafile="upgrading.xml.meta">

<title>Upgrading to 2.1 from 2.0</title>

<summary>

<p>In order to assist folks upgrading, we maintain a document

describing information critical to existing Apache users. These

are intended to be brief notes, and you should be able to find

more information in either the <a

href="new_features_2_2.html">New Features</a> document, or in

the <code>src/CHANGES</code> file.</p>

<p>This document describes only the changes from 2.0 to 2.2. If you

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

upgrading document.</a></p>

</summary>

<seealso><a href="new_features_2_2.html">Overview of new features in

Apache 2.2</a></seealso>

<section id="compile-time">

<title>Compile-Time Configuration Changes</title>

<ul>

<li>Upgraded to require the APR 1.0 API.</li>

<li>Updated bundled PCRE version to 5.0</li>

<li>mod_imap has been renamed to <module>mod_imagemap</module></li>

<li>mod_auth has been split up into <module>mod_auth_basic</module>

and <module>mod_authn_file</module></li>

<li>mod_access has been renamed to <module>mod_authz_host</module></li>

<li>mod_auth_ldap has been renamed to <module>mod_authnz_ldap</module></li>

</ul>

</section>

<section id="run-time">

<title>Run-Time Configuration Changes</title>

<ul>

<li>The config file <code>httpd.conf</code> distributed with the

Apache HTTP Server has been greatly simplified by removing all

but the most essential configuration settings. A set of example

configuration settings for more advanced features is present in

the <code>conf/extra/</code> directory of the installed

server.</li>

<li>The <program>apachectl</program> option

<code>startssl</code> is no longer available. To enable ssl

support, you should edit <code>httpd.conf</code> to include the

relevant <module>mod_ssl</module> directives and then use

<code>apachectl start</code> to start the server. An example

configuration to activate <module>mod_ssl</module> has been included

in <code>conf/extra/httpd-ssl.conf</code>.</li>

<li>The default setting of <directive

module="core">UseCanonicalName</directive> is now

<code>Off</code>. If you did not have this directive in your

config file, you can add <code>UseCanonicalName On</code> to

retain the old behavior.</li>

<li>The module <module>mod_userdir</module> will no longer act

on requests unless a <directive

module="mod_userdir">UserDir</directive> directive specifying a

directory name is present in the config file. To restore the

old default behavior, place the directive <code>UserDir

public_html</code> in your config file.</li>

</ul>

</section>

<section id="misc">

<title>Misc Changes</title>

</section>

<section id="third-party">

<title>Third Party Modules</title>

</section>

</manualpage>