granicus.if.org Git - apache/blob - docs/manual/mod/mpm_netware.html.en

   1 <html xmlns="http://www.w3.org/TR/xhtml1/strict"><head><!--
   2           XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   3                 This file is generated from xml source: DO NOT EDIT
   4           XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5         --><title>mpm_netware- Apache HTTP Server</title><link href="../style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module mpm_netware</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td>Multi-Processing Module implementing an exclusively threaded web
   6     server optimized for Novell NetWare</td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>MPM</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module&nbsp;Identifier:</a></td><td>mpm_netware_module</td></tr></table></td></tr></table><h2>Summary</h2>
   7     <p>This Multi-Processing Module (MPM) implements an exclusively threaded web server
   8     that has been optimized for Novell NetWare.</p>
   9
  10     <p>The main thread is responsible for launching child
  11     worker threads which listen for connections and serve them when they
  12     arrive. Apache always tries to maintain several <em>spare</em>
  13     or idle worker threads, which stand ready to serve incoming
  14     requests. In this way, clients do not need to wait for a new
  15     child threads to be spawned before their requests can be
  16     served.</p>
  17
  18     <p>The <code>StartThreads</code>, <code>MinSpareThreads</code>,
  19     <code>MaxSpareThreads</code>, and <code>MaxThreads</code>
  20     regulate how the main thread creates worker threads to serve
  21     requests. In general, Apache is very self-regulating, so most
  22     sites do not need to adjust these directives from their default
  23     values. Sites which need to serve more than 250 simultaneous
  24     requests may need to increase <code>MaxThreads</code>, while
  25     sites with limited memory may need to decrease
  26     <code>MaxThreads</code> to keep the server from thrashing (spawning and
  27     terminating idle threads). More information about
  28     tuning process creation is provided in the <a href="../misc/perf-tuning.html">performance hints</a>
  29     documentation.</p>
  30
  31     <p><code>MaxRequestsPerChild</code> controls how frequently the
  32     server recycles processes by killing old ones and launching new
  33     ones.&nbsp; On the NetWare OS it is highly recommended that this directive
  34     remain set to 0.&nbsp; This allows worker threads to continue servicing
  35     requests indefinitely.</p>
  36
  37     <p>See also: <a href="../bind.html">Setting which addresses and
  38     ports Apache uses</a>.</p>
  39 <h2>Directives</h2><ul><li><a href="mpm_common.html#listen">Listen</a></li><li><a href="mpm_common.html#listenbacklog">ListenBacklog</a></li><li><a href="mpm_common.html#maxrequestsperchild">MaxRequestsPerChild</a></li><li><a href="#maxsparethreads">MaxSpareThreads</a></li><li><a href="#maxthreads">MaxThreads</a></li><li><a href="#minsparethreads">MinSpareThreads</a></li><li><a href="mpm_common.html#sendbuffersize">SendBufferSize</a></li><li><a href="#startthreads">StartThreads</a></li><li><a href="#threadstacksize">ThreadStackSize</a></li></ul><hr/><h2><a name="MaxSpareThreads">MaxSpareThreads</a> <a name="maxsparethreads">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>MaxSpareThreads <em>number</em></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>MaxSpareThreads 100</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>MPM</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mpm_netware</td></tr></table></td></tr></table>
  40     <p>The <code class="directive">MaxSpareThreads</code> directive sets the
  41     desired maximum number of <em>idle</em> worker threads. An idle
  42     worker thread is one which is not handling a request. If there are
  43     more than MaxSpareThreads idle, then the main thread will kill off
  44     the excess worker threads.</p>
  45
  46     <p>Tuning of this parameter should only be necessary on very
  47     busy sites. Setting this parameter to a large number is almost
  48     always a bad idea.</p>
  49 <hr/><h2><a name="MaxThreads">MaxThreads</a> <a name="maxthreads">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>MaxThreads <em>number</em></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>MaxThreads 250</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>MPM</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mpm_netware</td></tr></table></td></tr></table>
  50 <p>The MaxThreads directive sets the desired maximum
  51     number worker threads allowable.</p>
  52 <hr/><h2><a name="MinSpareThreads">MinSpareThreads</a> <a name="minsparethreads">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>MinSpareThreads <em>number</em></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>MinSpareThreads 10</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>MPM</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mpm_netware</td></tr></table></td></tr></table>
  53 <p>The <code class="directive">MinSpareThreads</code> directive sets the
  54 desired minimum number of <em>idle</em> worker threads. An idle worker
  55 thread is one which is not handling a request. If there are fewer than
  56 MinSpareThreads idle, then the main thread spawns new worker.</p>
  57
  58     <p>Tuning of this parameter should only be necessary on very
  59     busy sites. Setting this parameter to a large number is almost
  60     always a bad idea.</p>
  61 <hr/><h2><a name="StartThreads">StartThreads</a> <a name="startthreads">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>StartThreads <em>number</em></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>StartThreads 50</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>MPM</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mpm_netware</td></tr></table></td></tr></table>
  62 <p>The StartThreads directive sets the desired
  63     number of worker threads to spawn and startup</p>
  64 <hr/><h2><a name="ThreadStackSize">ThreadStackSize</a> <a name="threadstacksize">Directive</a></h2><table cellpadding="1" cellspacing="0" border="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td><strong>Description: </strong></td><td/></tr><tr><td><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>ThreadStackSize <em>number</em></td></tr><tr><td><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>ThreadStackSize 65536</code></td></tr><tr><td><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td><a href="directive-dict.html#Status" class="help">Status:</a></td><td>MPM</td></tr><tr><td><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mpm_netware</td></tr></table></td></tr></table>
  65     <p>This directive tells the server what stack size to use for
  66     each of the running threads. If you ever get a stack overflow
  67     you will need to bump this number to a higher setting.</p>
  68 <hr/></blockquote><h3 align="center">Apache HTTP Server Version 2.0</h3><a href="./"><img src="../images/index.gif" alt="Index"/></a><a href="../"><img src="../images/home.gif" alt="Home"/></a></body></html>