# Upgrading to 2.2 from 2.0

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 New Features document, or in the `src/CHANGES` file.

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 1.3 to 2.0 upgrading document.

Overview of new features in Apache 2.2

# Compile-Time Configuration Changes

- Upgraded to require the APR 1.0 API.
- Updated bundled PCRE version to 5.0
- mod_imap has been renamed to mod_imagemap
- mod_auth has been split up into mod_auth_basic and mod_authn_file
- mod_access has been renamed to mod_authz_host
- mod_auth_ldap has been renamed to mod_authnz_ldap

# Run-Time Configuration Changes

- The config file `httpd.conf` 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 `conf/extra/` directory of the installed server.
- The apachectl option `startssl` is no longer available. To enable ssl support, you should edit `httpd.conf` to include the relevant mod_ssl directives and then use `apachectl start` to start the server. An example configuration to activate mod_ssl has been included in `conf/extra/httpd-ssl.conf`.
- The default setting of UseCanonicalName is now `Off`. If you did not have this directive in your config file, you can add `UseCanonicalName On` to retain the old behavior.
- The module mod_userdir will no longer act on requests unless a UserDir directive specifying a directory name is present in the config file. To restore the old default behavior, place the directive `UserDir public_html` in your config file.

# Misc Changes

- The module mod_cache, which was experimental in Apache 2.0, is now a standard module.
- The module mod_disk_cache, which was experimental in Apache 2.0, is now a standard module.
- The module mod_mem_cache, which was experimental in Apache 2.0, is now a standard module.
- The module mod_charset_lite, which was experimental in Apache 2.0, is now a standard module.
- The module mod_dumpio, which was experimental in Apache 2.0, is now a standard module.

# Third Party Modules