From 69f53d801217f500356acaf0709f95c06bb1b27c Mon Sep 17 00:00:00 2001 From: Greg Stein Date: Thu, 21 Dec 2000 11:41:23 +0000 Subject: 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 --- INSTALL | 119 +++++++++++++++++++++++++++++++++++++++------------------------- 1 file changed, 72 insertions(+), 47 deletions(-) (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL index ba598eb212..f668713129 100644 --- a/INSTALL +++ b/INSTALL @@ -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 -------------------- @@ -356,6 +378,7 @@ Please be patient here, this takes approximately 2 minutes to complete 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 ------------------- @@ -384,21 +408,21 @@ server again by running: $ 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/ - -- cgit v1.2.1