upgrading.html revision 3ea50d72b5634eaf81a01957891c3118550cd1de
148N/A<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
148N/A<HTML><HEAD>
148N/A<TITLE>Upgrading to 2.0 from 1.3</TITLE>
148N/A</HEAD>
148N/A
148N/A<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
148N/A<BODY
148N/A BGCOLOR="#FFFFFF"
148N/A TEXT="#000000"
148N/A LINK="#0000FF"
148N/A VLINK="#000080"
148N/A ALINK="#FF0000"
148N/A>
148N/A<!--#include virtual="header.html" -->
148N/A<H1 ALIGN="CENTER">Upgrading to 2.0 from 1.3</H1>
148N/A
148N/A<P>In order to assist folks upgrading, we maintain a document
148N/Adescribing information critical to existing Apache users. These are
148N/Aintended to be brief notes, and you should be able to find more
148N/Ainformation in either the <A HREF="new_features_2_0.html">New
148N/AFeatures</A> document, or in the <CODE>src/CHANGES</CODE> file.
148N/A
2899N/A<H3>Compile-Time Configuration Changes</H3>
148N/A
148N/A<UL>
148N/A<LI>Apache now uses an <code>autoconf</code> and <code>libtool</code>
148N/Asystem for configuring the build processes. Using this system
148N/Ais similar to, but not the same as, using the APACI system in
3403N/AApache 1.3. Further documentation to follow.</li>
618N/A
148N/A<li>In addition to the usual selection of modules which you can choose
148N/Ato compile, Apache 2.0 has moved the main part of request processing
844N/Ainto <a href="mpm.html">Multi-Processing Modules</a> (MPMs).</li>
3403N/A</UL>
148N/A
1258N/A<H3>Run-Time Configuration Changes</H3>
148N/A
1002N/A<UL>
1239N/A<li>The <code>CacheNegotiatedDocs</code> directive now takes
1002N/Athe argument <code>on</code> or <code>off</code>. Existing
1239N/Ainstances of <code>CacheNegotiatedDocs</code> should be replaced
1002N/Awith <code>CachNegotiatedDocs on</code>.</li>
1002N/A
3403N/A<li>The <code>ErrorDocument</code> directive no longer uses a quote at
2899N/Athe beginning of the argument to indicate a text message. Instead,
148N/Ayou should enclose the message in double quotes. For example,
148N/Aexisting instances of <blockquote><code>ErrorDocument 403 "Some
148N/AMessage</code></blockquote> should be replaced with
181N/A<blockquote><code>ErrorDocument 403 "Some
148N/AMessage"</code></blockquote> As long as the second argument is not a
148N/Avalid URL or pathname, it will be treated as a text message.</li>
148N/A
148N/A<li>The <code>AccessConfig</code> and <code>ResourceConfig</code>
148N/Adirectives no longer exist. Existing instances of these directives
148N/Acan be replaced with the <a
148N/Ahref="mod/core.html#include"><code>Include</code></a> directive which
148N/Ahas equivalent functionality. If you were making use of the default
3403N/Avalues of these directives without including them in the configuration
1239N/Afiles, you may need to add <code>Include conf/access.conf</code> and
1239N/A<code>Include conf/srm.conf</code> to your httpd.conf. In order to
148N/Aassure that Apache reads the configuration files in the same order as
148N/Awas implied by the older directives, the <code>Include</code>
148N/Adirectives should be placed at the end of httpd.conf, with the one for
690N/A<code>srm.conf</code> preceding the one for
148N/A<code>access.conf</code>.</li>
3056N/A
3056N/A<li>The <code>BindAddress</code> directive no longer exists.
3056N/AEquivalent functionality is provided with the more flexible <code><a
3056N/Ahref="mod/mpm_common.html">Listen</a></code> directive.
3056N/A
3056N/A<li>The <code>ExtendedStatus</code> directive no longer exists.
3056N/AStatus reporting has been completely rewritten to take advantage
3056N/Aof the new MPM system.</li>
3056N/A
3056N/A<li>The <code>ServerType</code> directive no longer exists.
3056N/AThe method used to serve requests is now determined by the selection
3127N/Aof MPM. There is currently no MPM designed to be launched by
3127N/Ainetd.</li>
3056N/A
3056N/A<li>Many directives that were in the core server in Apache 1.3
3056N/Aare now in the MPMs.</li>
3056N/A
3127N/A<li>The mod_log_agent and mod_log_referer modules which provided the
3127N/A<code>AgentLog</code>, <code>RefererLog</code> and
3127N/A<code>RefererIgnore</code> directives have been removed. Agent and
3127N/Areferer logs are still available using the <a
3056N/Ahref="mod/mod_log_config.html#customlog">CustomLog</a> directive of
3056N/Amod_log_config.</li>
727N/A
727N/A</UL>
3056N/A
727N/A<H3>Misc Changes</H3>
3056N/A
3056N/A<UL>
3056N/A
727N/A<li>Graceful restarts of the server are now executed by signaling the
3056N/Aparent process with <code>WINCH</code> rather than
1652N/A<code>USR1</code>.</li>
3056N/A
3056N/A<li>The <code>httpd</code> command line option <code>-S</code>
3056N/Awhich was used for printing the virtual host configuration has
1652N/Abeen replaced by <code>-t -D DUMP_VHOSTS</code>.</li>
1652N/A
1652N/A<li>The <code>httpd</code> command line option <code>-X</code> has
1652N/Abeen removed. Most MPMs allow the same functionality to be requested
1652N/Aby setting the <code>ONE_PROCESS</code> and <code>NO_DETACH</code>
3056N/Aenvironment variables prior to launching <code>httpd</code>.</li>
3056N/A
3056N/A<li>The module mod_auth_digest, which was experimental in Apache 1.3
1652N/Ais now a standard module.</li>
3056N/A
3056N/A<li>The mod_mmap_static module, which was experimental in Apache 1.3
1652N/Ahas been replaced with mod_file_cache.</li>
1652N/A
1652N/A
727N/A</UL>
148N/A
148N/A<H3>Third Party Modules</H3>
148N/A
148N/A<p>Extensive changes were made to the server API in Apache 2.0.
560N/AExisting modules designed for the Apache 1.3 API will <strong>not</strong>
727N/Awork in Apache 2.0 without modification. Details are provided in
3056N/Athe <a href="developer/">developer documentation</a>.</p>
148N/A
181N/A<!--#include virtual="footer.html" -->
148N/A</BODY>
148N/A</HTML>
148N/A