upgrading.html revision f4d23ce8ea0d2ac6133a86d465f2147be6ac30f5
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<HTML><HEAD>
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<TITLE>Upgrading to 2.0 from 1.3</TITLE>
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync</HEAD>
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<BODY
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync BGCOLOR="#FFFFFF"
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync TEXT="#000000"
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync LINK="#0000FF"
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync VLINK="#000080"
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync ALINK="#FF0000"
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync>
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<!--#include virtual="header.html" -->
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<H1 ALIGN="CENTER">Upgrading to 2.0 from 1.3</H1>
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<P>In order to assist folks upgrading, we maintain a document
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncdescribing information critical to existing Apache users. These are
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncintended to be brief notes, and you should be able to find more
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncinformation in either the <A HREF="new_features_2_0.html">New
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncFeatures</A> document, or in the <CODE>src/CHANGES</CODE> file.
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<H3>Compile-Time Configuration Changes</H3>
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<UL>
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<LI>Apache now uses an <code>autoconf</code> and <code>libtool</code>
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncsystem for configuring the build processes. Using this system
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncis similar to, but not the same as, using the APACI system in
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncApache 1.3. Further documentation to follow.</li>
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<li>In addition to the usual selection of modules which you can choose
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncto compile, Apache 2.0 has moved the main part of request processing
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncinto <a href="mpm.html">Multi-Processing Modules</a> (MPMs).</li>
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync</UL>
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<H3>Run-Time Configuration Changes</H3>
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<UL>
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<li>The <code>CacheNegotiatedDocs</code> directive now takes
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncthe argument <code>on</code> or <code>off</code>. Existing
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncinstances of <code>CacheNegotiatedDocs</code> should be replaced
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncwith <code>CacheNegotiatedDocs on</code>.</li>
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<li>The <code>ErrorDocument</code> directive no longer uses a quote at
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncthe beginning of the argument to indicate a text message. Instead,
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncyou should enclose the message in double quotes. For example,
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncexisting instances of <blockquote><code>ErrorDocument 403 "Some
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncMessage</code></blockquote> should be replaced with
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync<blockquote><code>ErrorDocument 403 "Some
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncMessage"</code></blockquote> As long as the second argument is not a
edd67c61375d89ff863e754caff339cd1ac77b38vboxsyncvalid URL or pathname, it will be treated as a text message.</li>
edd67c61375d89ff863e754caff339cd1ac77b38vboxsync
<li>The <code>AccessConfig</code> and <code>ResourceConfig</code>
directives no longer exist. Existing instances of these directives
can be replaced with the <a
href="mod/core.html#include"><code>Include</code></a> directive which
has equivalent functionality. If you were making use of the default
values of these directives without including them in the configuration
files, you may need to add <code>Include conf/access.conf</code> and
<code>Include conf/srm.conf</code> to your httpd.conf. In order to
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
<code>srm.conf</code> preceding the one for
<code>access.conf</code>.</li>
<li>The <code>BindAddress</code> directive no longer exists.
Equivalent functionality is provided with the more flexible <code><a
href="mod/mpm_common.html">Listen</a></code> directive.
<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>WINCH</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 are provided in
the <a href="developer/">developer documentation</a>.</p>
<!--#include virtual="footer.html" -->
</BODY>
</HTML>