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
--------------------------
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
------------
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
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
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
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.
(+) 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)
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
--------------------
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
----------------------
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
-------------------
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
--------------------
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
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/
-
projects / apache / commitdiff