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