mpm_netware.html.en revision 5bf90772244e08b493f008381645dd3704417d40
967e5f3c25249c779575864692935627004d3f9eChristian Maeder<html xmlns="http://www.w3.org/TR/xhtml1/strict"><head><!--
967e5f3c25249c779575864692935627004d3f9eChristian Maeder XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
81d182b21020b815887e9057959228546cf61b6bChristian Maeder This file is generated from xml source: DO NOT EDIT
f11f713bebd8e1e623a0a4361065df256033de47Christian Maeder XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
97018cf5fa25b494adffd7e9b4e87320dae6bf47Christian Maeder --><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
967e5f3c25249c779575864692935627004d3f9eChristian Maeder 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 Identifier:</a></td><td>mpm_netware_module</td></tr></table></td></tr></table><h2>Summary</h2>
3f69b6948966979163bdfe8331c38833d5d90ecdChristian Maeder <p>This Multi-Processing Module (MPM) implements an exclusively threaded web server
967e5f3c25249c779575864692935627004d3f9eChristian Maeder that has been optimized for Novell NetWare.</p>
f3a94a197960e548ecd6520bb768cb0d547457bbChristian Maeder <p>The main thread is responsible for launching child
717686b54b9650402e2ebfbaadf433eab8ba5171Christian Maeder worker threads which listen for connections and serve them when they
717686b54b9650402e2ebfbaadf433eab8ba5171Christian Maeder arrive. Apache always tries to maintain several <em>spare</em>
967e5f3c25249c779575864692935627004d3f9eChristian Maeder or idle worker threads, which stand ready to serve incoming
967e5f3c25249c779575864692935627004d3f9eChristian Maeder requests. In this way, clients do not need to wait for a new
967e5f3c25249c779575864692935627004d3f9eChristian Maeder child threads to be spawned before their requests can be
fd896e2068ad7e50aed66ac18c3720ea7ff2619fChristian Maeder <p>The <code>StartThreads</code>, <code>MinSpareThreads</code>,
650bafe7709533bc5f82bb9daf8fa06f431cd963Christian Maeder <code>MaxSpareThreads</code>, and <code>MaxThreads</code>
9cb4aa4ea6685489a38f9b609f5dbe5d37f25bc7Christian Maeder regulate how the main thread creates worker threads to serve
7221c71b38c871ce66eee4537cb681d468308dfbChristian Maeder requests. In general, Apache is very self-regulating, so most
ac19f8695aa1b2d2d1cd1319da2530edd8f46a96Christian Maeder sites do not need to adjust these directives from their default
8b9fda012e5ee53b7b2320c0638896a0ff6e99f3Christian Maeder values. Sites which need to serve more than 250 simultaneous
e1839fb37a3a2ccd457464cb0dcc5efd466dbe22Christian Maeder requests may need to increase <code>MaxThreads</code>, while
4ef2a978e66e2246ff0b7f00c77deb7aabb28b8eChristian Maeder sites with limited memory may need to decrease
fd896e2068ad7e50aed66ac18c3720ea7ff2619fChristian Maeder <code>MaxThreads</code> to keep the server from thrashing (spawning and
967e5f3c25249c779575864692935627004d3f9eChristian Maeder terminating idle threads). More information about
ad187062b0009820118c1b773a232e29b879a2faChristian Maeder tuning process creation is provided in the <a href="/misc/perf-tuning.html">performance hints</a>
ad270004874ce1d0697fb30d7309f180553bb315Christian Maeder documentation.</p>
717686b54b9650402e2ebfbaadf433eab8ba5171Christian Maeder <p><code>MaxRequestsPerChild</code> controls how frequently the
588c0c022a0f4e129a89c3bc569daf6a835e182dChristian Maeder server recycles processes by killing old ones and launching new
717686b54b9650402e2ebfbaadf433eab8ba5171Christian Maeder ones. On the NetWare OS it is highly recommended that this directive
967e5f3c25249c779575864692935627004d3f9eChristian Maeder remain set to 0. This allows worker threads to continue servicing
b66eb6038bfbcd2fe520d87c151bb4f1f510e985Christian Maeder requests indefinitely.</p>
b66eb6038bfbcd2fe520d87c151bb4f1f510e985Christian Maeder <p>See also: <a href="/bind.html">Setting which addresses and
b66eb6038bfbcd2fe520d87c151bb4f1f510e985Christian Maeder<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 nowrap="nowrap"><strong>Description: </strong></td><td/></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>MaxSpareThreads <em>number</em></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>MaxSpareThreads 100</code></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:</a></td><td>MPM</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mpm_netware</td></tr></table></td></tr></table>
b66eb6038bfbcd2fe520d87c151bb4f1f510e985Christian Maeder <p>The <code class="directive">MaxSpareThreads</code> directive sets the
7a879b08ae0ca30006f9be887a73212b07f10204Christian Maeder desired maximum number of <em>idle</em> worker threads. An idle
b66eb6038bfbcd2fe520d87c151bb4f1f510e985Christian Maeder worker thread is one which is not handling a request. If there are
b66eb6038bfbcd2fe520d87c151bb4f1f510e985Christian Maeder more than MaxSpareThreads idle, then the main thread will kill off
b66eb6038bfbcd2fe520d87c151bb4f1f510e985Christian Maeder the excess worker threads.</p>
a89389521ddf76109168a0b339031575aafbd512Christian Maeder <p>Tuning of this parameter should only be necessary on very
a89389521ddf76109168a0b339031575aafbd512Christian Maeder busy sites. Setting this parameter to a large number is almost
a89389521ddf76109168a0b339031575aafbd512Christian Maeder always a bad idea.</p>
a89389521ddf76109168a0b339031575aafbd512Christian Maeder<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 nowrap="nowrap"><strong>Description: </strong></td><td/></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>MaxThreads <em>number</em></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>MaxThreads 250</code></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:</a></td><td>MPM</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mpm_netware</td></tr></table></td></tr></table>
a89389521ddf76109168a0b339031575aafbd512Christian Maeder<p>The MaxThreads directive sets the desired maximum
a89389521ddf76109168a0b339031575aafbd512Christian Maeder number worker threads allowable.</p>
a89389521ddf76109168a0b339031575aafbd512Christian Maeder<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 nowrap="nowrap"><strong>Description: </strong></td><td/></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>MinSpareThreads <em>number</em></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>MinSpareThreads 10</code></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:</a></td><td>MPM</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mpm_netware</td></tr></table></td></tr></table>
a89389521ddf76109168a0b339031575aafbd512Christian Maeder<p>The <code class="directive">MinSpareThreads</code> directive sets the
a89389521ddf76109168a0b339031575aafbd512Christian Maederdesired minimum number of <em>idle</em> worker threads. An idle worker
a89389521ddf76109168a0b339031575aafbd512Christian Maederthread is one which is not handling a request. If there are fewer than
a89389521ddf76109168a0b339031575aafbd512Christian MaederMinSpareThreads idle, then the main thread spawns new worker.</p>
a89389521ddf76109168a0b339031575aafbd512Christian Maeder <p>Tuning of this parameter should only be necessary on very
a89389521ddf76109168a0b339031575aafbd512Christian Maeder busy sites. Setting this parameter to a large number is almost
f454c20b6c126bea7d31d400cc8824b9ee8cc6eaChristian Maeder always a bad idea.</p>
b66eb6038bfbcd2fe520d87c151bb4f1f510e985Christian Maeder<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 nowrap="nowrap"><strong>Description: </strong></td><td/></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>StartThreads <em>number</em></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>StartThreads 50</code></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:</a></td><td>MPM</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mpm_netware</td></tr></table></td></tr></table>
6e39bfd041946fce4982ac89834be73fd1bfb39aChristian Maeder<p>The StartThreads directive sets the desired
e1839fb37a3a2ccd457464cb0dcc5efd466dbe22Christian Maeder number of worker threads to spawn and startup</p>
b66eb6038bfbcd2fe520d87c151bb4f1f510e985Christian Maeder<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 nowrap="nowrap"><strong>Description: </strong></td><td/></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Syntax" class="help">Syntax:</a></td><td>ThreadStackSize <em>number</em></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Default" class="help">Default:</a></td><td><code>ThreadStackSize 65536</code></td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Context" class="help">Context:</a></td><td>server config</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Status" class="help">Status:</a></td><td>MPM</td></tr><tr><td nowrap="nowrap"><a href="directive-dict.html#Module" class="help">Module:</a></td><td>mpm_netware</td></tr></table></td></tr></table>
b66eb6038bfbcd2fe520d87c151bb4f1f510e985Christian Maeder <p>This directive tells the server what stack size to use for
b66eb6038bfbcd2fe520d87c151bb4f1f510e985Christian Maeder each of the running threads. If you ever get a stack overflow
5e26bfc8d7b18cf3a3fa7b919b4450fb669f37a5Christian Maeder you will need to bump this number to a higher setting.</p>
588c0c022a0f4e129a89c3bc569daf6a835e182dChristian Maeder<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>
