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