mirror of
https://github.com/apache/httpd.git
synced 2025-04-18 22:24:07 +03:00
Submitted by: Vladimír Chlup <vchlup redhat.com> Github: closes #437 git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1923812 13f79535-47bb-0310-9956-ffa450edef68
142 lines
5.2 KiB
Plaintext
142 lines
5.2 KiB
Plaintext
|
|
APACHE INSTALLATION OVERVIEW
|
|
|
|
Quick Start - Unix
|
|
------------------
|
|
|
|
For complete installation documentation, see [ht]docs/manual/install.html or
|
|
http://httpd.apache.org/docs/trunk/install.html
|
|
|
|
$ ./configure --prefix=PREFIX
|
|
$ make
|
|
$ make install
|
|
$ PREFIX/bin/apachectl start
|
|
|
|
NOTES: * Replace PREFIX with the filesystem path under which
|
|
Apache should be installed. A typical installation
|
|
might use "/usr/local/apache2" for PREFIX (without the
|
|
quotes).
|
|
|
|
* Read the section "APR - Unix" below.
|
|
|
|
* If you are a developer building Apache directly from
|
|
Subversion, you will need to run ./buildconf before running
|
|
configure. This script bootstraps the build environment and
|
|
requires Python as well as GNU autoconf and libtool. If you
|
|
build Apache from a release tarball, you don't have to run
|
|
buildconf.
|
|
|
|
* If you want to build a threaded MPM (for instance worker)
|
|
on FreeBSD, be aware that threads do not work well with
|
|
Apache on FreeBSD versions before 5.4-RELEASE. If you wish
|
|
to try a threaded Apache on an earlier version of FreeBSD,
|
|
use the --enable-threads parameter to ./configure in
|
|
addition to the --with-mpm parameter.
|
|
|
|
* If you are building directly from Subversion on Mac OS X
|
|
(Darwin), make sure to use GNU Libtool 1.4.2 or newer. All
|
|
recent versions of the developer tools on this platform
|
|
include a sufficiently recent version of GNU Libtool (named
|
|
glibtool, but buildconf knows where to find it).
|
|
|
|
For a short impression of what possibilities you have, here is a
|
|
typical example which configures Apache for the installation tree
|
|
/sw/pkg/apache with a particular compiler and flags plus the two
|
|
additional modules mod_rewrite and mod_speling for later loading
|
|
through the DSO mechanism:
|
|
|
|
$ CC="pgcc" CFLAGS="-O2" \
|
|
./configure --prefix=/sw/pkg/apache \
|
|
--enable-rewrite=shared \
|
|
--enable-speling=shared
|
|
|
|
The easiest way to find all of the configuration flags for Apache 2.5
|
|
is to run ./configure --help.
|
|
|
|
APR - Unix
|
|
----------
|
|
|
|
httpd trunk (httpd development version 2.5) can use APR trunk (future
|
|
APR version 2.0) or the combination of the current APR 1.x branch and
|
|
the current APR-util 1.x branch. (APR trunk bundles the features in
|
|
APR-util 1.x.)
|
|
|
|
The httpd buildconf step, required when building httpd from Subversion,
|
|
must have access to the APR source. The httpd configure step, always
|
|
required, can configure the APR source in srclib or use a previously-
|
|
built APR.
|
|
|
|
APR (and APR-util if using APR 1.x) can be built with httpd from httpd's
|
|
srclib directory or can be built separately, prior to building httpd.
|
|
|
|
Building APR with httpd from httpd's srclib directory is required if
|
|
you don't have the compiler which the system APR was built with, and it
|
|
can also be advantageous if you are a developer who will be linking your
|
|
code with httpd or using a debugger to step through server code, as it
|
|
removes the possibility of version or compile-option mismatches with
|
|
APR and APR-util code.
|
|
|
|
To use APR trunk in srclib:
|
|
|
|
Check out APR trunk in srclib/apr with the following command:
|
|
|
|
git clone https://github.com/apache/apr.git srclib/apr
|
|
|
|
or alternatively using svn:
|
|
|
|
svn co http://svn.apache.org/repos/asf/apr/apr/trunk srclib/apr
|
|
|
|
buildconf will find it automatically. Use the --with-included-apr
|
|
argument to httpd configure.
|
|
|
|
To use APR 1.x and APR-util 1.x in srclib:
|
|
|
|
Check out the current branches as srclib/apr and srclib/apr-util with
|
|
the following commands:
|
|
|
|
git clone -b 1.7.x https://github.com/apache/apr.git srclib/apr
|
|
git clone -b 1.6.x https://github.com/apache/apr-util.git srclib/apr-util
|
|
|
|
or alternatively using svn:
|
|
|
|
svn co http://svn.apache.org/repos/asf/apr/apr/branches/1.7.x srclib/apr
|
|
svn co http://svn.apache.org/repos/asf/apr/apr-util/branches/1.6.x srclib/apr-util
|
|
|
|
buildconf will find them automatically. Use the --with-included-apr
|
|
argument to httpd configure.
|
|
|
|
To use existing checkouts of APR (and APR-util if using APR 1.x):
|
|
|
|
httpd buildconf must have access to the source trees. Use these arguments
|
|
to httpd buildconf:
|
|
|
|
--with-apr=[path to apr source] --with-apr-util=[path to apr-util source]
|
|
|
|
(Omit --with-apr-util if using APR trunk.)
|
|
|
|
httpd configure must have access to a previously build apr. Use these
|
|
arguments to httpd configure:
|
|
|
|
--with-apr=[path to apr install] --with-apr-util=[path to apr-util install]
|
|
|
|
(Omit --with-apr-util if using APR trunk.)
|
|
|
|
|
|
Quick Start - Windows
|
|
---------------------
|
|
|
|
For complete documentation, see manual/platform/windows.html.en or
|
|
<http://httpd.apache.org/docs/trunk/platform/windows.html>
|
|
|
|
|
|
Postscript
|
|
----------
|
|
|
|
To obtain help with installation problems, please see the resources at
|
|
<http://httpd.apache.org/support.html>
|
|
|
|
Thanks for using the Apache HTTP Server, version 2.5.
|
|
|
|
The Apache Software Foundation
|
|
http://www.apache.org/
|