granicus.if.org Git - apache/blob - INSTALL

   1
   2   APACHE INSTALLATION OVERVIEW
   3
   4   Quick Start - Unix
   5   ------------------
   6
   7   For complete installation documentation, see [ht]docs/manual/install.html or
   8   http://httpd.apache.org/docs/trunk/install.html
   9
  10      $ ./configure --prefix=PREFIX
  11      $ make
  12      $ make install
  13      $ PREFIX/bin/apachectl start
  14
  15      NOTES: * Replace PREFIX with the filesystem path under which
  16               Apache should be installed.  A typical installation
  17               might use "/usr/local/apache2" for PREFIX (without the
  18               quotes).
  19
  20             * Read the section "APR - Unix" below.
  21
  22             * If you are a developer building Apache directly from
  23               Subversion, you will need to run ./buildconf before running
  24               configure. This script bootstraps the build environment and
  25               requires Python as well as GNU autoconf and libtool. If you
  26               build Apache from a release tarball, you don't have to run
  27               buildconf.
  28
  29             * If you want to build a threaded MPM (for instance worker)
  30               on  FreeBSD, be aware that threads do not work well with
  31               Apache on FreeBSD versions before 5.4-RELEASE. If you wish
  32               to try a threaded Apache on an earlier version of FreeBSD,
  33               use the --enable-threads parameter to ./configure in
  34               addition to the --with-mpm parameter.
  35
  36             * If you are building directly from Subversion on Mac OS X
  37               (Darwin), make sure to use GNU Libtool 1.4.2 or newer. All
  38               recent versions of the developer tools on this platform
  39               include a sufficiently recent version of GNU Libtool (named
  40               glibtool, but buildconf knows where to find it).
  41
  42   For a short impression of what possibilities you have, here is a
  43   typical example which configures Apache for the installation tree
  44   /sw/pkg/apache with a particular compiler and flags plus the two
  45   additional modules mod_rewrite and mod_speling for later loading
  46   through the DSO mechanism:
  47
  48      $ CC="pgcc" CFLAGS="-O2" \
  49      ./configure --prefix=/sw/pkg/apache \
  50      --enable-rewrite=shared \
  51      --enable-speling=shared
  52
  53   The easiest way to find all of the configuration flags for Apache 2.5
  54   is to run ./configure --help.
  55
  56   APR - Unix
  57   ----------
  58
  59   httpd trunk (httpd development version 2.5) can use APR trunk (future
  60   APR version 2.0) or the combination of the current APR 1.x branch and
  61   the current APR-util 1.x branch.  (APR trunk bundles the features in
  62   APR-util 1.x.)
  63
  64   The httpd buildconf step, required when building httpd from Subversion,
  65   must have access to the APR source.  The httpd configure step, always
  66   required, can configure the APR source in srclib or use a previously-
  67   built APR.
  68
  69   APR (and APR-util if using APR 1.x) can be built with httpd from httpd's
  70   srclib directory or can be built separately, prior to building httpd.
  71
  72   Building APR with httpd from httpd's srclib directory is required if
  73   you don't have the compiler which the system APR was built with, and it
  74   can also be advantageous if you are a developer who will be linking your
  75   code with httpd or using a debugger to step through server code, as it
  76   removes the possibility of version or compile-option mismatches with
  77   APR and APR-util code.
  78
  79   To use APR trunk in srclib:
  80
  81     Check out APR trunk in srclib/apr with the following command:
  82
  83     svn co http://svn.apache.org/repos/asf/apr/apr/trunk srclib/apr
  84
  85     buildconf will find it automatically.  Use the --with-included-apr
  86     argument to httpd configure.
  87
  88   To use APR 1.x and APR-util 1.x in srclib:
  89
  90     Check out the current branches as srclib/apr and srclib/apr-util with
  91     the following commands:
  92
  93     svn co http://svn.apache.org/repos/asf/apr/apr/branches/1.5.x srclib/apr
  94     svn co http://svn.apache.org/repos/asf/apr/apr-util/branches/1.5.x srclib/apr-util
  95
  96     buildconf will find them automatically.  Use the --with-included-apr
  97     argument to httpd configure.
  98
  99   To use existing checkouts of APR (and APR-util if using APR 1.x):
 100
 101     httpd buildconf must have access to the source trees.  Use these arguments
 102     to httpd buildconf:
 103
 104     --with-apr=[path to apr source] --with-apr-util=[path to apr-util source]
 105
 106     (Omit --with-apr-util if using APR trunk.)
 107
 108     httpd configure must have access to a previously build apr.  Use these
 109     arguments to httpd configure:
 110
 111     --with-apr=[path to apr install] --with-apr-util=[path to apr-util install]
 112
 113     (Omit --with-apr-util if using APR trunk.)
 114
 115
 116   Quick Start - Windows
 117   ---------------------
 118
 119   For complete documentation, see manual/platform/windows.html.en or
 120   http://httpd.apache.org/docs/trunk/platform/windows.html.
 121
 122   The Apache/Win32 binaries are distributed as Windows Installer packages
 123   (.msi) named httpd-2.5.xx-win32-x86-no_ssl.msi for a version without mod_ssl
 124   and httpd-2.5.xx-win32-x86-openssl-1.0.1x.msi for a version including the
 125   mod_ssl plus the openssl library and command line utility.  Additional 64 bit
 126   binaries have similarly named -win64-x64 package names.  These packages
 127   may be unpacked without "installing" them by using the msiexec /a option.
 128
 129   If you have unpacked a source distribution (named httpd-2.5.x-win32-src.zip,
 130   without any -x86 or -x64 notation) you must compile the package yourself,
 131   see the links mentioned above.  Unless you intended to do this, please look
 132   again for an .msi package in http://www.apache.org/dist/httpd/binaries/win32/
 133   and install that desired .msi package.
 134
 135   The .msi package configures the httpd.conf file, and installs and starts
 136   the Apache2.x service for you.  It also installs plenty of useful shortcuts
 137   and the taskbar ApacheMonitor.  We strongly encourage you to use it.
 138
 139
 140   Postscript
 141   ----------
 142
 143   To obtain help with installation problems, please see the resources at
 144   <http://httpd.apache.org/support.html>
 145
 146   Thanks for using the Apache HTTP Server, version 2.5.
 147
 148                                      The Apache Software Foundation
 149                                      http://www.apache.org/