install.html.en revision 77c77cf89621f21c8e2bbad63058b5eaa5f88d4a
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster This file is generated from xml source: DO NOT EDIT
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<title>Compiling and Installing - Apache HTTP Server</title>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<link href="/images/favicon.ico" rel="shortcut icon" /></head>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<p class="apache">Apache HTTP Server Version 2.3</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Compiling and Installing</h1>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<p><span>Available Languages: </span><a href="/de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<a href="/en/install.html" title="English"> en </a> |
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<a href="/es/install.html" hreflang="es" rel="alternate" title="Espa�ol"> es </a> |
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<a href="/fr/install.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> |
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<a href="/ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<a href="/ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>This document covers compilation and installation of Apache
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster on Unix and Unix-like systems only. For compiling and
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster installation on Windows, see <a href="platform/windows.html">Using Apache with Microsoft
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Windows</a>. For other platforms, see the <a href="platform/">platform</a> documentation.</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>Apache httpd uses <code>libtool</code> and <code>autoconf</code>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster to create a build environment that looks like many other Open Source
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster projects.</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>If you are upgrading from one minor version to the next (for
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster example, 2.2.50 to 2.2.51), please skip down to the <a href="#upgrading">upgrading</a> section.</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#overview">Overview for the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<li><img alt="" src="/images/down.gif" /> <a href="#requirements">Requirements</a></li>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<li><img alt="" src="/images/down.gif" /> <a href="#download">Download</a></li>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<li><img alt="" src="/images/down.gif" /> <a href="#extract">Extract</a></li>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<li><img alt="" src="/images/down.gif" /> <a href="#configure">Configuring the source tree</a></li>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<li><img alt="" src="/images/down.gif" /> <a href="#compile">Build</a></li>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<li><img alt="" src="/images/down.gif" /> <a href="#install">Install</a></li>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<li><img alt="" src="/images/down.gif" /> <a href="#customize">Customize</a></li>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<li><img alt="" src="/images/down.gif" /> <a href="#test">Test</a></li>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<li><img alt="" src="/images/down.gif" /> <a href="#upgrading">Upgrading</a></li>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster</ul><h3>See also</h3><ul class="seealso"><li><a href="programs/configure.html">Configure the source tree</a></li><li><a href="invoking.html">Starting Apache</a></li><li><a href="stopping.html">Stopping and Restarting</a></li></ul></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<h2><a name="overview" id="overview">Overview for the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <td><code>$ lynx http://httpd.apache.org/download.cgi</code>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <td><code>$ gzip -d httpd-<em>NN</em>.tar.gz<br />
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <td><code>$ /configure --prefix=<em>PREFIX</em></code>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <td><code>$ <em>PREFIX</em>/bin/apachectl -k start</code>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p><em>NN</em> must be replaced with the current version
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster number, and <em>PREFIX</em> must be replaced with the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster filesystem path under which the server should be installed. If
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <em>PREFIX</em> is not specified, it defaults to
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>Each section of the compilation and installation process is
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster described in more detail below, beginning with the requirements
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster for compiling and installing Apache httpd.</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<h2><a name="requirements" id="requirements">Requirements</a></h2>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>The following requirements exist for building Apache:</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <dd>Make sure you have at least 50 MB of temporary free disk
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster space available. After installation Apache occupies
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster approximately 10 MB of disk space. The actual disk space
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster requirements will vary considerably based on your chosen
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster configuration options and any third-party modules.</dd>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <dd>Make sure you have an ANSI-C compiler installed. The <a href="http://www.gnu.org/software/gcc/gcc.html">GNU C
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster compiler (GCC)</a> from the <a href="http://www.gnu.org/">Free Software Foundation (FSF)</a>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster is recommended. If you don't have GCC
ae2aee96fc0dc24ac5b108d0c40e1f3b735f4ca3Sam Fraser then at least make sure your vendor's compiler is ANSI
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster compliant. In addition, your <code>PATH</code> must contain
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster basic build tools such as <code>make</code>.</dd>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <dd>Elements of the HTTP protocol are expressed as the time of
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster day. So, it's time to investigate setting some time
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster synchronization facility on your system. Usually the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <code>ntpdate</code> or <code>xntpd</code> programs are used for
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster this purpose which are based on the Network Time Protocol (NTP).
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster homepage</a> for more details about NTP software and public
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster time servers.</dd>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster [OPTIONAL]</dt>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <dd>For some of the support scripts like <code class="program"><a href="/programs/apxs.html">apxs</a></code> or <code class="program"><a href="/programs/dbmmanage.html">dbmmanage</a></code> (which are
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster written in Perl) the Perl 5 interpreter is required (versions
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster 5.003 or newer are sufficient). If you have multiple Perl
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster interpreters (for example, a systemwide install of Perl 4, and
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster your own install of Perl 5), you are advised to use the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <code>--with-perl</code> option (see below) to make sure the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster correct one is used by <code class="program"><a href="/programs/configure.html">configure</a></code>.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster If no Perl 5 interpreter is found by the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <code class="program"><a href="/programs/configure.html">configure</a></code> script, you will not be able to use
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster the affected support scripts. Of course, you will still be able to
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster build and use Apache httpd.</dd>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<h2><a name="download" id="download">Download</a></h2>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>The Apache HTTP Server can be downloaded from the <a href="http://httpd.apache.org/download.cgi">Apache HTTP Server
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster download site</a>, which lists several mirrors. Most users of
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Apache on unix-like systems will be better off downloading and
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster compiling a source version. The build process (described below) is
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster easy, and it allows you to customize your server to suit your needs.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster In addition, binary releases are often not up to date with the latest
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster source releases. If you do download a binary, follow the instructions
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster in the <code>INSTALL.bindist</code> file inside the distribution.</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>After downloading, it is important to verify that you have a
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster complete and unmodified version of the Apache HTTP Server. This
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster can be accomplished by testing the downloaded tarball against the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster PGP signature. Details on how to do this are available on the <a href="http://httpd.apache.org/download.cgi#verify">download
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster page</a> and an extended example is available describing the <a href="http://httpd.apache.org/dev/verification.html">use of
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<h2><a name="extract" id="extract">Extract</a></h2>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>Extracting the source from the Apache HTTPD tarball is a
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster simple matter of uncompressing, and then untarring:</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>This will create a new directory under the current directory
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster containing the source code for the distribution. You should
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <code>cd</code> into that directory before proceeding with
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster compiling the server.</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<h2><a name="configure" id="configure">Configuring the source tree</a></h2>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>The next step is to configure the Apache source tree for your
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster particular platform and personal requirements. This is done using
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster the script <code class="program"><a href="/programs/configure.html">configure</a></code> included in
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster the root directory of the distribution. (Developers downloading
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster an unreleased version of the Apache source tree will need to have
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <code>autoconf</code> and <code>libtool</code> installed and will
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster need to run <code>buildconf</code> before proceeding with the next
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster steps. This is not necessary for official releases.)</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>To configure the source tree using all the default options,
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster simply type <code>/configure</code>. To change the default
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster options, <code class="program"><a href="/programs/configure.html">configure</a></code> accepts a variety of variables
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster and command line options.</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>The most important option is the location <code>--prefix</code>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster where Apache is to be installed later, because Apache has to be
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster configured for this location to work correctly. More fine-tuned
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster control of the location of files is possible with additional <a href="programs/configure.html#installationdirectories">configure
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>Also at this point, you can specify which <a href="programs/configure.html#optionalfeatures">features</a> you
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster want included in Apache by enabling and disabling <a href="mod/">modules</a>. Apache comes with a <a href="mod/module-dict.html#Status">Base</a> set of modules included by
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster default. Other modules are enabled using the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <code>--enable-<var>module</var></code> option, where
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <var>module</var> is the name of the module with the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <code>mod_</code> string removed and with any underscore converted
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster to a dash. You can also choose to compile modules as <a href="dso.html">shared objects (DSOs)</a> -- which can be loaded
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster or unloaded at runtime -- by using the option
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <code>--enable-<var>module</var>=shared</code>. Similarly, you can
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster disable Base modules with the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <code>--disable-<var>module</var></code> option. Be careful when
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster using these options, since <code class="program"><a href="/programs/configure.html">configure</a></code> cannot warn you
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster if the module you specify does not exist; it will simply ignore the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>In addition, it is sometimes necessary to provide the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <code class="program"><a href="/programs/configure.html">configure</a></code> script with extra information about the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster location of your compiler, libraries, or header files. This is
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster done by passing either environment variables or command line
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster options to <code class="program"><a href="/programs/configure.html">configure</a></code>. For more information, see the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <code class="program"><a href="/programs/configure.html">configure</a></code> manual page.</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>For a short impression of what possibilities you have, here
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster is a typical example which compiles Apache for the installation
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster tree <code>/sw/pkg/apache</code> with a particular compiler and flags
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster plus the two additional modules <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> and
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <code class="module"><a href="/mod/mod_speling.html">mod_speling</a></code> for
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster later loading through the DSO mechanism:</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster $ CC="pgcc" CFLAGS="-O2" \<br />
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster --enable-rewrite=shared \<br />
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster --enable-speling=shared
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>When <code class="program"><a href="/programs/configure.html">configure</a></code> is run it will take several minutes to
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster test for the availability of features on your system and build
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Makefiles which will later be used to compile the server.</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>Details on all the different <code class="program"><a href="/programs/configure.html">configure</a></code> options are
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster available on the <code class="program"><a href="/programs/configure.html">configure</a></code> manual page.</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<h2><a name="compile" id="compile">Build</a></h2>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>Now you can build the various parts which form the Apache
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster package by simply running the command:</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<div class="example"><p><code>$ make</code></p></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>Please be patient here, since a base configuration takes
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster several minutes to compile and the time will vary widely
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster depending on your hardware and the number of modules that you
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster have enabled.</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<h2><a name="install" id="install">Install</a></h2>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>Now it's time to install the package under the configured
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster installation <em>PREFIX</em> (see <code>--prefix</code> option
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster above) by running:</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<div class="example"><p><code>$ make install</code></p></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>This step will typically require root privileges, since
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <em>PREFIX</em> is usually a directory with restricted write
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster permissions.</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>If you are upgrading, the installation will not overwrite
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster your configuration files or documents.</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<h2><a name="customize" id="customize">Customize</a></h2>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>Next, you can customize your Apache HTTP server by editing
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster the <a href="configuring.html">configuration files</a> under
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<div class="example"><p><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code></p></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>Have a look at the Apache manual under
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <code><em>PREFIX</em>/docs/manual/</code> or consult <a href="http://httpd.apache.org/docs/trunk/">http://httpd.apache.org/docs/trunk/</a> for the most recent
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster version of this manual and a complete reference of available <a href="mod/directives.html">configuration directives</a>.</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>Now you can <a href="invoking.html">start</a> your Apache
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster HTTP server by immediately running:</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k start</code></p></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>You should then be able to request your first document
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster via the URL <code>http://localhost/</code>. The web page you see is located
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster under the <code class="directive"><a href="/mod/core.html#documentroot">DocumentRoot</a></code>,
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster which will usually be <code><em>PREFIX</em>/htdocs/</code>.
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster Then <a href="stopping.html">stop</a> the server again by
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster running:</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k stop</code></p></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<h2><a name="upgrading" id="upgrading">Upgrading</a></h2>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>The first step in upgrading is to read the release announcement
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster and the file <code>CHANGES</code> in the source distribution to
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster find any changes that may affect your site. When changing between
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster major releases (for example, from 1.3 to 2.0 or from 2.0 to 2.2),
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster there will likely be major differences in the compile-time and
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster run-time configuration that will require manual adjustments. All
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster modules will also need to be upgraded to accomodate changes in the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster module API.</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>Upgrading from one minor version to the next (for example, from
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster 2.2.55 to 2.2.57) is easier. The <code>make install</code>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster process will not overwrite any of your existing documents, log
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster files, or configuration files. In addition, the developers make
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster every effort to avoid incompatible changes in the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <code class="program"><a href="/programs/configure.html">configure</a></code> options, run-time configuration, or the
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster module API between minor versions. In most cases you should be able to
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster use an identical <code class="program"><a href="/programs/configure.html">configure</a></code> command line, an identical
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster configuration file, and all of your modules should continue to
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>To upgrade across minor versions, start by finding the file
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <code>config.nice</code> in the <code>build</code> directory of
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster your installed server or at the root of the source tree for your
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster old install. This will contain the exact
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <code class="program"><a href="/programs/configure.html">configure</a></code> command line that you used to
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster configure the source tree. Then to upgrade from one version to
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster the next, you need only copy the <code>config.nice</code> file to
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster the source tree of the new version, edit it to make any desired
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster changes, and then run:</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster $ make<br />
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster $ make install<br />
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster $ <em>PREFIX</em>/bin/apachectl -k graceful-stop<br />
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <div class="warning">You should always test any new version in your
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster environment before putting it into production. For example, you
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster can install and run the new version along side the old one by
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster different port (by adjusting the <code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code> directive) to test for any
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster incompatibilities before doing the final upgrade.</div>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster <p>You can pass additional arguments to <code>config.nice</code>,
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster which will be appended to your original <code class="program"><a href="/programs/configure.html">configure</a></code>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster options:</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster $ /config.nice --prefix=/home/test/apache --with-port=90
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<p><span>Available Languages: </span><a href="/de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<a href="/en/install.html" title="English"> en </a> |
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<a href="/es/install.html" hreflang="es" rel="alternate" title="Espa�ol"> es </a> |
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<a href="/fr/install.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> |
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<a href="/ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<a href="/ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
a688bcbb4bcff5398fdd29b86f83450257dc0df4Allan Foster<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div>