INSTALL revision 8744b27bf2f08d2acb55f3e77231ab9b59d5d333
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim APACHE INSTALLATION OVERVIEW
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim Quick Start - Unix
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim ------------------
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim For complete installation documentation, see [ht]docs/manual/install.html or
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim $ ./configure --prefix=PREFIX
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim $ make install
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim NOTES: * Replace PREFIX with the filesystem path under which
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim Apache should be installed. A typical installation
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim might use "/usr/local/apache2" for PREFIX (without the
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim * If you are a developer who will be linking your code with
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim Apache or using a debugger to step through server code,
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim ./configure's --with-included-apr option may be advantageous,
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim as it removes the possibility of version or compile-option
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim mismatches with APR and APR-util code. (Many OSes now
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim include their own version of APR and APR-util.)
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim * If you are a developer building Apache directly from
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim Subversion, you will need to run ./buildconf before running
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim configure. This script bootstraps the build environment and
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim requires Python as well as GNU autoconf and libtool. If you
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim build Apache from a release tarball, you don't have to run
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim * If you want to build a threaded MPM (for instance worker)
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim on FreeBSD, be aware that threads do not work well with
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim Apache on FreeBSD versions before 5.4-RELEASE. If you wish
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim to try a threaded Apache on an earlier version of FreeBSD,
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim use the --enable-threads parameter to ./configure in
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim addition to the --with-mpm parameter.
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim * If you are building directly from Subversion on Mac OS X
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim (Darwin), make sure to use GNU Libtool 1.4.2 or newer. All
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim recent versions of the developer tools on this platform
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim include a sufficiently recent version of GNU Libtool (named
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim glibtool, but buildconf knows where to find it).
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim For a short impression of what possibilities you have, here is a
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim typical example which configures Apache for the installation tree
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim /sw/pkg/apache with a particular compiler and flags plus the two
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim additional modules mod_rewrite and mod_speling for later loading
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim through the DSO mechanism:
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim $ CC="pgcc" CFLAGS="-O2" \
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim ./configure --prefix=/sw/pkg/apache \
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim --enable-rewrite=shared \
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim --enable-speling=shared
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim The easiest way to find all of the configuration flags for Apache 2.3
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim is to run ./configure --help.
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim Quick Start - Windows
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim ---------------------
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim For complete documentation, see [ht]docs/manual/platform/windows.html or
9e86db79b7d1bbc5f2f04e99954cbd5eae0e22bbHyon Kim http://httpd.apache.org/docs/2.3/platform/windows.html.
The Apache/Win32 binaries are primarily distributed as a Windows Installer
If you have unpacked a source distribution (named httpd-2.3-xx.zip, without
binary package from http://www.apache.org/dist/httpd/binaries/win32/ and
_must_ edit the conf/httpd.conf file (with notepad or another text editor)
service after you have corrected the httpd.conf file, use the command
bin\httpd.exe -k install
bin\httpd.exe -k start
The .msi package configures the httpd.conf file, and installs and starts
http://httpd.apache.org/userslist.html or the usenet newsgroups