From fc7ff6fb2c7ab3b84c717fc06a03b5bbeaae1623 Mon Sep 17 00:00:00 2001 From: Graham Leggett Date: Sun, 18 Dec 2011 20:26:48 +0000 Subject: [PATCH] Backport: Document the RPM platform. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1220529 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/index.xml | 1 + docs/manual/platform/index.xml | 22 +++- docs/manual/platform/rpm.xml | 200 +++++++++++++++++++++++++++++++++ 3 files changed, 220 insertions(+), 3 deletions(-) create mode 100644 docs/manual/platform/rpm.xml diff --git a/docs/manual/index.xml b/docs/manual/index.xml index 9df43e9e74..2859e97d09 100644 --- a/docs/manual/index.xml +++ b/docs/manual/index.xml @@ -80,6 +80,7 @@ Documentation Platform Specific Notes Microsoft Windows + RPM-based Systems (Redhat / CentOS / Fedora) Novell NetWare EBCDIC Port diff --git a/docs/manual/platform/index.xml b/docs/manual/platform/index.xml index 9e08f75374..fa4af3eb76 100644 --- a/docs/manual/platform/index.xml +++ b/docs/manual/platform/index.xml @@ -32,7 +32,7 @@
Using Apache
-

This document explains how to install, configure and run Apache 2.0 +

This document explains how to install, configure and run Apache 2.4 under Microsoft Windows.

See: Using Apache with Microsoft Windows

@@ -52,6 +52,22 @@ +
+ + Unix Systems + +
+
RPM Based Systems (Redhat / CentOS / Fedora)
+
+

This document explains how to build, install, and run Apache 2.4 + on systems supporting the RPM packaging format.

+ +

See: Using Apache With RPM Based Systems

+
+
+ +
+
Other Platforms @@ -59,7 +75,7 @@
Novell NetWare
-

This document explains how to install, configure and run Apache 2.0 +

This document explains how to install, configure and run Apache 2.4 under Novell NetWare 5.1 and above.

See: Using Apache With Novell NetWare

@@ -75,7 +91,7 @@ Warning: This document has not been updated to take into account changes made in - the 2.0 version of the Apache HTTP Server. Some of the + the 2.4 version of the Apache HTTP Server. Some of the information may still be relevant, but please use it with care. diff --git a/docs/manual/platform/rpm.xml b/docs/manual/platform/rpm.xml new file mode 100644 index 0000000000..d8c172568a --- /dev/null +++ b/docs/manual/platform/rpm.xml @@ -0,0 +1,200 @@ + + + + + + + + + Platform Specific Notes + + Using Apache With RPM Based Systems (Redhat / CentOS / Fedora) + + + +

This document explains how to build, install, configure and run + Apache 2.4 under Unix systems supporting the RPM packaging format.

+ + + +
+ Creating a Source RPM + +

The Apache httpd source tarball can be converted into an SRPM as + follows:

+ + + rpmbuild -ts httpd-2.4.x.tar.bz2 + + +
+ +
+ Building RPMs + +

RPMs can be built directly from the Apache httpd source tarballs using + the following command:

+ + + rpmbuild -tb httpd-2.4.x.tar.bz2 + + +

If successful, the following RPMs will be created:

+ +
+
httpd-2.4.x-1.i686.rpm
+
The core server and basic module set.
+ +
httpd-debuginfo-2.4.x-1.i686.rpm
+
Debugging symbols for the server and all modules.
+ +
httpd-devel-2.4.x-1.i686.rpm
+
Headers and development files for the server.
+ +
httpd-manual-2.4.x-1.i686.rpm
+
The webserver manual.
+ +
httpd-tools-2.4.x-1.i686.rpm
+
Supporting tools for the webserver.
+ +
mod_authnz_ldap-2.4.x-1.i686.rpm
+
mod_ldap and mod_authnz_ldap, with + corresponding dependency on openldap.
+ +
mod_lua-2.4.x-1.i686.rpm
+
mod_lua module, with + corresponding dependency on lua.
+ +
mod_proxy_html-2.4.x-1.i686.rpm
+
mod_proxy_html module, with + corresponding dependency on libxml2.
+ +
mod_socache_dc-2.4.x-1.i686.rpm
+
mod_socache_dc module, with + corresponding dependency on distcache.
+ +
mod_ssl-2.4.x-1.i686.rpm
+
mod_ssl module, with + corresponding dependency on openssl.
+ +
+ +
+ +
+ Installing the Server + +

The httpd RPM is the only RPM necessary to get a basic + server to run. Install it as follows:

+ + + rpm -U httpd-2.4.x-1.i686.rpm + + +

Self contained modules are included with the server. Modules that + depend on external libraries are provided as separate RPMs to install + if needed.

+ +
+ +
+ Configuring the Default Instance of Apache httpd + +

The default configuration for the server is installed by default + beneath the /etc/httpd directory, with logs written by + default to /var/log/httpd. The environment for the + webserver is set by default within the optional + /etc/sysconfig/httpd file.

+ +

Start the server as follows:

+ + + service httpd restart + + +
+ +
+ Configuring Additional Instances of Apache httpd on the Same Machine + +

It is possible to configure additional instances of the Apache + httpd server running independently alongside each other on the same + machine. These instances can have independent configurations, and + can potentially run as separate users if so configured.

+ +

This was done by making the httpd startup script aware of its own + name. This name is then used to find the environment file for the + server, and in turn, the server root of the server instance.

+ +

To create an additional instance called + httpd-additional, follow these steps:

+ +
    +
  • Create a symbolic link to the startup script for the additional + server: + + + ln -s /etc/rc.d/init.d/httpd /etc/rc.d/init.d/httpd-additional
    + chkconfig --add httpd-additional +     + +
    • + +
  • Create an environment file for the server, using the + /etc/sysconfig/httpd file as a template: + + + # template from httpd
    + cp /etc/sysconfig/httpd /etc/sysconfig/httpd-additional +     + + + # blank template
    + touch /etc/sysconfig/httpd-additional +     + + Edit /etc/sysconfig/httpd-additional and pass the + server root of the new server instance within the + OPTIONS environment variable. + + + OPTIONS="-d /etc/httpd-additional -f conf/httpd-additional.conf" + + +
    • + +
  • Edit the server configuration file + /etc/httpd-additional/conf/httpd-additional.conf to + ensure the correct ports and paths are configured. +
    • + +
  • Start the server as follows: + + + service httpd-additional restart + + +
    • + +
  • Repeat this process as required for each server instance.
    • +
+ +
+ + + -- 2.50.1