Commit 3cf0571f authored by Greg Stein's avatar Greg Stein
Browse files

bunch of random updates... this file still had a lot of 1.3'isms, and also 

needed a goodly number of changes for current layouts, web locations, etc.

added mod_dav, mod_dav_fs, and removed the obsolete loggers.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@87491 13f79535-47bb-0310-9956-ffa450edef68
parent 69bf6f18

INSTALL

+72 −47
Original line number Diff line number Diff line
@@ -10,8 +10,8 @@ 
  to create an environment that looks like many other Open Source projects.





  Installing the Apache 1.3 HTTP server with APACI

  ================================================

  Installing the Apache 2.0 HTTP server

  =====================================



  1. Overview for the impatient

     --------------------------
@@ -26,6 +26,11 @@ 
           filesystem path under which Apache should be installed. For

           instance use "/usr/local/apache" for PREFIX above.



     NOTE: if you are building from a copy of the Apache CVS

           repository, rather than a release distribution, then you

	   must use the "buildconf" script before running configure.





  2. Requirements

     ------------
@@ -47,20 +52,6 @@ 
        at http://www.gnu.org/ and the GCC distribution under

        http://www.gnu.org/order/ftp.html .



     o  Libtool 1.3.3:



        Make sure that you have libtool 1.3.3 or later installed before

        trying to configure and build Apache 2.0.  Libtool can be downloaded

        from the Free Software Foundation (FSF), at 

        http://www.gnu.org/order/ftp.html.



     o  Autoconf 2.13:



        Make sure that you have autoconf 2.13 or later installed before

        trying to configure and build Apache 2.0.  Autoconf can be

        downloaded from the Free Software Foundation (FSF), at

        http://www.gnu.org/order/ftp.html.



     o  Perl 5 Interpreter [OPTIONAL]:



        For some of the support scripts like `apxs' or `dbmmanage' (which are
@@ -101,13 +92,34 @@ 
        below) manually or at least make sure a Perl 5 interpreter is

        installed from which Apache can guess the options.





     If you are building from a copy of the CVS repository, rather

     than a release distribution, then you will need these additional

     tools:



     o  Libtool 1.3.3:



        Make sure that you have libtool 1.3.3 or later installed before

        trying to configure and build Apache 2.0.  Libtool can be downloaded

        from the Free Software Foundation (FSF), at 

        http://www.gnu.org/order/ftp.html.



     o  Autoconf 2.13:



        Make sure that you have autoconf 2.13 or later installed before

        trying to configure and build Apache 2.0.  Autoconf can be

        downloaded from the Free Software Foundation (FSF), at

        http://www.gnu.org/order/ftp.html.





  3. Configuring the source tree

     ---------------------------



     Setup:



     The first step in compiling Apache 2.0 is to setup the source tree so

     that it can be built.  This is done by running:

     If you have downloading the Apache 2.0 from the CVS, rather than

     a release distribution, then you will need to prepare the source

     tree for configuration and compilation. This is done by running:

 

     ./buildconf
@@ -180,14 +192,16 @@ 
     PREFIX=/usr/local/apache and EPREFIX=PREFIX.



     Use the --bindir=DIR, --sbindir=DIR, --libexecdir=DIR, --mandir=DIR,

     --sysconfdir=DIR, --datadir=DIR, --includedir=DIR, --localstatedir=DIR,

     --runtimedir=DIR, --logfiledir=DIR and proxycachedir=DIR option to change

     --sysconfdir=DIR, --datadir=DIR, --iconsdir=DIR, --htdocsdir=DIR,

     --cgidir=DIR, --includedir=DIR, --localstatedir=DIR,

     --runtimedir=DIR, --logfiledir=DIR and --proxycachedir=DIR option to change

     the paths for particular subdirectories of the installation tree.

     Defaults are bindir=EPREFIX/bin, sbindir=EPREFIX/sbin,

     libexecdir=EPREFIX/libexec, mandir=PREFIX/man, sysconfdir=PREFIX/etc,

     datadir=PREFIX/share, includedir=PREFIX/include,

     localstatedir=PREFIX/var, runtimedir=PREFIX/var/run,

     logfiledir=PREFIX/var/log and proxycachedir=PREFIX/var/proxy.

     Defaults are bindir=EPREFIX/bin, sbindir=EPREFIX/bin,

     libexecdir=EPREFIX/modules, mandir=PREFIX/man, sysconfdir=PREFIX/conf,

     datadir=PREFIX, iconsdir=PREFIX/icons, htdocsdir=PREFIX/htdocs,

     cgidir=PREFIX/cgi-bin, includedir=PREFIX/include,

     localstatedir=PREFIX, runtimedir=PREFIX/logs,

     logfiledir=PREFIX/logs and proxycachedir=PREFIX/proxy.



         Note: To reduce the pollution of shared installation locations

               (like /usr/local/ or /etc) with Apache files to a minimum the
@@ -218,12 +232,6 @@ 
     Use the --show-layout option to check the final installation path layout

     while fiddling with the options above.

 

     Use the --enable-rule=NAME and --disable-rule=NAME options to enable or

     disable a particular Rule from the Apache src/Configuration.tmpl file. The

     defaults (yes=enabled, no=disabled) can either be seen when running

     `./configure --help' or manually looked up in the src/Configuration.tmpl

     file.

 

     Use the --enable-NAME=(shared) and --disable-NAME options to enable

     or disable a particular already distributed module from the Apache

     package.
@@ -237,50 +245,63 @@ 
      (+) mod_env .......... Set environment variables for CGI/SSI scripts

      (+) mod_setenvif ..... Set environment variables based on HTTP headers

      (-) mod_unique_id .... Generate unique identifiers for request



     Content type decisions

      (+) mod_mime ......... Content type/encoding determination (configured)

      (-) mod_mime_magic ... Content type/encoding determination (automatic)

      (+) mod_negotiation .. Content selection based on the HTTP Accept* headers



     URL mapping

      (+) mod_alias ........ Simple   URL translation and redirection

      (-) mod_rewrite ...... Advanced URL translation and redirection

      (+) mod_userdir ...... Selection of resource directories by username

      (-) mod_speling ...... Correction of misspelled URLs



     Directory Handling

      (+) mod_dir .......... Directory and directory default file handling

      (+) mod_autoindex .... Automated directory index file generation

     Access Control



     Access Control and Authentication

      (+) mod_access ....... Access Control (user, host, network)

      (+) mod_auth ......... HTTP Basic Authentication (user, passwd)

      (-) mod_auth_dbm ..... HTTP Basic Authentication via Unix NDBM files

      (-) mod_auth_db ...... HTTP Basic Authentication via Berkeley-DB files

      (-) mod_auth_anon .... HTTP Basic Authentication for Anonymous-style users

      (-) mod_digest ....... HTTP Digest Authentication



     HTTP response

      (-) mod_headers ...... Arbitrary HTTP response headers (configured)

      (-) mod_cern_meta .... Arbitrary HTTP response headers (CERN-style files)

      (-) mod_expires ...... Expires HTTP responses 

      (+) mod_asis ......... Raw HTTP responses 



     Scripting

      (+) mod_include ...... Server Side Includes (SSI) support

      (+) mod_cgi .......... Common Gateway Interface (CGI) support

      (+) mod_cgid ......... Common Gateway Interface (CGI) support for 

                             multi-threaded MPMs

      (+) mod_actions ...... Map CGI scripts to act as internal `handlers'



     Internal Content Handlers

      (+) mod_status ....... Content handler for server run-time status

      (-) mod_info ......... Content handler for server configuration summary



     Request Logging

      (+) mod_log_config ... Customizable logging of requests

      (-) mod_log_agent .... Specialized HTTP User-Agent logging (deprecated)

      (-) mod_log_referer .. Specialized HTTP Referrer logging   (deprecated)

      (-) mod_usertrack .... Logging of user click-trails via HTTP Cookies



     Content Management

      (-) mod_dav .......... WebDAV (RFC 2518) support for Apache

      (-) mod_dav_fs ....... mod_dav backend to managing filesystem content



     Miscellaneous

      (+) mod_imap ......... Server-side Image Map support

      (-) mod_proxy ........ Caching Proxy Module (HTTP, HTTPS, FTP)

      (-) mod_so ........... Dynamic Shared Object (DSO) bootstrapping



     Experimental

      (-) mod_mmap_static .. Caching of frequently served pages via mmap()



     Development

      (-) mod_example ...... Apache API demonstration (developers only)
@@ -345,6 +366,7 @@ 
     Use the --server-gid option to specify the group ID you want the server user ID to

     be a member of.  If not specified, the group ID will be #-1.





  4. Building the package

     --------------------
@@ -357,6 +379,7 @@ 
     under a Pentium-166/FreeBSD-2.2 system, dependend on the amount of

     modules you have enabled. 



 

  5. Installing the package

     ----------------------
@@ -368,7 +391,8 @@ 
     For the paranoid hackers under us: The above command really installs under

     prefix _only_, i.e. no other stuff from your system is touched. Even if

     you upgrade an existing installation your configuration files in

     PREFIX/etc/ are preserved.

     PREFIX/conf/ are preserved.





  6. Testing the package

     -------------------
@@ -385,20 +409,20 @@ 


        $ PREFIX/bin/apachectl stop



 

  7. Customizing the package

     -----------------------

 

     Finally you can customize your Apache HTTP server by editing the

     configuration files under PREFIX/etc/.

     configuration files under PREFIX/conf/.

 

        $ vi PREFIX/etc/httpd.conf

        $ vi PREFIX/etc/access.conf

        $ vi PREFIX/etc/srm.conf

        $ vi PREFIX/conf/httpd.conf

 

     Have a look at the Apache manual under htdocs/manual/ or

     http://www.apache.org/docs/ for a complete reference of available

     Have a look at the Apache manual under docs/manual/ or

     http://httpd.apache.org/docs/ for a complete reference of available

     configuration directives.





  8. Preparing the system

     --------------------
@@ -418,13 +442,14 @@ 
        http://www.eecis.udel.edu/~ntp/ for more details about NTP software

        and public time servers.





  9. Contacts

     --------



     o If you want to be informed about new code releases, bug fixes, 

       security fixes, general news and information about the Apache server

       subscribe to the apache-announce mailing list as described under

       http://www.apache.org/announcelist.html

       http://httpd.apache.org/announcelist.html



     o If you want freely available support for running Apache please join the

       Apache user community by subscribing at least to the following USENET
@@ -433,17 +458,17 @@ 


     o If you want commercial support for running Apache please contact

       one of the companies and contractors which are listed at

       http://www.apache.org/info/support.cgi

       http://httpd.apache.org/info/support.cgi



     o If you have a concrete bug report for Apache please go to the

       Apache Group Bug Database and submit your report:

       http://www.apache.org/bug_report.html

       http://httpd.apache.org/bug_report.html



     o If you want to participate in actively developing Apache please

       subscribe to the `new-httpd' mailing list as described at

       http://dev.apache.org/mailing-lists

       http://www.apache.org/foundation/mailinglists.html



     Thanks for running Apache.



                                          The Apache Group

                                          http://www.apache.org/