Main Server Configuration

UserDir Mapping

The UserDir directive is used to enable URLs such as http://example.com/~bob/ to map to a subdirectory within the home directory of the user bob, such as /home/bob/public_html/. A side-effect of this feature allows a potential attacker to determine whether a given username is present on the system. For this reason, the default configuration for Apache HTTP Server 2.0 disables this directive.

To enable UserDir mapping, change the directive in httpd.conf from:

UserDir disable

to the following:

UserDir public_html

For more on this topic, refer to the following documentation on the Apache Software Foundation's website:

• http://httpd.apache.org/docs-2.0/mod/mod_userdir.html#userdir

Logging

The following logging directives have been removed:

• AgentLog

• RefererLog
• RefererIgnore

However, agent and referrer logs are still available using the CustomLog and LogFormat directives.

For more on this topic, refer to the following documentation on the Apache Software Foundation's website:

• http://httpd.apache.org/docs-2.0/mod/mod_log_config.html#customlog

• http://httpd.apache.org/docs-2.0/mod/mod_log_config.html#logformat

Directory Indexing

The deprecated FancyIndexing directive has now been removed. The same functionality is available through the FancyIndexing option within the IndexOptions directive.

The VersionSort option to the IndexOptions directive causes files containing version numbers to be sorted in a more natural way. For example, httpd-2.0.6.tar appears before httpd-2.0.36.tar in a directory index page.

The defaults for the ReadmeName and HeaderName directives have changed from README and HEADER to README.html and HEADER.html.

For more on this topic, refer to the following documentation on the Apache Software Foundation's website:

• http://httpd.apache.org/docs-2.0/mod/mod_autoindex.html#indexoptions

• http://httpd.apache.org/docs-2.0/mod/mod_autoindex.html#readmename
• http://httpd.apache.org/docs-2.0/mod/mod_autoindex.html#headername

Content Negotiation

The CacheNegotiatedDocs directive now takes the argument on or off. Existing instances of CacheNegotiatedDocs should be replaced with CacheNegotiatedDocs on.

For more on this topic, refer to the following documentation on the Apache Software Foundation's website:

• http://httpd.apache.org/docs-2.0/mod/mod_negotiation.html#cachenegotiateddocs

Error Documents

To use a hard-coded message with the ErrorDocument directive, the message should be enclosed in a pair of double quotation marks ", rather than just preceded by a double quotation mark as required in Apache HTTP Server 1.3.

For example, the following is a sample Apache HTTP Server 1.3 directive:

ErrorDocument 404 "The document was not found

To migrate an ErrorDocument setting to Apache HTTP Server 2.0, use the following structure:

ErrorDocument 404 "The document was not found"

Note the trailing double quote in the previous ErrorDocument directive example.

For more on this topic, refer to the following documentation on the Apache Software Foundation's website:

• http://httpd.apache.org/docs-2.0/mod/core.html#errordocument