granicus.if.org Git - apache/blob - docs/manual/upgrading.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
   2 <HTML><HEAD>
   3 <TITLE>Upgrading to 2.0 from 1.3</TITLE>
   4 </HEAD>
   5
   6 <!-- Background white, links blue (unvisited), navy (visited), red (active) -->
   7 <BODY
   8  BGCOLOR="#FFFFFF"
   9  TEXT="#000000"
  10  LINK="#0000FF"
  11  VLINK="#000080"
  12  ALINK="#FF0000"
  13 >
  14 <!--#include virtual="header.html" -->
  15 <H1 ALIGN="CENTER">Upgrading to 2.0 from 1.3</H1>
  16
  17 <P>In order to assist folks upgrading, we maintain a document
  18 describing information critical to existing Apache users.  These are
  19 intended to be brief notes, and you should be able to find more
  20 information in either the <A HREF="new_features_2_0.html">New
  21 Features</A> document, or in the <CODE>src/CHANGES</CODE> file.
  22
  23 <H3>Compile-Time Configuration Changes</H3>
  24
  25 <UL>
  26 <LI>Apache now uses an <code>autoconf</code> and <code>libtool</code>
  27 system for configuring the build processes.  Using this system
  28 is similar to, but not the same as, using the APACI system in
  29 Apache 1.3.  Further documentation to follow.</li>
  30
  31 <li>In addition to the usual selection of modules which you can choose
  32 to compile, Apache 2.0 has moved the main part of request processing
  33 into <a href="mpm.html">Multi-Processing Modules</a> (MPMs).</li>
  34 </UL>
  35
  36 <H3>Run-Time Configuration Changes</H3>
  37
  38 <UL>
  39 <li>The <code>CacheNegotiatedDocs</code> directive now takes
  40 the argument <code>on</code> or <code>off</code>.  Existing
  41 instances of <code>CacheNegotiatedDocs</code> should be replaced
  42 with <code>CachNegotiatedDocs on</code>.</li>
  43
  44 <li>The <code>ErrorDocument</code> directive no longer uses a quote at
  45 the beginning of the argument to indicate a text message.  Instead,
  46 you should enclose the message in double quotes.  For example,
  47 existing instances of <blockquote><code>ErrorDocument 403 "Some
  48 Message</code></blockquote> should be replaced with
  49 <blockquote><code>ErrorDocument 403 "Some
  50 Message"</code></blockquote>  As long as the second argument is not a
  51 valid URL or pathname, it will be treated as a text message.</li>
  52
  53 <li>The <code>AccessConfig</code> and <code>ResourceConfig</code>
  54 directives no longer exist.  Existing instances of these directives
  55 can be replaced with the <a
  56 href="mod/core.html#include"><code>Include</code></a> directive which
  57 has equivalent functionality.  If you were making use of the default
  58 values of these directives without including them in the configuration
  59 files, you may need to add <code>Include conf/access.conf</code> and
  60 <code>Include conf/srm.conf</code> to your httpd.conf.  In order to
  61 assure that Apache reads the configuration files in the same order as
  62 was implied by the older directives, the <code>Include</code>
  63 directives should be placed at the end of httpd.conf, with the one for
  64 <code>srm.conf</code> preceding the one for
  65 <code>access.conf</code>.</li>
  66
  67 <li>The <code>BindAddress</code> directive no longer exists.
  68 Equivalent functionality is provided with the more flexible <code><a
  69 href="mod/mpm_common.html">Listen</a></code> directive.
  70
  71 <li>The <code>ExtendedStatus</code> directive no longer exists.
  72 Status reporting has been completely rewritten to take advantage
  73 of the new MPM system.</li>
  74
  75 <li>The <code>ServerType</code> directive no longer exists.
  76 The method used to serve requests is now determined by the selection
  77 of MPM.  There is currently no MPM designed to be launched by
  78 inetd.</li>
  79
  80 <li>Many directives that were in the core server in Apache 1.3
  81 are now in the MPMs.</li>
  82
  83 <li>The mod_log_agent and mod_log_referer modules which provided the
  84 <code>AgentLog</code>, <code>RefererLog</code> and
  85 <code>RefererIgnore</code> directives have been removed.  Agent and
  86 referer logs are still available using the <a
  87 href="mod/mod_log_config.html#customlog">CustomLog</a> directive of
  88 mod_log_config.</li>
  89
  90 </UL>
  91
  92 <H3>Misc Changes</H3>
  93
  94 <UL>
  95
  96 <li>Graceful restarts of the server are now executed by signaling the
  97 parent process with <code>SIGWINCH</code> rather than
  98 <code>USR1</code>.</li>
  99
 100 <li>The <code>httpd</code> command line option <code>-S</code>
 101 which was used for printing the virtual host configuration has
 102 been replaced by <code>-t -D DUMP_VHOSTS</code>.</li>
 103
 104 <li>The <code>httpd</code> command line option <code>-X</code> has
 105 been removed.  Most MPMs allow the same functionality to be requested
 106 by setting the <code>ONE_PROCESS</code> and <code>NO_DETACH</code>
 107 environment variables prior to launching <code>httpd</code>.</li>
 108
 109 <li>The module mod_auth_digest, which was experimental in Apache 1.3
 110 is now a standard module.</li>
 111
 112 <li>The mod_mmap_static module, which was experimental in Apache 1.3
 113 has been replaced with mod_file_cache.</li>
 114
 115
 116 </UL>
 117
 118 <H3>Third Party Modules</H3>
 119
 120 <p>Extensive changes were made to the server API in Apache 2.0.
 121 Existing modules designed for the Apache 1.3 API will <strong>not</strong>
 122 work in Apache 2.0 without modification.  Details to follow.
 123
 124 <!--#include virtual="footer.html" -->
 125 </BODY>
 126 </HTML>