From: Astrid Malo Date: Sun, 19 Feb 2006 16:36:37 +0000 (+0000) Subject: Name the Apache HTTP Server properly by using its official name X-Git-Tag: 2.2.1~88 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=89578b3b29047e9e2e377e5ca04f7bb4052fcbd2;p=thirdparty%2Fapache%2Fhttpd.git Name the Apache HTTP Server properly by using its official name 'Apache HTTP Server' or 'Apache HTTPd' (short form of Apache HTTP daemon) or using the program name 'httpd'. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x@378921 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/install.xml b/docs/manual/install.xml index 84ef8518351..6809cb6161e 100644 --- a/docs/manual/install.xml +++ b/docs/manual/install.xml @@ -26,14 +26,14 @@ -

This document covers compilation and installation of Apache - on Unix and Unix-like systems only. For compiling and +

This document covers compilation and installation of the Apache HTTP + Server on Unix and Unix-like systems only. For compiling and installation on Windows, see Using Apache with Microsoft + href="platform/windows.html">Using Apache HTTPd with Microsoft Windows. For other platforms, see the platform documentation.

-

Apache httpd uses libtool and autoconf +

Apache HTTPd uses libtool and autoconf to create a build environment that looks like many other Open Source projects.

@@ -44,7 +44,7 @@ Configure the source tree -Starting Apache +Starting the Apache HTTP Server Stopping and Restarting
Overview for the @@ -108,12 +108,12 @@ <p>Each section of the compilation and installation process is described in more detail below, beginning with the requirements - for compiling and installing Apache httpd.</p> + for compiling and installing Apache HTTP Server.</p> </section> <section id="requirements"><title>Requirements -

The following requirements exist for building Apache:

+

The following requirements exist for building Apache HTTPd:

Disk Space
@@ -156,11 +156,11 @@ If no Perl 5 interpreter is found by the configure script, you will not be able to use the affected support scripts. Of course, you will still be able to - build and use Apache httpd. + build and use Apache HTTPd.
apr/apr-util >= 1.2
apr and apr-util are bundled - with the Apache httpd source releases, and will be used without any + with the Apache HTTPd source releases, and will be used without any problems in almost all circumstances. However, if apr or apr-util, versions 1.0 or 1.1, are installed on your system, you must either upgrade your @@ -168,23 +168,25 @@ 1.2, or have httpd use seperate builds. To use the bundled apr/apr-util sources for this purpose you must install them manually: - -# Build and install apr 1.2
-cd srclib/apr
-./configure --prefix=/usr/local/apr-httpd/
-make
-make install
-
-# Build and install apr-util 1.2
-cd ../apr-util
-./configure --prefix=/usr/local/apr-util-httpd/ --with-apr=/usr/local/apr-httpd/
-make
-make install
-
-# Configure httpd
-cd ../../
-./configure --with-apr=/usr/local/apr-httpd/ --with-apr-util=/usr/local/apr-util-httpd/
- + + # Build and install apr 1.2
+ cd srclib/apr
+ ./configure --prefix=/usr/local/apr-httpd/
+ make
+ make install
+
+ # Build and install apr-util 1.2
+ cd ../apr-util
+ ./configure --prefix=/usr/local/apr-util-httpd/ + --with-apr=/usr/local/apr-httpd/
+ make
+ make install
+
+ # Configure httpd
+ cd ../../
+ ./configure --with-apr=/usr/local/apr-httpd/ + --with-apr-util=/usr/local/apr-util-httpd/ +
@@ -194,7 +196,7 @@ cd ../../

The Apache HTTP Server can be downloaded from the Apache HTTP Server download site, which lists several mirrors. Most users of - Apache on unix-like systems will be better off downloading and + Apache HTTPd on unix-like systems will be better off downloading and compiling a source version. The build process (described below) is easy, and it allows you to customize your server to suit your needs. In addition, binary releases are often not up to date with the latest @@ -214,13 +216,13 @@ cd ../../

Extract -

Extracting the source from the Apache HTTPD tarball is a +

Extracting the source from the Apache HTTPd tarball is a simple matter of uncompressing, and then untarring:

- -$ gzip -d httpd-NN.tar.gz
-$ tar xvf httpd-NN.tar - + + $ gzip -d httpd-NN.tar.gz
+ $ tar xvf httpd-NN.tar +

This will create a new directory under the current directory containing the source code for the distribution. You should @@ -230,11 +232,11 @@ $ tar xvf httpd-NN.tar

Configuring the source tree -

The next step is to configure the Apache source tree for your +

The next step is to configure the Apache HTTPd source tree for your particular platform and personal requirements. This is done using the script configure included in the root directory of the distribution. (Developers downloading - an unreleased version of the Apache source tree will need to have + an unreleased version of the Apache HTTPd source tree will need to have autoconf and libtool installed and will need to run buildconf before proceeding with the next steps. This is not necessary for official releases.)

@@ -245,7 +247,8 @@ $ tar xvf httpd-NN.tar and command line options.

The most important option is the location --prefix - where Apache is to be installed later, because Apache has to be + where the Apache HTTP Server is to be installed later, because Apache + HTTPd has to be configured for this location to work correctly. More fine-tuned control of the location of files is possible with additional configure @@ -253,8 +256,8 @@ $ tar xvf httpd-NN.tar

Also at this point, you can specify which features you - want included in Apache by enabling and disabling modules. Apache comes with a modules. The Apache HTTP Server comes with a Base set of modules included by default. Other modules are enabled using the --enable-module option, where @@ -284,12 +287,12 @@ $ tar xvf httpd-NN.tar mod_speling for later loading through the DSO mechanism:

- + $ CC="pgcc" CFLAGS="-O2" \
./configure --prefix=/sw/pkg/apache \
--enable-rewrite=shared \
--enable-speling=shared - +

When configure is run it will take several minutes to test for the availability of features on your system and build @@ -301,7 +304,7 @@ $ tar xvf httpd-NN.tar

Build -

Now you can build the various parts which form the Apache +

Now you can build the various parts which form the Apache HTTPd package by simply running the command:

$ make @@ -326,13 +329,13 @@ $ tar xvf httpd-NN.tar
Customize -

Next, you can customize your Apache HTTP server by editing +

Next, you can customize your Apache HTTP Server by editing the configuration files under PREFIX/conf/.

$ vi PREFIX/conf/httpd.conf -

Have a look at the Apache manual under Have a look at the Apache HTTP Server manual under docs/manual/ or consult http://httpd.apache.org/docs/&httpd.docs;/ for the most recent @@ -343,7 +346,7 @@ $ tar xvf httpd-NN.tar

Test

Now you can start your Apache - HTTP server by immediately running:

+ HTTP Server by immediately running:

$ PREFIX/bin/apachectl -k start @@ -354,7 +357,7 @@ $ tar xvf httpd-NN.tar Then stop the server again by running:

-$ PREFIX/bin/apachectl -k stop + $ PREFIX/bin/apachectl -k stop
Upgrading