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