<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <html> <head> <link rel="STYLESHEET" href="modpython.css" type='text/css' /> <link rel="first" href="modpython.html" title='Mod_python Manual' /> <link rel='contents' href='contents.html' title="Contents" /> <link rel='index' href='genindex.html' title='Index' /> <link rel='last' href='about.html' title='About this document...' /> <link rel='help' href='about.html' title='About this document...' /> <link rel="prev" href="inst-makeinstall.html" /> <link rel="parent" href="inst-installing.html" /> <link rel="next" href="inst-testing.html" /> <meta name='aesop' content='information' /> <title>2.3.2 Configuring Apache</title> </head> <body> <DIV CLASS="navigation"> <div id='top-navigation-panel' xml:id='top-navigation-panel'> <table align="center" width="100%" cellpadding="0" cellspacing="2"> <tr> <td class='online-navigation'><a rel="prev" title="2.3.1 Running make install" href="inst-makeinstall.html"><img src='previous.png' border='0' height='32' alt='Previous Page' width='32' /></A></td> <td class='online-navigation'><a rel="parent" title="2.3 Installing" href="inst-installing.html"><img src='up.png' border='0' height='32' alt='Up One Level' width='32' /></A></td> <td class='online-navigation'><a rel="next" title="2.4 Testing" href="inst-testing.html"><img src='next.png' border='0' height='32' alt='Next Page' width='32' /></A></td> <td align="center" width="100%">Mod_python Manual</td> <td class='online-navigation'><a rel="contents" title="Table of Contents" href="contents.html"><img src='contents.png' border='0' height='32' alt='Contents' width='32' /></A></td> <td class='online-navigation'><img src='blank.png' border='0' height='32' alt='' width='32' /></td> <td class='online-navigation'><a rel="index" title="Index" href="genindex.html"><img src='index.png' border='0' height='32' alt='Index' width='32' /></A></td> </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> <a class="sectref" rel="prev" href="inst-makeinstall.html">2.3.1 Running make install</A> <b class="navlabel">Up:</b> <a class="sectref" rel="parent" href="inst-installing.html">2.3 Installing</A> <b class="navlabel">Next:</b> <a class="sectref" rel="next" href="inst-testing.html">2.4 Testing</A> </div> <hr /></div> </DIV> <!--End of Navigation Panel--> <H2><A NAME="SECTION004320000000000000000"></A><A NAME="inst-apacheconfig"></A> <BR> 2.3.2 Configuring Apache </H2> <P> <DL> <DT></DT> <DD><strong>LoadModule</strong> <a id='l2h-19' xml:id='l2h-19'></a> <P> If you compiled mod_python as a DSO, you will need to tell Apache to load the module by adding the following line in the Apache configuration file, usually called <span class="file">httpd.conf</span> or <span class="file">apache.conf</span>: <P> <div class="verbatim"><pre> LoadModule python_module libexec/mod_python.so </pre></div> <P> <a id='l2h-22' xml:id='l2h-22'></a> The actual path to <b class="program">mod_python.so</b> may vary, but make install should report at the very end exactly where <b class="program">mod_python.so</b> was placed and how the <code>LoadModule</code> directive should appear. <P> </DD> <DT></DT> <DD><strong>Mutex Directory</strong> <a id='l2h-20' xml:id='l2h-20'></a> <P> The default directory for mutex lock files is <span class="file">/tmp</span>. The default value can be be specified at compile time using <em class="citetitle"><a href="inst-configure.html" title="./configure --with-mutex-dir" >./configure --with-mutex-dir</a></em>. <P> Alternatively this value can be overriden at apache startup using a <em class="citetitle"><a href="dir-other-po.html" title="PythonOption" >PythonOption</a></em>. <P> <div class="verbatim"><pre> PythonOption mod_python.mutex_directory "/tmp" </pre></div> <P> This may only be used in the server configuration context. It will be ignored if used in a directory, virtual host, htaccess or location context. The most logical place for this directive in your apache configuration file is immediately following the <strong>LoadModule</strong> directive. <P> <em>New in version 3.3.0</em> <P> </DD> <DT></DT> <DD><strong>Mutex Locks</strong> <a id='l2h-21' xml:id='l2h-21'></a> <P> Mutexes are used in mod_python for session locking. The default value is 8. <P> On some systems the locking mechanism chosen uses valuable system resources. Notably on RH 8 sysv ipc is used, which by default provides only 128 semaphores system-wide. On many other systems flock is used which may result in a relatively large number of open files. <P> The optimal number of necessary locks is not clear. Increasing the maximum number of locks may increase performance when using session locking. A reasonable number for higher performance might be 32. <P> The maximum number of locks can be specified at compile time using <em class="citetitle"><a href="inst-configure.html" title="./configure --with-max-locks" >./configure --with-max-locks</a></em>. <P> Alternatively this value can be overriden at apache startup using a <em class="citetitle"><a href="dir-other-po.html" title="PythonOption" >PythonOption</a></em>. <P> <div class="verbatim"><pre> PythonOption mod_python.mutex_locks 8 </pre></div> <P> This may only be used in the server configuration context. It will be ignored if used in a directory, virtual host, htaccess or location context. The most logical place for this directive in your apache configuration file is immediately following the <strong>LoadModule</strong> directive. <P> <em>New in version 3.3.0</em> <P> </DD> </DL> <P> <DIV CLASS="navigation"> <div class='online-navigation'> <p></p><hr /> <table align="center" width="100%" cellpadding="0" cellspacing="2"> <tr> <td class='online-navigation'><a rel="prev" title="2.3.1 Running make install" href="inst-makeinstall.html"><img src='previous.png' border='0' height='32' alt='Previous Page' width='32' /></A></td> <td class='online-navigation'><a rel="parent" title="2.3 Installing" href="inst-installing.html"><img src='up.png' border='0' height='32' alt='Up One Level' width='32' /></A></td> <td class='online-navigation'><a rel="next" title="2.4 Testing" href="inst-testing.html"><img src='next.png' border='0' height='32' alt='Next Page' width='32' /></A></td> <td align="center" width="100%">Mod_python Manual</td> <td class='online-navigation'><a rel="contents" title="Table of Contents" href="contents.html"><img src='contents.png' border='0' height='32' alt='Contents' width='32' /></A></td> <td class='online-navigation'><img src='blank.png' border='0' height='32' alt='' width='32' /></td> <td class='online-navigation'><a rel="index" title="Index" href="genindex.html"><img src='index.png' border='0' height='32' alt='Index' width='32' /></A></td> </tr></table> <div class='online-navigation'> <b class="navlabel">Previous:</b> <a class="sectref" rel="prev" href="inst-makeinstall.html">2.3.1 Running make install</A> <b class="navlabel">Up:</b> <a class="sectref" rel="parent" href="inst-installing.html">2.3 Installing</A> <b class="navlabel">Next:</b> <a class="sectref" rel="next" href="inst-testing.html">2.4 Testing</A> </div> </div> <hr /> <span class="release-info">Release 3.3.1, documentation updated on January 29, 2007.</span> </DIV> <!--End of Navigation Panel--> </BODY> </HTML>