INSTALL revision 8744b27bf2f08d2acb55f3e77231ab9b59d5d333
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
8744b27bf2f08d2acb55f3e77231ab9b59d5d333jerenkrantz * If you are a developer who will be linking your code with
8744b27bf2f08d2acb55f3e77231ab9b59d5d333jerenkrantz Apache or using a debugger to step through server code,
8744b27bf2f08d2acb55f3e77231ab9b59d5d333jerenkrantz ./configure's --with-included-apr option may be advantageous,
8744b27bf2f08d2acb55f3e77231ab9b59d5d333jerenkrantz as it removes the possibility of version or compile-option
8744b27bf2f08d2acb55f3e77231ab9b59d5d333jerenkrantz mismatches with APR and APR-util code. (Many OSes now
8744b27bf2f08d2acb55f3e77231ab9b59d5d333jerenkrantz include their own version of APR and APR-util.)
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
39c36cbd2a461e4fe1bdd0a860db587d420445c7sctemme The easiest way to find all of the configuration flags for Apache 2.3
7a6c08288f79ab1734b98afc114e52cd71f898c0jwoolley is to run ./configure --help.
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe Quick Start - Windows
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe ---------------------
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe For complete documentation, see [ht]docs/manual/platform/windows.html or
2f331bc16ab82343fd90bf5b3395361876bef7fcerikabele http://httpd.apache.org/docs/2.3/platform/windows.html.
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe The Apache/Win32 binaries are primarily distributed as a Windows Installer
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe package (.msi), and may be available as a .zip file as well. These packages
39c36cbd2a461e4fe1bdd0a860db587d420445c7sctemme are named apache-2.3.xx-win32-x86.msi and apache-2.3.xx-win32-x86.zip.
39c36cbd2a461e4fe1bdd0a860db587d420445c7sctemme Please choose the .msi package if at all possible. Note that Apache version
39c36cbd2a461e4fe1bdd0a860db587d420445c7sctemme 2.3 is a development version and binaries may not be available. Use a
39c36cbd2a461e4fe1bdd0a860db587d420445c7sctemme released version from the stable 2.2 branch instead.
39c36cbd2a461e4fe1bdd0a860db587d420445c7sctemme If you have unpacked a source distribution (named httpd-2.3-xx.zip, without
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe any -win32-x86 notation) you must compile the package yourself, see the links
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe mentioned above. Unless you intended to do this, please look again for the
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe binary package from http://www.apache.org/dist/httpd/binaries/win32/ and
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe install that .msi (or .zip package, if you must.)
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe If you have unpacked this binary distribution from the .zip package, you
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe _must_ edit the conf/httpd.conf file (with notepad or another text editor)
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe to reflect the correct ServerName, Domain, and directory paths. Search for
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe the text "@@" to discover what you must edit. To install and start the
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe service after you have corrected the httpd.conf file, use the command
0e16ae40a252fc71f93d0e5afe15b614c810e814pctony bin\httpd.exe -k install
0e16ae40a252fc71f93d0e5afe15b614c810e814pctony bin\httpd.exe -k start
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe The .msi package configures the httpd.conf file, and installs and starts
6f4e1cd73ca28a9876f1a37a6cdfd613eab6ec37wrowe the Apache2 service for you. It also installs plenty of useful shortcuts
6f4e1cd73ca28a9876f1a37a6cdfd613eab6ec37wrowe and the taskbar ApacheMonitor. We strongly encourage you to use it.
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe The Apache HTTP Server group cannot field user's installation questions.
ce4eec7f83c4bc6daba6a02eff0275a6f3878e5ewrowe There are many valuable forums to help you get started. Please refer your
c6db3f5916ebd715971c3db837be9143394f8aa9slive questions to the appropriate forum, such as the Users Mailing List at
c6db3f5916ebd715971c3db837be9143394f8aa9slive http://httpd.apache.org/userslist.html or the usenet newsgroups
39c36cbd2a461e4fe1bdd0a860db587d420445c7sctemme Thanks for using the Apache HTTP Server, version 2.3.
7a6c08288f79ab1734b98afc114e52cd71f898c0jwoolley The Apache Software Foundation