1 <?xml version='1.0' encoding='UTF-8' ?>
2 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
3 <?xml-stylesheet type="text/xsl" href="./style/manual.en.xsl"?>
7 Copyright 2002-2004 The Apache Software Foundation
9 Licensed under the Apache License, Version 2.0 (the "License");
10 you may not use this file except in compliance with the License.
11 You may obtain a copy of the License at
13 http://www.apache.org/licenses/LICENSE-2.0
15 Unless required by applicable law or agreed to in writing, software
16 distributed under the License is distributed on an "AS IS" BASIS,
17 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18 See the License for the specific language governing permissions and
19 limitations under the License.
22 <manualpage metafile="upgrading.xml.meta">
24 <title>Upgrading to 2.0 from 1.3</title>
27 <p>In order to assist folks upgrading, we maintain a document
28 describing information critical to existing Apache users. These
29 are intended to be brief notes, and you should be able to find
30 more information in either the <a
31 href="new_features_2_0.html">New Features</a> document, or in
32 the <code>src/CHANGES</code> file.</p>
34 <seealso><a href="new_features_2_0.html">Overview of new features in
35 Apache 2.0</a></seealso>
37 <section id="compile-time">
38 <title>Compile-Time Configuration Changes</title>
41 <li>Apache now uses an <code>autoconf</code> and
42 <code>libtool</code> system for <a
43 href="install.html">configuring the build processes</a>.
44 Using this system is similar to, but not the same as, using
45 the APACI system in Apache 1.3.</li>
47 <li>In addition to the usual selection of modules which you
48 can choose to compile, Apache 2.0 has moved the main part of
49 request processing into <a href="mpm.html">Multi-Processing
50 Modules</a> (MPMs).</li>
54 <section id="run-time">
55 <title>Run-Time Configuration Changes</title>
58 <li>Many directives that were in the core server in Apache
59 1.3 are now in the MPMs. If you wish the behavior of the
60 server to be as similar as possible to the behavior of Apache
61 1.3, you should select the <module>prefork</module> MPM. Other MPMs
62 will have different directives to control process creation and request
65 <li>The <a href="mod/mod_proxy.html">proxy module</a> has been
66 revamped to bring it up to HTTP/1.1. Among the important changes,
67 proxy access control is now placed inside a <directive type="section"
68 module="mod_proxy">Proxy</directive> block rather than a
69 <code><Directory proxy:></code> block.</li>
71 <li>The handling of <code>PATH_INFO</code> (trailing path information
72 after the true filename) has changed for some modules. Modules
73 that were previously implemented as a handler but are now
74 implemented as a filter may no longer accept requests with
75 <code>PATH_INFO</code>. Filters such as <a
76 href="mod/mod_include.html">INCLUDES</a> or <a
77 href="http://www.php.net/">PHP</a> are implemented on top
78 of the core handler, and therefore reject requests with
79 <code>PATH_INFO</code>. You can use the <directive
80 module="core">AcceptPathInfo</directive> directive to
81 force the core handler to accept requests with <code>PATH_INFO</code>
82 and thereby restore the ability to use <code>PATH_INFO</code> in
83 server-side includes.</li>
86 module="mod_negotiation">CacheNegotiatedDocs</directive>
87 directive now takes the argument <code>on</code> or
88 <code>off</code>. Existing instances of <directive
89 >CacheNegotiatedDocs</directive> should be
90 replaced with <code>CacheNegotiatedDocs on</code>.</li>
93 The <directive module="core">ErrorDocument</directive>
94 directive no longer uses a quote at the beginning of the
95 argument to indicate a text message. Instead, you should
96 enclose the message in double quotes. For example, existing
100 ErrorDocument 403 "Some Message
102 should be replaced with
105 ErrorDocument 403 "Some Message"
108 As long as the second argument is not a valid URL or
109 pathname, it will be treated as a text message.
112 <li>The <code>AccessConfig</code> and
113 <code>ResourceConfig</code> directives no longer exist.
114 Existing instances of these directives can be replaced with
115 the <directive module="core">Include</directive>
116 directive which has equivalent functionality. If you were
117 making use of the default values of these directives without
118 including them in the configuration files, you may need to
119 add <code>Include conf/access.conf</code> and <code>Include
120 conf/srm.conf</code> to your <code>httpd.conf</code>. In order to
121 assure that Apache reads the configuration files in the same order
122 as was implied by the older directives, the <directive
123 module="core">Include</directive> directives should be placed at the end
124 of <code>httpd.conf</code>, with the one for <code>srm.conf</code>
125 preceding the one for <code>access.conf</code>.</li>
127 <li>The <code>BindAddress</code> and <code>Port</code>
128 directives no longer exist. Equivalent functionality is
129 provided with the more flexible
130 <directive module="mpm_common">Listen</directive>
133 <li>Another use of the <code>Port</code>
134 directive in Apache-1.3 was setting the port number to be used
135 in self-referential URL's. The Apache-2.0 equivalent is
136 the new <directive module="core">ServerName</directive>
137 syntax: it has been changed to allow specifying both the
138 hostname <em>and</em> the port number for self-referential URL's
139 in one directive.</li>
141 <li>The <code>ServerType</code> directive no longer exists.
142 The method used to serve requests is now determined by the
143 selection of MPM. There is currently no MPM designed to be
144 launched by inetd.</li>
146 <li>The <code>mod_log_agent</code> and <code>mod_log_referer</code>
147 modules which provided the <code>AgentLog</code>,
148 <code>RefererLog</code> and <code>RefererIgnore</code> directives have
149 been removed. Agent and referer logs are still available using the
150 <directive module="mod_log_config">CustomLog</directive>
151 directive of <module>mod_log_config</module>.</li>
153 <li>The <code>AddModule</code> and
154 <code>ClearModuleList</code> directives no longer exist.
155 These directives were used to ensure that modules could be
156 enabled in the correct order. The new Apache 2.0 API allows
157 modules to explicitly specify their ordering, eliminating the
158 need for these directives.</li>
160 <li>The <code>FancyIndexing</code> directive has been removed.
161 The same functionality is available through the
162 <code>FancyIndexing</code> option to the <directive
163 module="mod_autoindex">IndexOptions</directive>
166 <li>The MultiViews content-negotiation technique provided by
167 <module>mod_negotiation</module> has become more strict in its
168 default file matching. It will select only from <em>negotiable</em>
169 files. The old behavior can be restored using the <directive
170 module="mod_mime">MultiviewsMatch</directive> directive.</li>
172 <li>(<em>since version 2.0.51</em>)
173 <p>The functionality of the <code>ErrorHeader</code> directive was
174 put together with the <directive module="mod_headers">Header</directive>
175 directive, since it was a misnomer. Use</p>
178 Header always set foo bar
181 <p>instead to get the desired behaviour.</p></li>
186 <title>Misc Changes</title>
189 <li>The module <module>mod_auth_digest</module>, which was
190 experimental in Apache 1.3, is now a standard module.</li>
192 <li>The <code>mod_mmap_static</code> module, which was experimental in
193 Apache 1.3, has been replaced with <module>mod_file_cache</module>.</li>
195 <li>The distribution has been completely reorganized so that
196 it no longer contains an independent <code>src</code>
197 directory. Instead, the sources are logically organized under
198 the main distribution directory, and installations of the
199 compiled server should be directed to a separate
204 <section id="third-party">
205 <title>Third Party Modules</title>
207 <p>Extensive changes were made to the server API in Apache 2.0.
208 Existing modules designed for the Apache 1.3 API will
209 <strong>not</strong> work in Apache 2.0 without modification.
210 Details are provided in the <a href="developer/">developer
211 documentation</a>.</p>