Document the RPM platform.

<category id="platform"><title>Platform Specific Notes</title>

    <page href="platform/windows.html">Microsoft Windows</page>

    <page href="platform/rpm.html">RPM-based Systems (Redhat / CentOS / Fedora)</page>

    <page href="platform/netware.html">Novell NetWare</page>

    <page href="platform/ebcdic.html">EBCDIC Port</page>

</category>

    <dl>

      <dt>Using Apache</dt>

      <dd>

        <p>This document explains how to install, configure and run Apache 2.0

        <p>This document explains how to install, configure and run Apache 2.4

        under Microsoft Windows.</p>

        <p>See: <a href="windows.html">Using Apache with Microsoft Windows</a></p>

  </section>

  <section id="unix">

    <title>Unix Systems</title>

    <dl>

      <dt>RPM Based Systems (Redhat / CentOS / Fedora)</dt>

      <dd>

        <p>This document explains how to build, install, and run Apache 2.4

        on systems supporting the RPM packaging format.</p>

        <p>See: <a href="rpm.html">Using Apache With RPM Based Systems</a></p>

      </dd>

    </dl>

  </section>

  <section id="other">

    <title>Other Platforms</title>

    <dl>

      <dt>Novell NetWare</dt>

      <dd>

        <p>This document explains how to install, configure and run Apache 2.0

        <p>This document explains how to install, configure and run Apache 2.4

        under Novell NetWare 5.1 and above.</p>

        <p>See: <a href="netware.html">Using Apache With Novell NetWare</a></p>

        <note type="warning"><strong>Warning:</strong> 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.</note>

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>

<!-- $LastChangedRevision: 1174747 $ -->

<!--

 Licensed to the Apache Software Foundation (ASF) under one or more

 contributor license agreements.  See the NOTICE file distributed with

 this work for additional information regarding copyright ownership.

 The ASF licenses this file to You under the Apache License, Version 2.0

 (the "License"); you may not use this file except in compliance with

 the License.  You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software

 distributed under the License is distributed on an "AS IS" BASIS,

 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 See the License for the specific language governing permissions and

 limitations under the License.

-->

<manualpage metafile="rpm.xml.meta">

  <parentdocument href="./">Platform Specific Notes</parentdocument>

  <title>Using Apache With RPM Based Systems (Redhat / CentOS / Fedora)</title>

  <summary>

    <p>This document explains how to build, install, configure and run

    Apache 2.4 under Unix systems supporting the RPM packaging format.</p>

  </summary>

  <section id="creating">

    <title>Creating a Source RPM</title>

    <p>The Apache httpd source tarball can be converted into an SRPM as

    follows:</p>

    <example>

      rpmbuild -ts httpd-2.4.x.tar.bz2

    </example>

  </section>

  <section id="building">

    <title>Building RPMs</title>

    <p>RPMs can be built directly from the Apache httpd source tarballs using

    the following command:</p>

    <example>

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

    </example>

    <p>If successful, the following RPMs will be created:</p>

    <dl>

    <dt>httpd-2.4.x-1.i686.rpm</dt>

    <dd>The core server and basic module set.</dd>

    <dt>httpd-debuginfo-2.4.x-1.i686.rpm</dt>

    <dd>Debugging symbols for the server and all modules.</dd>

    <dt>httpd-devel-2.4.x-1.i686.rpm</dt>

    <dd>Headers and development files for the server.</dd>

    <dt>httpd-manual-2.4.x-1.i686.rpm</dt>

    <dd>The webserver manual.</dd>

    <dt>httpd-tools-2.4.x-1.i686.rpm</dt>

    <dd>Supporting tools for the webserver.</dd>

    <dt>mod_authnz_ldap-2.4.x-1.i686.rpm</dt>

    <dd><module>mod_ldap</module> and <module>mod_authnz_ldap</module>, with

    corresponding dependency on openldap.</dd>

    <dt>mod_lua-2.4.x-1.i686.rpm</dt>

    <dd><module>mod_lua</module> module, with

    corresponding dependency on lua.</dd>

    <dt>mod_proxy_html-2.4.x-1.i686.rpm</dt>

    <dd><module>mod_proxy_html</module> module, with

    corresponding dependency on libxml2.</dd>

    <dt>mod_socache_dc-2.4.x-1.i686.rpm</dt>

    <dd><module>mod_socache_dc</module> module, with

    corresponding dependency on distcache.</dd>

    <dt>mod_ssl-2.4.x-1.i686.rpm</dt>

    <dd><module>mod_ssl</module> module, with

    corresponding dependency on openssl.</dd>

    </dl>

  </section>

  <section id="installing">

    <title>Installing the Server</title>

    <p>The <code>httpd</code> RPM is the only RPM necessary to get a basic

    server to run. Install it as follows:</p>

    <example>

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

    </example>

    <p>Self contained modules are included with the server. Modules that

    depend on external libraries are provided as separate RPMs to install

    if needed.</p>

  </section>

  <section id="default">

    <title>Configuring the Default Instance of Apache httpd</title>

    <p>The default configuration for the server is installed by default

    beneath the <code>/etc/httpd</code> directory, with logs written by

    default to <code>/var/log/httpd</code>. The environment for the

    webserver is set by default within the optional

    <code>/etc/sysconfig/httpd</code> file.</p>

    <p>Start the server as follows:</p>

    <example>

      service httpd restart

    </example>

  </section>

  <section id="additional">

    <title>Configuring Additional Instances of Apache httpd on the Same Machine</title>

    <p>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.</p>

    <p>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.</p>

    <p>To create an additional instance called

    <code>httpd-additional</code>, follow these steps:</p>

    <ul>

      <li>Create a symbolic link to the startup script for the additional

      server:

      <example>

        ln -s /etc/rc.d/init.d/httpd /etc/rc.d/init.d/httpd-additional<br />

        chkconfig --add httpd-additional

      </example>

      </li>

      <li>Create an environment file for the server, using the

      <code>/etc/sysconfig/httpd</code> file as a template:

      <example>

        # template from httpd<br />

        cp /etc/sysconfig/httpd /etc/sysconfig/httpd-additional

      </example>

      <example>

        # blank template<br />

        touch /etc/sysconfig/httpd-additional

      </example>

      Edit <code>/etc/sysconfig/httpd-additional</code> and pass the

      server root of the new server instance within the

      <code>OPTIONS</code> environment variable.

      <example>

        OPTIONS="-d /etc/httpd-additional -f conf/httpd-additional.conf"

      </example>

      </li>

      <li>Edit the server configuration file

      <code>/etc/httpd-additional/conf/httpd-additional.conf</code> to

      ensure the correct ports and paths are configured.

      </li>

      <li>Start the server as follows:

      <example>

        service httpd-additional restart

      </example>

      </li>

      <li>Repeat this process as required for each server instance.</li>

    </ul>

  </section>

</manualpage>