97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd APACHE INSTALLATION OVERVIEW
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd Quick Start - Unix
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd ------------------
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd For complete installation documentation, see [ht]docs/manual/install.html or
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd $ ./configure --prefix=PREFIX
2e545ce2450a9953665f701bb05350f0d3f26275nd $ make install
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd NOTES: * Replace PREFIX with the filesystem path under which
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd Apache should be installed. A typical installation
af33a4994ae2ff15bc67d19ff1a7feb906745bf8rbowen might use "/usr/local/apache2" for PREFIX (without the
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd * Read the section "APR - Unix" below.
3f08db06526d6901aa08c110b5bc7dde6bc39905nd * If you are a developer building Apache directly from
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd Subversion, you will need to run ./buildconf before running
9472e4d3c410be3b3f1addbf3b1db1769f64e765nd configure. This script bootstraps the build environment and
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd requires Python as well as GNU autoconf and libtool. If you
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd build Apache from a release tarball, you don't have to run
7f5b59ccc63c0c0e3e678a168f09ee6a2f51f9d0nd buildconf.
fac8c35bfb158112226ab43ddf84d59daca5dc30nd * If you want to build a threaded MPM (for instance worker)
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung on FreeBSD, be aware that threads do not work well with
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd Apache on FreeBSD versions before 5.4-RELEASE. If you wish
4b575a6b6704b516f22d65a3ad35696d7b9ba372rpluem to try a threaded Apache on an earlier version of FreeBSD,
4b575a6b6704b516f22d65a3ad35696d7b9ba372rpluem use the --enable-threads parameter to ./configure in
4b575a6b6704b516f22d65a3ad35696d7b9ba372rpluem addition to the --with-mpm parameter.
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd * If you are building directly from Subversion on Mac OS X
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd (Darwin), make sure to use GNU Libtool 1.4.2 or newer. All
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd recent versions of the developer tools on this platform
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd include a sufficiently recent version of GNU Libtool (named
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd glibtool, but buildconf knows where to find it).
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd For a short impression of what possibilities you have, here is a
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd typical example which configures Apache for the installation tree
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd /sw/pkg/apache with a particular compiler and flags plus the two
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd additional modules mod_rewrite and mod_speling for later loading
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd through the DSO mechanism:
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd $ CC="pgcc" CFLAGS="-O2" \
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh ./configure --prefix=/sw/pkg/apache \
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd --enable-rewrite=shared \
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd --enable-speling=shared
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd The easiest way to find all of the configuration flags for Apache 2.5
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd is to run ./configure --help.
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd APR - Unix
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd ----------
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd httpd trunk (httpd development version 2.5) can use APR trunk (future
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd APR version 2.0) or the combination of the current APR 1.x branch and
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd the current APR-util 1.x branch. (APR trunk bundles the features in
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd The httpd buildconf step, required when building httpd from Subversion,
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd must have access to the APR source. The httpd configure step, always
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd required, can configure the APR source in srclib or use a previously-
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd built APR.
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd APR (and APR-util if using APR 1.x) can be built with httpd from httpd's
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd srclib directory or can be built separately, prior to building httpd.
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd Building APR with httpd from httpd's srclib directory is required if
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd you don't have the compiler which the system APR was built with, and it
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd can also be advantageous if you are a developer who will be linking your
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd code with httpd or using a debugger to step through server code, as it
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd removes the possibility of version or compile-option mismatches with
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd APR and APR-util code.
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd To use APR trunk in srclib:
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd Check out APR trunk in srclib/apr with the following command:
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd svn co http://svn.apache.org/repos/asf/apr/apr/trunk srclib/apr
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd buildconf will find it automatically. Use the --with-included-apr
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd argument to httpd configure.
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd Check out the current branches as srclib/apr and srclib/apr-util with
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd the following commands:
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd svn co http://svn.apache.org/repos/asf/apr/apr/branches/1.5.x srclib/apr
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd svn co http://svn.apache.org/repos/asf/apr/apr-util/branches/1.5.x srclib/apr-util
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd buildconf will find them automatically. Use the --with-included-apr
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd argument to httpd configure.
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd To use existing checkouts of APR (and APR-util if using APR 1.x):
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd httpd buildconf must have access to the source trees. Use these arguments
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd to httpd buildconf:
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd --with-apr=[path to apr source] --with-apr-util=[path to apr-util source]
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd (Omit --with-apr-util if using APR trunk.)
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd httpd configure must have access to a previously build apr. Use these
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd arguments to httpd configure:
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd --with-apr=[path to apr install] --with-apr-util=[path to apr-util install]
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd (Omit --with-apr-util if using APR trunk.)
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd Quick Start - Windows
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd ---------------------
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd For complete documentation, see manual/platform/windows.html.en or
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd http://httpd.apache.org/docs/trunk/platform/windows.html.
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd The Apache/Win32 binaries are distributed as Windows Installer packages
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd (.msi) named httpd-2.5.xx-win32-x86-no_ssl.msi for a version without mod_ssl
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd and httpd-2.5.xx-win32-x86-openssl-1.0.1x.msi for a version including the
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd mod_ssl plus the openssl library and command line utility. Additional 64 bit
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd binaries have similarly named -win64-x64 package names. These packages
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd may be unpacked without "installing" them by using the msiexec /a option.
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd If you have unpacked a source distribution (named httpd-2.5.x-win32-src.zip,
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd without any -x86 or -x64 notation) you must compile the package yourself,
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd see the links mentioned above. Unless you intended to do this, please look
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd again for an .msi package in http://www.apache.org/dist/httpd/binaries/win32/
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd and install that desired .msi package.
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd The .msi package configures the httpd.conf file, and installs and starts
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd the Apache2.x service for you. It also installs plenty of useful shortcuts
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd and the taskbar ApacheMonitor. We strongly encourage you to use it.
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd Postscript
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd ----------
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd To obtain help with installation problems, please see the resources at
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd Thanks for using the Apache HTTP Server, version 2.5.
97a3ecc40b65d5f8e865bbe0b1c9325d8c016e34nd The Apache Software Foundation