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 of
  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
  84 </UL>
  85
  86 <H3>Misc Changes</H3>
  87
  88 <UL>
  89
  90 <li>Graceful restarts of the server are now executed by signaling the
  91 parent process with <code>SIGWINCH</code> rather than
  92 <code>USR1</code>.</li>
  93
  94 <li>The <code>httpd</code> command line option <code>-S</code>
  95 which was used for printing the virtual host configuration has
  96 been replaced by <code>-t -D DUMP_VHOSTS</code>.</li>
  97
  98 <li>The <code>httpd</code> command line option <code>-X</code> has
  99 been removed.  Most MPMs allow the same functionality to be requested
 100 by setting the <code>ONE_PROCESS</code> and <code>NO_DETACH</code>
 101 environment variables prior to launching <code>httpd</code>.</li>
 102
 103 <li>The module mod_auth_digest, which was experimental in Apache 1.3
 104 is now a standard module.</li>
 105
 106 <li>The mod_mmap_static module, which was experimental in Apache 1.3
 107 has been replaced with mod_file_cache.</li>
 108
 109
 110 </UL>
 111
 112 <H3>Third Party Modules</H3>
 113
 114 <p>Extensive changes were made to the server API in Apache 2.0.
 115 Existing modules designed for the Apache 1.3 API will <strong>not</strong>
 116 work in Apache 2.0 without modification.  Details to follow.
 117
 118 <!--#include virtual="footer.html" -->
 119 </BODY>
 120 </HTML>