INSTALL revision 205d797f9c660398724a3d4a50f96f30f282edd7
98N/A
98N/A APACHE INSTALLATION OVERVIEW
606N/A
98N/A Quick Start - Unix
98N/A ------------------
98N/A
98N/A For complete installation documentation, see [ht]docs/manual/install.html or
98N/A http://httpd.apache.org/docs/2.5/install.html
98N/A
98N/A $ ./configure --prefix=PREFIX
98N/A $ make
98N/A $ make install
98N/A $ PREFIX/bin/apachectl start
98N/A
98N/A NOTES: * Replace PREFIX with the filesystem path under which
98N/A Apache should be installed. A typical installation
98N/A might use "/usr/local/apache2" for PREFIX (without the
98N/A quotes).
98N/A
98N/A * Consider if you need to use the bundled APR and APR-Util
98N/A via ./configure's --with-included-apr option, to use the
98N/A bundled source instead of a previously installed APR and
98N/A APR-Util (such as those provided with many OSes). This
98N/A is required if you don't have the compiler which the
98N/A system APR was built with. This can be advantageous if
98N/A you are a developer who will be linking your code with
98N/A Apache or using a debugger to step through server code,
98N/A as it removes the possibility of version or compile-option
98N/A mismatches with APR and APR-util code.
98N/A
606N/A * If you are a developer building Apache directly from
98N/A Subversion, you will need to run ./buildconf before running
98N/A configure. This script bootstraps the build environment and
493N/A requires Python as well as GNU autoconf and libtool. If you
493N/A build Apache from a release tarball, you don't have to run
98N/A buildconf.
98N/A
606N/A * If you want to build a threaded MPM (for instance worker)
98N/A on FreeBSD, be aware that threads do not work well with
98N/A Apache on FreeBSD versions before 5.4-RELEASE. If you wish
493N/A to try a threaded Apache on an earlier version of FreeBSD,
493N/A use the --enable-threads parameter to ./configure in
98N/A addition to the --with-mpm parameter.
98N/A
156N/A * If you are building directly from Subversion on Mac OS X
156N/A (Darwin), make sure to use GNU Libtool 1.4.2 or newer. All
493N/A recent versions of the developer tools on this platform
493N/A include a sufficiently recent version of GNU Libtool (named
493N/A glibtool, but buildconf knows where to find it).
493N/A
493N/A For a short impression of what possibilities you have, here is a
493N/A typical example which configures Apache for the installation tree
493N/A /sw/pkg/apache with a particular compiler and flags plus the two
98N/A additional modules mod_rewrite and mod_speling for later loading
98N/A through the DSO mechanism:
98N/A
606N/A $ CC="pgcc" CFLAGS="-O2" \
606N/A ./configure --prefix=/sw/pkg/apache \
606N/A --enable-rewrite=shared \
606N/A --enable-speling=shared
606N/A
606N/A The easiest way to find all of the configuration flags for Apache 2.5
606N/A is to run ./configure --help.
606N/A
606N/A
606N/A Quick Start - Windows
606N/A ---------------------
606N/A
606N/A For complete documentation, see [ht]docs/manual/platform/windows.html or
606N/A http://httpd.apache.org/docs/2.5/platform/windows.html.
606N/A
606N/A The Apache/Win32 binaries are primarily distributed as a Windows Installer
606N/A package (.msi), and may be available as a .zip file as well. These packages
606N/A are named apache-2.5.xx-win32-x86.msi and apache-2.5.xx-win32-x86.zip.
606N/A Please choose the .msi package if at all possible. Note that Apache version
606N/A 2.5 is a development version and binaries may not be available. Use a
606N/A released version from the stable 2.2 branch instead.
606N/A
606N/A If you have unpacked a source distribution (named httpd-2.5-xx.zip, without
606N/A any -win32-x86 notation) you must compile the package yourself, see the links
606N/A mentioned above. Unless you intended to do this, please look again for the
98N/A binary package from http://www.apache.org/dist/httpd/binaries/win32/ and
493N/A install that .msi (or .zip package, if you must.)
493N/A
493N/A If you have unpacked this binary distribution from the .zip package, you
98N/A _must_ edit the conf/httpd.conf file (with notepad or another text editor)
606N/A to reflect the correct ServerName, Domain, and directory paths. Search for
606N/A the text "@@" to discover what you must edit. To install and start the
606N/A service after you have corrected the httpd.conf file, use the command
98N/A
606N/A bin\httpd.exe -k install
606N/A bin\httpd.exe -k start
98N/A
606N/A The .msi package configures the httpd.conf file, and installs and starts
606N/A the Apache2 service for you. It also installs plenty of useful shortcuts
98N/A and the taskbar ApacheMonitor. We strongly encourage you to use it.
493N/A
493N/A
98N/A Postscript
493N/A ----------
493N/A
493N/A The Apache HTTP Server group cannot field user's installation questions.
493N/A There are many valuable forums to help you get started. Please refer your
98N/A questions to the appropriate forum, such as the Users Mailing List at
606N/A http://httpd.apache.org/userslist.html or the usenet newsgroups
606N/A comp.infosystems.www.servers.unix or
606N/A comp.infosystems.www.servers.ms-windows.
493N/A
606N/A Thanks for using the Apache HTTP Server, version 2.5.
606N/A
606N/A The Apache Software Foundation
http://www.apache.org/