granicus.if.org Git - apache/blob - docs/manual/install.html.en

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       --><title>Compiling and Installing - Apache HTTP Server</title><link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /><link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /><link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link href="./images/favicon.ico" rel="shortcut icon" /></head><body id="manual-page"><div id="page-header"><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><p class="apache">Apache HTTP Server Version 2.0</p><img alt="" src="./images/feather.gif" /></div><div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div><div id="path"><a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs-project/">Documentation</a> &gt; <a href="./">Version 2.0</a></div><div id="page-content"><div id="preamble"><h1>Compiling and Installing</h1>
   8
   9     <p>This document covers compilation and installation of Apache
  10     on Unix and Unix-like systems only. For compiling and
  11     installation on Windows, see <a href="platform/windows.html">Using Apache with Microsoft
  12     Windows</a>. For other platforms, see the <a href="platform/">platform</a> documentation.</p>
  13
  14     <p>Apache 2.0's configuration and installation environment has
  15     changed completely from Apache 1.3. Apache 1.3 used a custom
  16     set of scripts to achieve easy installation. Apache 2.0 now
  17     uses <code>libtool</code> and <code>autoconf</code>
  18     to create an environment that looks like many other Open Source
  19     projects.</p>
  20
  21 </div><div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Overview for the
  22     impatient</a></li><li><img alt="" src="./images/down.gif" /> <a href="#requirements">Requirements</a></li><li><img alt="" src="./images/down.gif" /> <a href="#download">Download</a></li><li><img alt="" src="./images/down.gif" /> <a href="#extract">Extract</a></li><li><img alt="" src="./images/down.gif" /> <a href="#configure">Configuring the source tree</a></li><li><img alt="" src="./images/down.gif" /> <a href="#compile">Build</a></li><li><img alt="" src="./images/down.gif" /> <a href="#install">Install</a></li><li><img alt="" src="./images/down.gif" /> <a href="#customize">Customize</a></li><li><img alt="" src="./images/down.gif" /> <a href="#test">Test</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div><div class="section"><h2><a name="overview" id="overview">Overview for the
  23     impatient</a></h2>
  24
  25     <table>
  26       <tr>
  27         <td><a href="#download">Download</a></td>
  28
  29         <td><code>$ lynx
  30         http://www.apache.org/dist/httpd/httpd-2_0_<em>NN</em>.tar.gz</code>
  31         </td>
  32       </tr>
  33
  34       <tr>
  35         <td><a href="#extract">Extract</a></td>
  36
  37         <td><code>$ gzip -d httpd-2_0_<em>NN</em>.tar.gz<br />
  38          $ tar xvf httpd-2_0_<em>NN</em>.tar</code> </td>
  39       </tr>
  40
  41       <tr>
  42         <td><a href="#configure">Configure</a></td>
  43
  44         <td><code>$ ./configure --prefix=<em>PREFIX</em></code>
  45         </td>
  46       </tr>
  47
  48       <tr>
  49         <td><a href="#compile">Compile</a></td>
  50
  51         <td><code>$ make</code> </td>
  52       </tr>
  53
  54       <tr>
  55         <td><a href="#install">Install</a></td>
  56
  57         <td><code>$ make install</code> </td>
  58       </tr>
  59
  60       <tr>
  61         <td><a href="#customize">Customize</a></td>
  62
  63         <td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
  64       </tr>
  65
  66       <tr>
  67         <td><a href="#test">Test</a></td>
  68
  69         <td><code>$ <em>PREFIX</em>/bin/apachectl start</code>
  70         </td>
  71       </tr>
  72     </table>
  73
  74     <p><em>NN</em> must be replaced with the current minor version
  75     number, and <em>PREFIX</em> must be replaced with the
  76     filesystem path under which the server should be installed. If
  77     <em>PREFIX</em> is not specified, it defaults to
  78     <code>/usr/local/apache2</code>.</p>
  79
  80     <p>Each section of the compilation and installation process is
  81     described in more detail below, beginning with the requirements
  82     for compiling and installing Apache HTTPD.</p>
  83 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div><div class="section"><h2><a name="requirements" id="requirements">Requirements</a></h2>
  84
  85     <p>The following requirements exist for building Apache:</p>
  86
  87     <dl>
  88       <dt>Disk Space</dt>
  89       <dd>Make sure you have at least 50 MB of temporary free disk
  90       space available. After installation Apache occupies
  91       approximately 10 MB of disk space. The actual disk space
  92       requirements will vary considerably based on your chosen
  93       configuration options and any third-party modules.</dd>
  94
  95       <dt>ANSI-C Compiler and Build System</dt>
  96       <dd>Make sure you have an ANSI-C compiler installed. The <a href="http://www.gnu.org/software/gcc/gcc.html">GNU C
  97       compiler (GCC)</a> from the <a href="http://www.gnu.org/">Free Software Foundation (FSF)</a>
  98       is recommended (version 2.7.2 is fine). If you don't have GCC
  99       then at least make sure your vendor's compiler is ANSI
 100       compliant. In addition, your <code>PATH</code> must contain
 101       basic build tools such as <code>make</code>.</dd>
 102
 103       <dt>Accurate time keeping</dt>
 104       <dd>Elements of the HTTP protocol are expressed as the time of
 105       day. So, it's time to investigate setting some time
 106       synchronization facility on your system. Usually the
 107       <code>ntpdate</code> or <code>xntpd</code> programs are used for
 108       this purpose which are based on the Network Time Protocol (NTP).
 109       See the Usenet newsgroup <a href="news:comp.protocols.time.ntp">comp.protocols.time.ntp</a>
 110       and the <a href="http://www.eecis.udel.edu/~ntp/">NTP
 111       homepage</a> for more details about NTP software and public
 112       time servers.</dd>
 113
 114       <dt><a href="http://www.perl.org/">Perl 5</a>
 115       [OPTIONAL]</dt>
 116       <dd>For some of the support scripts like <a href="programs/apxs.html">apxs</a> or <a href="programs/dbmmanage.html">dbmmanage</a> (which are
 117       written in Perl) the Perl 5 interpreter is required (versions
 118       5.003 or newer are sufficient). If no such interpreter is found by
 119       the `<code>configure</code>' script there is no harm. Of course, you
 120       still can build and install Apache 2.0. Only those support scripts
 121       cannot be used. If you have multiple Perl interpreters
 122       installed (perhaps a Perl 4 from the vendor and a Perl 5 from
 123       your own), then it is recommended to use the <code>--with-perl</code>
 124       option (see below) to make sure the correct one is selected
 125       by <code>./configure</code>.</dd>
 126     </dl>
 127 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div><div class="section"><h2><a name="download" id="download">Download</a></h2>
 128
 129     <p>Apache can be downloaded from the <a href="http://www.apache.org/dist/httpd/">Apache Software
 130     Foundation download site</a> or from a <a href="http://www.apache.org/dyn/closer.cgi/httpd/">nearby
 131     mirror</a>.</p>
 132
 133     <p>Version numbers that end in <code>alpha</code> indicate
 134     early pre-test versions which may or may not work. Version
 135     numbers ending in <code>beta</code> indicate more reliable
 136     releases that still require further testing or bug fixing. If
 137     you wish to download the best available production release of
 138     the Apache HTTP Server, you should choose the latest version
 139     with neither <code>alpha</code> nor <code>beta</code> in its
 140     filename.</p>
 141
 142     <p>After downloading, especially if a mirror site is used, it
 143     is important to verify that you have a complete and unmodified
 144     version of the Apache HTTP Server. This can be accomplished by
 145     testing the downloaded tarball against the PGP signature. This,
 146     in turn, is a two step procedure. First, you must obtain the
 147     <code>KEYS</code> file from the <a href="http://www.apache.org/dist/httpd/">Apache distribution
 148     site</a>. (To assure that the <code>KEYS</code> file itself has
 149     not been modified, it may be a good idea to use a file from a
 150     previous distribution of Apache or import the keys from a
 151     public key server.) The keys are imported into your personal
 152     key ring using one of the following commands (depending on your
 153     pgp version):</p>
 154
 155 <div class="example"><p><code>$ pgp &lt; KEYS</code></p></div>
 156
 157     <p>or </p>
 158
 159 <div class="example"><p><code>$ gpg --import KEYS</code></p></div>
 160
 161     <p>The next step is to test the tarball against the PGP
 162     signature, which should always be obtained from the <a href="http://www.apache.org/dist/httpd/">main Apache
 163     website</a>. The signature file has a filename identical to the
 164     source tarball with the addition of <code>.asc</code>. Then you
 165     can check the distribution with one of the following commands
 166     (again, depending on your pgp version):</p>
 167
 168 <div class="example"><p><code>$ pgp httpd-2_0_<em>NN</em>.tar.gz.asc</code></p></div>
 169
 170     <p>or</p>
 171
 172 <div class="example"><p><code>$ gpg --verify httpd-2_0_<em>NN</em>.tar.gz.asc</code></p></div>
 173
 174     <p>You should receive a message like</p>
 175
 176 <div class="example"><p><code>Good signature from user "Martin Kraemer
 177       &lt;martin@apache.org&gt;".</code></p></div>
 178
 179     <p>Depending on the trust relationships contained in your key
 180     ring, you may also receive a message saying that the
 181     relationship between the key and the signer of the key cannot
 182     be verified. This is not a problem if you trust the
 183     authenticity of the <code>KEYS</code> file.</p>
 184
 185 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div><div class="section"><h2><a name="extract" id="extract">Extract</a></h2>
 186
 187     <p>Extracting the source from the Apache HTTPD tarball is a
 188     simple matter of uncompressing, and then untarring:</p>
 189
 190 <div class="example"><p><code>
 191       $ gzip -d httpd-2_0_<em>NN</em>.tar.gz<br />
 192        $ tar xvf httpd-2_0_<em>NN</em>.tar
 193 </code></p></div>
 194
 195     <p>This will create a new directory under the current directory
 196     containing the source code for the distribution. You should
 197     <code>cd</code> into that directory before proceeding with
 198     compiling the server.</p>
 199 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div><div class="section"><h2><a name="configure" id="configure">Configuring the source tree</a></h2>
 200
 201     <p>The next step is to configure the Apache source tree for
 202     your particular platform and personal requirements. This is
 203     done using the script <code>configure</code> included in the
 204     root directory of the distribution. (Developers downloading the
 205     CVS version of the Apache source tree will need to have
 206     <code>autoconf</code> and <code>libtool</code> installed and
 207     will need to run <code>buildconf</code> before proceeding with
 208     the next steps. This is not necessary for official
 209     releases.)</p>
 210
 211     <p>To configure the source tree using all the default options,
 212     simply type <code>./configure</code>. To change the default
 213     options, <code>configure</code> accepts a variety of variables
 214     and command line options. Environment variables are generally
 215     placed before the <code>./configure</code> command, while other
 216     options are placed after. The most important option here is the
 217     location prefix where Apache is to be installed later, because
 218     Apache has to be configured for this location to work
 219     correctly. But there are a lot of other options available for
 220     your pleasure.</p>
 221
 222     <p>For a short impression of what possibilities you have, here
 223     is a typical example which compiles Apache for the installation
 224     tree <code>/sw/pkg/apache</code> with a particular compiler and flags
 225     plus the two additional modules mod_rewrite and mod_speling for
 226     later loading through the DSO mechanism:</p>
 227
 228 <div class="example"><p><code>
 229       $ CC="pgcc" CFLAGS="-O2" \<br />
 230        ./configure --prefix=/sw/pkg/apache \<br />
 231        --enable-rewrite=shared \<br />
 232        --enable-speling=shared
 233 </code></p></div>
 234
 235     <p>When <code>configure</code> is run it will take several minutes to
 236     test for the availability of features on your system and build
 237     Makefiles which will later be used to compile the server.</p>
 238
 239     <p>The easiest way to find all of the configuration flags for
 240     Apache is to run <code>./configure --help</code>. What follows is a
 241     brief description of most of the arguments and environment
 242     variables.</p>
 243
 244 <h3><a name="environment" id="environment">Environment Variables</a></h3>
 245
 246     <p>The <code>autoconf</code> build process uses several environment
 247     variables to configure the build environment. In general, these
 248     variables change the method used to build Apache, but not the
 249     eventual features of the server. These variables can be placed
 250     in the environment before invoking <code>configure</code>, but
 251     it is usually easier to specify them on the
 252     <code>configure</code> command line as demonstrated in the
 253     example above.</p>
 254
 255     <dl>
 256       <dt><code>CC=...</code></dt>
 257
 258       <dd>The name of the C compiler command.</dd>
 259
 260       <dt><code>CPPFLAGS=...</code></dt>
 261
 262       <dd>Miscellaneous C preprocessor and compiler options.</dd>
 263
 264       <dt><code>CFLAGS=...</code></dt>
 265
 266       <dd>Debugging and optimization options for the C
 267       compiler.</dd>
 268
 269       <dt><code>LDFLAGS=...</code></dt>
 270
 271       <dd>Miscellaneous options to be passed to the linker.</dd>
 272
 273       <dt><code>LIBS=...</code></dt>
 274
 275       <dd>Library location information ("-L" and "-l" options) to
 276       pass to the linker.</dd>
 277
 278       <dt><code>INCLUDES=...</code></dt>
 279
 280       <dd>Header file search directories ("-I<em>dir</em>").</dd>
 281
 282       <dt><code>TARGET=...</code> [Default: apache]</dt>
 283
 284       <dd>Name of the executable which will be built.</dd>
 285
 286       <dt><code>NOTEST_CPPFLAGS=...</code></dt>
 287
 288       <dt><code>NOTEST_CFLAGS=...</code></dt>
 289
 290       <dt><code>NOTEST_LDFLAGS=...</code></dt>
 291
 292       <dt><code>NOTEST_LIBS=...</code></dt>
 293
 294       <dd>These variables share the same function as their
 295       non-<code>NOTEST</code> namesakes. However, the variables are
 296       applied to the build process only after autoconf has performed its
 297       feature testing. This allows the inclusion of flags which
 298       will cause problems during feature testing, but must be used
 299       for the final compilation.</dd>
 300
 301       <dt><code>SHLIB_PATH=...</code></dt>
 302
 303       <dd>Options which specify shared library paths for the
 304       compiler and linker.</dd>
 305     </dl>
 306
 307
 308 <h3><a name="output" id="output">autoconf Output Options</a></h3>
 309
 310     <dl>
 311       <dt><code>--help</code></dt>
 312
 313       <dd>Prints the usage message including all available options,
 314       but does not actually configure anything.</dd>
 315
 316       <dt><code>--quiet</code></dt>
 317
 318       <dd>Prevents the printing of the usual "checking..."
 319       messages.</dd>
 320
 321       <dt><code>--verbose</code></dt>
 322
 323       <dd>Prints much more information during the configuration
 324       process, including the names of all the files examined.</dd>
 325     </dl>
 326
 327
 328 <h3><a name="pathnames" id="pathnames">Pathnames</a></h3>
 329
 330     <p>There are currently two ways to configure the pathnames
 331     under which Apache will install its files. First, you can
 332     specify a directory and have Apache install itself under that
 333     directory in its default locations.</p>
 334
 335     <dl>
 336       <dt><code>--prefix=<em>PREFIX</em></code> [Default:
 337       /usr/local/apache2]</dt>
 338
 339       <dd>Specifies the directory under which the Apache files will
 340       be installed.</dd>
 341     </dl>
 342
 343     <p>It is possible to specify that architecture-dependent files
 344     should be placed under a different directory.</p>
 345
 346     <dl>
 347       <dt><code>--exec-prefix=<em>EPREFIX</em></code> [Default:
 348       <em>PREFIX</em>]</dt>
 349
 350       <dd>Specifies the directory under which
 351       architecture-dependent files will be placed.</dd>
 352     </dl>
 353
 354     <p>The second, and more flexible way to configure the install
 355     path locations for Apache is using the
 356     <code>config.layout</code> file. Using this method, it is
 357     possible to separately specify the location for each type of
 358     file within the Apache installation. The
 359     <code>config.layout</code> file contains several example
 360     configurations, and you can also create your own custom
 361     configuration following the examples. The different layouts in
 362     this file are grouped into <code>&lt;Layout
 363     FOO&gt;...&lt;/Layout&gt;</code> sections and referred to by
 364     name as in <code>FOO</code>.</p>
 365
 366     <dl>
 367       <dt><code>--enable-layout=<em>LAYOUT</em></code></dt>
 368
 369       <dd>Use the named layout in the <code>config.layout</code>
 370       file to specify the installation paths.</dd>
 371     </dl>
 372
 373
 374
 375 <h3><a name="modules" id="modules">Modules</a></h3>
 376
 377     <p>Apache is a modular server. Only the most basic
 378     functionality is included in the core server. Extended features
 379     are available in various modules. During the configuration
 380     process, you must select which modules to compile for use with
 381     your server. You can view a <a href="mod/index.html">list of modules</a> included in
 382     the documentation. Those modules with a <a href="mod/module-dict.html#Status">status</a> of "Base" are
 383     included by default and must be specifically disabled if you do
 384     not want them (e.g. <code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code>). Modules with any
 385     other status must be specifically enabled if you wish to use them
 386     (e.g. <code class="module"><a href="./mod/mod_expires.html">mod_expires</a></code>).</p>
 387
 388     <p>There are two ways for a module to be compiled and used with
 389     Apache. Modules may be <em>statically compiled</em>, which
 390     means that they are permanently included in the Apache binary.
 391     Alternatively, if your operating system supports Dynamic Shared
 392     Objects (DSOs) and <code>autoconf</code> can detect that support, then
 393     modules may be <em>dynamically compiled</em>. DSO modules are
 394     stored separately from the Apache binary, and may be included
 395     or excluded from the server using the run-time configuration
 396     directives provided by <code class="module"><a href="./mod/mod_so.html">mod_so</a></code>.
 397     The mod_so is automatically included in the server if any
 398     dynamic modules are included in the compilation. If you would
 399     like to make your server capable of loading DSOs without
 400     actually compiling any dynamic modules, you can explicitly
 401     <code>--enable-so</code>.</p>
 402
 403     <dl>
 404       <dt><code>--enable-<em>MODULE</em>[=shared]</code></dt>
 405
 406       <dd>Compile and include the module <em>MODULE</em>. The
 407       identifier <em>MODULE</em> is the <a href="mod/module-dict.html#ModuleIdentifier">Module
 408       Identifier</a> from the module documentation without the
 409       "_module" string. To compile the module as a DSO, add the
 410       option <code>=shared</code>.</dd>
 411
 412       <dt><code>--disable-<em>MODULE</em></code></dt>
 413
 414       <dd>Remove the module <em>MODULE</em> which would otherwise
 415       be compiled and included.</dd>
 416
 417       <dt><code>--enable-modules=<em>MODULE-LIST</em></code></dt>
 418
 419       <dd>Compile and include the modules listed in the
 420       space-separated <em>MODULE-LIST</em>.</dd>
 421
 422       <dt>
 423       <code>--enable-mods-shared=<em>MODULE-LIST</em></code></dt>
 424
 425       <dd>Compile and include the modules in the space-separated
 426       <em>MODULE-LIST</em> as dynamically loadable (DSO)
 427       modules.</dd>
 428     </dl>
 429
 430     <p>The <em>MODULE-LIST</em> in the
 431     <code>--enable-modules</code> and
 432     <code>--enable-mods-shared</code> options is usually a
 433     space-separated list of module identifiers. For example, to
 434     enable mod_dav and mod_info, you can either use</p>
 435
 436 <div class="example"><p><code>./configure --enable-dav --enable-info</code></p></div>
 437
 438     <p>or, equivalently,</p>
 439
 440 <div class="example"><p><code>./configure --enable-modules="dav info"</code></p></div>
 441
 442     <p>In addition, the special keywords <code>all</code> or
 443     <code>most</code> can be used to add all or most of the modules
 444     in one step. You can then remove any modules that you do not
 445     want with the <code>--disable-<em>MODULE</em></code> option.
 446     For example, to include all modules as DSOs with the exception
 447     of mod_info, you can use</p>
 448
 449 <div class="example"><p><code>
 450       ./configure --enable-mods-shared=all
 451       --disable-info
 452 </code></p></div>
 453
 454     <p>In addition to the standard set of modules, Apache 2.0 also
 455     includes a choice of <a href="mpm.html">Multi-Processing
 456     Modules</a> (MPMs). One, and only one MPM must be included in
 457     the compilation process. The default MPMs for each platform are
 458     listed on the <a href="mpm.html">MPM documentation page</a>,
 459     but can be overridden on the <code>configure</code> command
 460     line.</p>
 461
 462     <dl>
 463       <dt><code>--with-mpm=<em>NAME</em></code></dt>
 464
 465       <dd>Choose the mpm <em>NAME</em>.</dd>
 466     </dl>
 467
 468
 469 <h3><a name="dbm" id="dbm">DBM</a></h3>
 470
 471     <p>Several Apache features, including
 472     <code class="module"><a href="./mod/mod_auth_dbm.html">mod_auth_dbm</a></code> and <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>'s
 473     DBM <code class="directive"><a href="./mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> use
 474     simple key/value databases for quick lookups of information.  Apache
 475     includes SDBM with its source-code, so this database is always
 476     available.  If you would like to use other database types, the
 477     following <code>configure</code> options are available:</p>
 478
 479 <dl>
 480 <dt><code>--with-gdbm[=<em>path</em>]</code></dt>
 481 <dt><code>--with-ndbm[=<em>path</em>]</code></dt>
 482 <dt><code>--with-berkeley-db[=<em>path</em>]</code></dt>
 483
 484 <dd>If no <em>path</em> is specified, Apache will search for the
 485 include files and libraries in the usual search paths.  An explict
 486 <em>path</em> will cause Apache to look in
 487 <em>path</em><code>/lib</code> and
 488 <em>path</em><code>/include</code> for the relevant files.  Finally,
 489 the <em>path</em> may specify specific include and library paths
 490 seperated by a colon.</dd>
 491 </dl>
 492
 493
 494
 495 <h3><a name="suexec" id="suexec">Suexec</a></h3>
 496
 497     <p>Apache includes a support program called <a href="suexec.html">suexec</a> which can be used to isolate user
 498     CGI programs. However, if suexec is improperly configured, it
 499     can cause serious security problems. Therefore, you should
 500     carefully read and consider the <a href="suexec.html">suexec
 501     documentation</a> before implementing this feature.</p>
 502
 503 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div><div class="section"><h2><a name="compile" id="compile">Build</a></h2>
 504
 505     <p>Now you can build the various parts which form the Apache
 506     package by simply running the command:</p>
 507
 508 <div class="example"><p><code>$ make</code></p></div>
 509
 510     <p>Please be patient here, since a base configuration takes
 511     approximately 3 minutes to compile under a Pentium III/Linux
 512     2.2 system, but this will vary widely depending on your
 513     hardware and the number of modules which you have enabled.</p>
 514 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div><div class="section"><h2><a name="install" id="install">Install</a></h2>
 515
 516     <p>Now its time to install the package under the configured
 517     installation <em>PREFIX</em> (see <code>--prefix</code> option
 518     above) by running:</p>
 519
 520 <div class="example"><p><code>$ make install</code></p></div>
 521
 522     <p>If you are upgrading, the installation will not overwrite
 523     your configuration files or documents.</p>
 524 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div><div class="section"><h2><a name="customize" id="customize">Customize</a></h2>
 525
 526     <p>Next, you can customize your Apache HTTP server by editing
 527     the <a href="configuring.html">configuration files</a> under
 528     <em>PREFIX</em>/conf/.</p>
 529
 530 <div class="example"><p><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code></p></div>
 531
 532     <p>Have a look at the Apache manual under <a href="./">docs/manual/</a> or <a href="http://httpd.apache.org/docs/">http://httpd.apache.org/docs-2.0/</a>
 533     for a complete reference of available <a href="mod/directives.html">configuration directives</a>.</p>
 534 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div><div class="section"><h2><a name="test" id="test">Test</a></h2>
 535
 536     <p>Now you can <a href="invoking.html">start</a> your Apache
 537     HTTP server by immediately running:</p>
 538
 539 <div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl start</code></p></div>
 540
 541     <p>and then you should be able to request your first document
 542     via URL <code>http://localhost/</code>. The web page you see is located
 543     under the <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
 544     which will usually be <code><em>PREFIX</em>/htdocs/</code>.
 545     Then <a href="stopping.html">stop</a> the server again by
 546     running:</p>
 547
 548 <div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl stop</code></p></div>
 549 </div></div><div id="footer"><p class="apache">Maintained by the <a href="http://httpd.apache.org/docs-project/">Apache HTTP Server Documentation Project</a></p><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></body></html>