INSTALL revision 2f331bc16ab82343fd90bf5b3395361876bef7fc
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan APACHE INSTALLATION OVERVIEW
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan Quick Start - Unix
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan ------------------
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan For complete installation documentation, see [ht]docs/manual/install.html or
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan $ ./configure --prefix=PREFIX
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan $ make install
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan NOTES: * Replace PREFIX with the filesystem path under which
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan Apache should be installed. A typical installation
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan might use "/usr/local/apache2" for PREFIX (without the
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan * If you want to build a threaded MPM (for instance worker)
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan on FreeBSD, be aware that threads do not work well with
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan Apache on FreeBSD versions before 5.4-RELEASE. If you wish
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan to try a threaded Apache on an earlier version of FreeBSD,
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan use the --enable-threads parameter to ./configure in
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan addition to the --with-mpm parameter.
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan * If you are a developer building Apache directly from
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan Subversion, you will need to run ./buildconf before running
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan configure. This script bootstraps the build environment and
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan requires Python as well as GNU autoconf and libtool. If you
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan build Apache from a release tarball, you don't have to run
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan * If you are building directly from Subversion on Mac OS X
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan (Darwin), make sure to use GNU Libtool 1.4.2 or newer. All
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan recent versions of the developer tools on this platform
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan include a sufficiently recent version of GNU Libtool (named
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan glibtool, but buildconf knows where to find it).
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan For a short impression of what possibilities you have, here is a
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan typical example which configures Apache for the installation tree
e6d7ebe1d98f7f030969e521b061f8643253475eDirk Hogan /sw/pkg/apache with a particular compiler and flags plus the two
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan additional modules mod_rewrite and mod_speling for later loading
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan through the DSO mechanism:
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan $ CC="pgcc" CFLAGS="-O2" \
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan ./configure --prefix=/sw/pkg/apache \
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan --enable-rewrite=shared \
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan --enable-speling=shared
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan The easiest way to find all of the configuration flags for Apache 2.3
dcf0ce40c27bbcd1b429aaf915b5dfa385a59d7eDirk Hogan is to run ./configure --help.
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan Quick Start - Windows
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan ---------------------
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan For complete documentation, see [ht]docs/manual/platform/windows.html or
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan http://httpd.apache.org/docs/2.3/platform/windows.html.
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan The Apache/Win32 binaries are primarily distributed as a Windows Installer
dcf0ce40c27bbcd1b429aaf915b5dfa385a59d7eDirk Hogan package (.msi), and may be available as a .zip file as well. These packages
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan are named apache-2.3.xx-win32-x86.msi and apache-2.3.xx-win32-x86.zip.
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan Please choose the .msi package if at all possible. Note that Apache version
dcf0ce40c27bbcd1b429aaf915b5dfa385a59d7eDirk Hogan 2.3 is a development version and binaries may not be available. Use a
dcf0ce40c27bbcd1b429aaf915b5dfa385a59d7eDirk Hogan released version from the stable 2.2 branch instead.
e6d7ebe1d98f7f030969e521b061f8643253475eDirk Hogan If you have unpacked a source distribution (named httpd-2.3-xx.zip, without
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan any -win32-x86 notation) you must compile the package yourself, see the links
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan mentioned above. Unless you intended to do this, please look again for the
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan binary package from http://www.apache.org/dist/httpd/binaries/win32/ and
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan install that .msi (or .zip package, if you must.)
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan If you have unpacked this binary distribution from the .zip package, you
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan _must_ edit the conf/httpd.conf file (with notepad or another text editor)
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan to reflect the correct ServerName, Domain, and directory paths. Search for
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan the text "@@" to discover what you must edit. To install and start the
9d406c6b25ce9f6bf266b077443e723b95962914Dirk Hogan 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