granicus.if.org Git - apache/blob - docs/manual/platform/rpm.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 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>Using Apache With RPM Based Systems (Redhat / CentOS / Fedora) - Apache HTTP Server Version 2.5</title>
  11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  13 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
  14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body id="manual-page"><div id="page-header">
  19 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
  20 <p class="apache">Apache HTTP Server Version 2.5</p>
  21 <img alt="" src="../images/feather.png" /></div>
  22 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  23 <div id="path">
  24 <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/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Platform Specific Notes</a></div><div id="page-content"><div id="preamble"><h1>Using Apache With RPM Based Systems (Redhat / CentOS / Fedora)</h1>
  25 <div class="toplang">
  26 <p><span>Available Languages: </span><a href="../en/platform/rpm.html" title="English">&nbsp;en&nbsp;</a></p>
  27 </div>
  28
  29
  30     <p>While many distributions make Apache httpd available as operating system
  31     supported packages, it can sometimes be desirable to install and use the
  32     canonical version of Apache httpd on these systems, replacing the natively
  33     provided versions of the packages.</p>
  34
  35     <p>While the Apache httpd project does not currently create binary RPMs
  36     for the various distributions out there, it is easy to build your own
  37     binary RPMs from the canonical Apache httpd tarball.</p>
  38
  39     <p>This document explains how to build, install, configure and run
  40     Apache httpd 2.4 under Unix systems supporting the RPM packaging format.</p>
  41
  42   </div>
  43 <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#creating">Creating a Source RPM</a></li>
  44 <li><img alt="" src="../images/down.gif" /> <a href="#building">Building RPMs</a></li>
  45 <li><img alt="" src="../images/down.gif" /> <a href="#installing">Installing the Server</a></li>
  46 <li><img alt="" src="../images/down.gif" /> <a href="#default">Configuring the Default Instance of Apache httpd</a></li>
  47 <li><img alt="" src="../images/down.gif" /> <a href="#additional">Configuring Additional Instances of Apache httpd on the Same Machine</a></li>
  48 </ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div>
  49 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  50 <div class="section">
  51 <h2><a name="creating" id="creating">Creating a Source RPM</a></h2>
  52
  53
  54     <p>The Apache httpd source tarball can be converted into an SRPM as
  55     follows:</p>
  56
  57     <div class="example"><p><code>
  58       rpmbuild -ts httpd-2.4.x.tar.bz2
  59     </code></p></div>
  60
  61   </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  62 <div class="section">
  63 <h2><a name="building" id="building">Building RPMs</a></h2>
  64
  65
  66     <p>RPMs can be built directly from the Apache httpd source tarballs using
  67     the following command:</p>
  68
  69     <div class="example"><p><code>
  70       rpmbuild -tb httpd-2.4.x.tar.bz2
  71     </code></p></div>
  72
  73     <p>Corresponding "-devel" packages will be required to be installed on your
  74     build system prior to building the RPMs, the <code>rpmbuild</code> command
  75     will automatically calculate what RPMs are required and will list any
  76     dependencies that are missing on your system. These "-devel" packages will
  77     not be required after the build is completed, and can be safely removed.</p>
  78
  79     <p>If successful, the following RPMs will be created:</p>
  80
  81     <dl>
  82     <dt>httpd-2.4.x-1.i686.rpm</dt>
  83     <dd>The core server and basic module set.</dd>
  84
  85     <dt>httpd-debuginfo-2.4.x-1.i686.rpm</dt>
  86     <dd>Debugging symbols for the server and all modules.</dd>
  87
  88     <dt>httpd-devel-2.4.x-1.i686.rpm</dt>
  89     <dd>Headers and development files for the server.</dd>
  90
  91     <dt>httpd-manual-2.4.x-1.i686.rpm</dt>
  92     <dd>The webserver manual.</dd>
  93
  94     <dt>httpd-tools-2.4.x-1.i686.rpm</dt>
  95     <dd>Supporting tools for the webserver.</dd>
  96
  97     <dt>mod_authnz_ldap-2.4.x-1.i686.rpm</dt>
  98     <dd><code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> and <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>, with
  99     corresponding dependency on openldap.</dd>
 100
 101     <dt>mod_lua-2.4.x-1.i686.rpm</dt>
 102     <dd><code class="module"><a href="../mod/mod_lua.html">mod_lua</a></code> module, with
 103     corresponding dependency on lua.</dd>
 104
 105     <dt>mod_proxy_html-2.4.x-1.i686.rpm</dt>
 106     <dd><code class="module"><a href="../mod/mod_proxy_html.html">mod_proxy_html</a></code> module, with
 107     corresponding dependency on libxml2.</dd>
 108
 109     <dt>mod_socache_dc-2.4.x-1.i686.rpm</dt>
 110     <dd><code class="module"><a href="../mod/mod_socache_dc.html">mod_socache_dc</a></code> module, with
 111     corresponding dependency on distcache.</dd>
 112
 113     <dt>mod_ssl-2.4.x-1.i686.rpm</dt>
 114     <dd><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> module, with
 115     corresponding dependency on openssl.</dd>
 116
 117     </dl>
 118
 119   </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 120 <div class="section">
 121 <h2><a name="installing" id="installing">Installing the Server</a></h2>
 122
 123
 124     <p>The <code>httpd</code> RPM is the only RPM necessary to get a basic
 125     server to run. Install it as follows:</p>
 126
 127     <div class="example"><p><code>
 128       rpm -U httpd-2.4.x-1.i686.rpm
 129     </code></p></div>
 130
 131     <p>Self contained modules are included with the server. Modules that
 132     depend on external libraries are provided as separate RPMs to install
 133     if needed.</p>
 134
 135   </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 136 <div class="section">
 137 <h2><a name="default" id="default">Configuring the Default Instance of Apache httpd</a></h2>
 138
 139
 140     <p>The default configuration for the server is installed by default
 141     beneath the <code>/etc/httpd</code> directory, with logs written by
 142     default to <code>/var/log/httpd</code>. The environment for the
 143     webserver is set by default within the optional
 144     <code>/etc/sysconfig/httpd</code> file.</p>
 145
 146     <p>Start the server as follows:</p>
 147
 148     <div class="example"><p><code>
 149       service httpd restart
 150     </code></p></div>
 151
 152   </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 153 <div class="section">
 154 <h2><a name="additional" id="additional">Configuring Additional Instances of Apache httpd on the Same Machine</a></h2>
 155
 156
 157     <p>It is possible to configure additional instances of the Apache
 158     httpd server running independently alongside each other on the same
 159     machine. These instances can have independent configurations, and
 160     can potentially run as separate users if so configured.</p>
 161
 162     <p>This was done by making the httpd startup script aware of its own
 163     name. This name is then used to find the environment file for the
 164     server, and in turn, the server root of the server instance.</p>
 165
 166     <p>To create an additional instance called
 167     <code>httpd-additional</code>, follow these steps:</p>
 168
 169     <ul>
 170       <li>Create a symbolic link to the startup script for the additional
 171       server:
 172
 173       <div class="example"><p><code>
 174         ln -s /etc/rc.d/init.d/httpd /etc/rc.d/init.d/httpd-additional<br />
 175         chkconfig --add httpd-additional
 176       </code></p></div>
 177
 178       </li>
 179
 180       <li>Create an environment file for the server, using the
 181       <code>/etc/sysconfig/httpd</code> file as a template:
 182
 183       <div class="example"><p><code>
 184         # template from httpd<br />
 185         cp /etc/sysconfig/httpd /etc/sysconfig/httpd-additional
 186       </code></p></div>
 187
 188       <div class="example"><p><code>
 189         # blank template<br />
 190         touch /etc/sysconfig/httpd-additional
 191       </code></p></div>
 192
 193       Edit <code>/etc/sysconfig/httpd-additional</code> and pass the
 194       server root of the new server instance within the
 195       <code>OPTIONS</code> environment variable.
 196
 197       <div class="example"><p><code>
 198         OPTIONS="-d /etc/httpd-additional -f conf/httpd-additional.conf"
 199       </code></p></div>
 200
 201       </li>
 202
 203       <li>Edit the server configuration file
 204       <code>/etc/httpd-additional/conf/httpd-additional.conf</code> to
 205       ensure the correct ports and paths are configured.
 206       </li>
 207
 208       <li>Start the server as follows:
 209
 210       <div class="example"><p><code>
 211         service httpd-additional restart
 212       </code></p></div>
 213
 214       </li>
 215
 216       <li>Repeat this process as required for each server instance.</li>
 217     </ul>
 218
 219   </div></div>
 220 <div class="bottomlang">
 221 <p><span>Available Languages: </span><a href="../en/platform/rpm.html" title="English">&nbsp;en&nbsp;</a></p>
 222 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
 223 <script type="text/javascript"><!--//--><![CDATA[//><!--
 224 var comments_shortname = 'httpd';
 225 var comments_identifier = 'http://httpd.apache.org/docs/trunk/platform/rpm.html';
 226 (function(w, d) {
 227     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 228         d.write('<div id="comments_thread"><\/div>');
 229         var s = d.createElement('script');
 230         s.type = 'text/javascript';
 231         s.async = true;
 232         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 233         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 234     }
 235     else {
 236         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 237     }
 238 })(window, document);
 239 //--><!]]></script></div><div id="footer">
 240 <p class="apache">Copyright 2016 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>
 241 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
 242 if (typeof(prettyPrint) !== 'undefined') {
 243     prettyPrint();
 244 }
 245 //--><!]]></script>
 246 </body></html>