upgrading.html revision 5bc4038e199e30f971d06fadb3ebbe13879e09a5
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML><HEAD>
<TITLE>Upgrading to 2.0 from 1.3</TITLE>
</HEAD>
<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
<BODY
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#000080"
ALINK="#FF0000"
>
<!--#include virtual="header.html" -->
<H1 ALIGN="CENTER">Upgrading to 2.0 from 1.3</H1>
<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_0.html">New
<H3>Compile-Time Configuration Changes</H3>
<UL>
<LI>Apache now uses an <code>autoconf</code> and <code>libtool</code>
system for configuring the build processes. Using this system
is similar to, but not the same as, using the APACI system in
Apache 1.3. Further documentation to follow.</li>
<li>In addition to the usual selection of modules which you can choose
to compile, Apache 2.0 has moved the main part of request processing
</UL>
<H3>Run-Time Configuration Changes</H3>
<UL>
<li>The <code>CacheNegotiatedDocs</code> directive now takes
the argument <code>on</code> or <code>off</code>. Existing
instances of <code>CacheNegotiatedDocs</code> should be replaced
with <code>CachNegotiatedDocs on</code>.</li>
<li>The <code>ErrorDocument</code> directive no longer uses a quote at
the beginning of the argument to indicate a text message. Instead,
you should enclose the message in double quotes. For example,
existing instances of <blockquote><code>ErrorDocument 403 "Some
Message</code></blockquote> should be replaced with
<blockquote><code>ErrorDocument 403 "Some
Message"</code></blockquote> As long as the second argument is not a
valid URL or pathname, it will be treated as a text message.</li>
<li>The <code>AccessConfig</code> and <code>ResourceConfig</code>
directives no longer exist. Existing instances of these directives
can be replaced with the <a
has equivalent functionality. If you were making use of the default
values of these directives without including them in the configuration
assure that Apache reads the configuration files in the same order as
was implied by the older directives, the <code>Include</code>
directives should be placed at the end of httpd.conf, with the one for
<li>The <code>BindAddress</code> directive no longer exists.
Equivalent functionality is provided with the more flexible <code><a
<li>The <code>ExtendedStatus</code> directive no longer exists.
Status reporting has been completely rewritten to take advantage
of the new MPM system.</li>
<li>The <code>ServerType</code> directive no longer exists.
The method used to serve requests is now determined by the selection
of MPM. There is currently no MPM designed to be launched by
inetd.</li>
<li>Many directives that were in the core server in Apache 1.3
are now in the MPMs.</li>
<li>The mod_log_agent and mod_log_referer modules which provided the
<code>AgentLog</code>, <code>RefererLog</code> and
<code>RefererIgnore</code> directives have been removed. Agent and
referer logs are still available using the <a
href="mod/mod_log_config.html#customlog">CustomLog</a> directive of
mod_log_config.</li>
</UL>
<H3>Misc Changes</H3>
<UL>
<li>Graceful restarts of the server are now executed by signaling the
parent process with <code>SIGWINCH</code> rather than
<code>USR1</code>.</li>
<li>The <code>httpd</code> command line option <code>-S</code>
which was used for printing the virtual host configuration has
been replaced by <code>-t -D DUMP_VHOSTS</code>.</li>
<li>The <code>httpd</code> command line option <code>-X</code> has
been removed. Most MPMs allow the same functionality to be requested
by setting the <code>ONE_PROCESS</code> and <code>NO_DETACH</code>
environment variables prior to launching <code>httpd</code>.</li>
<li>The module mod_auth_digest, which was experimental in Apache 1.3
is now a standard module.</li>
<li>The mod_mmap_static module, which was experimental in Apache 1.3
has been replaced with mod_file_cache.</li>
</UL>
<H3>Third Party Modules</H3>
<p>Extensive changes were made to the server API in Apache 2.0.
Existing modules designed for the Apache 1.3 API will <strong>not</strong>
work in Apache 2.0 without modification. Details to follow.
<!--#include virtual="footer.html" -->
</BODY>
</HTML>