mpm_netware.html revision e4e495a06ae06be5a76aaa21b929927a86e2a3de
c28749e97052f09388969427adf7df641cdcdc22kais<html xmlns="http://www.w3.org/TR/xhtml1/strict"><head><!--
c28749e97052f09388969427adf7df641cdcdc22kaisXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
c28749e97052f09388969427adf7df641cdcdc22kais This file is generated from xml source: DO NOT EDIT
c28749e97052f09388969427adf7df641cdcdc22kaisXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
968d6dde54d2efa62910a3cf36438325d0b69031krishna--><title>mpm_netware - Apache HTTP Server</title><link href="/style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img alt="[APACHE DOCUMENTATION]" src="/images/sub.gif"/><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><description>Multi-Processing Module implementing an exclusively threaded web
968d6dde54d2efa62910a3cf36438325d0b69031krishna server optimized for Novell NetWare</description></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><summary>
c28749e97052f09388969427adf7df641cdcdc22kais <p>This Multi-Processing Module (MPM) implements an exclusively threaded web server
c28749e97052f09388969427adf7df641cdcdc22kais that has been optimized for Novell NetWare.</p>
c28749e97052f09388969427adf7df641cdcdc22kais <p>The main thread is responsible for launching child
c28749e97052f09388969427adf7df641cdcdc22kais worker threads which listen for connections and serve them when they
c28749e97052f09388969427adf7df641cdcdc22kais arrive. Apache always tries to maintain several <em>spare</em>
c28749e97052f09388969427adf7df641cdcdc22kais or idle worker threads, which stand ready to serve incoming
c28749e97052f09388969427adf7df641cdcdc22kais requests. In this way, clients do not need to wait for a new
c28749e97052f09388969427adf7df641cdcdc22kais child threads to be spawned before their requests can be
c28749e97052f09388969427adf7df641cdcdc22kais served.</p>
c28749e97052f09388969427adf7df641cdcdc22kais <p>The <code>StartThreads</code>, <code>MinSpareThreads</code>,
c28749e97052f09388969427adf7df641cdcdc22kais <code>MaxSpareThreads</code>, and <code>MaxThreads</code>
c28749e97052f09388969427adf7df641cdcdc22kais regulate how the main thread creates worker threads to serve
c28749e97052f09388969427adf7df641cdcdc22kais requests. In general, Apache is very self-regulating, so most
51144063f3afc862c6cb3f54fd4341724f765075Krishna Yenduri sites do not need to adjust these directives from their default
c28749e97052f09388969427adf7df641cdcdc22kais values. Sites which need to serve more than 250 simultaneous
c28749e97052f09388969427adf7df641cdcdc22kais requests may need to increase <code>MaxThreads</code>, while
c28749e97052f09388969427adf7df641cdcdc22kais sites with limited memory may need to decrease
c28749e97052f09388969427adf7df641cdcdc22kais <code>MaxThreads</code> to keep the server from thrashing (spawning and
c28749e97052f09388969427adf7df641cdcdc22kais terminating idle threads). More information about
c28749e97052f09388969427adf7df641cdcdc22kais tuning process creation is provided in the <a href="/misc/perf-tuning.html">performance hints</a>
c28749e97052f09388969427adf7df641cdcdc22kais documentation.</p>
c28749e97052f09388969427adf7df641cdcdc22kais <p><code>MaxRequestsPerChild</code> controls how frequently the
c28749e97052f09388969427adf7df641cdcdc22kais server recycles processes by killing old ones and launching new
c28749e97052f09388969427adf7df641cdcdc22kais ones. On the NetWare OS it is highly recommended that this directive
c28749e97052f09388969427adf7df641cdcdc22kais remain set to 0. This allows worker threads to continue servicing
c28749e97052f09388969427adf7df641cdcdc22kais requests indefinitely.</p>
c28749e97052f09388969427adf7df641cdcdc22kais <p>See also: <a href="/bind.html">Setting which addresses and
c28749e97052f09388969427adf7df641cdcdc22kais</summary><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><syntax>MaxSpareThreads <em>number</em></syntax></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><usage>
c28749e97052f09388969427adf7df641cdcdc22kais <p>The <code class="directive">MaxSpareThreads</code> directive sets the
c28749e97052f09388969427adf7df641cdcdc22kais desired maximum number of <em>idle</em> worker threads. An idle
c28749e97052f09388969427adf7df641cdcdc22kais worker thread is one which is not handling a request. If there are
c28749e97052f09388969427adf7df641cdcdc22kais more than MaxSpareThreads idle, then the main thread will kill off
c28749e97052f09388969427adf7df641cdcdc22kais the excess worker threads.</p>
c28749e97052f09388969427adf7df641cdcdc22kais <p>Tuning of this parameter should only be necessary on very
c28749e97052f09388969427adf7df641cdcdc22kais busy sites. Setting this parameter to a large number is almost
c28749e97052f09388969427adf7df641cdcdc22kais always a bad idea.</p>
c28749e97052f09388969427adf7df641cdcdc22kais</usage><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><syntax>MaxThreads <em>number</em></syntax></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><usage>
c28749e97052f09388969427adf7df641cdcdc22kais<p>The MaxThreads directive sets the desired maximum
c28749e97052f09388969427adf7df641cdcdc22kais number worker threads allowable.</p>
c28749e97052f09388969427adf7df641cdcdc22kais</usage><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><syntax>MinSpareThreads <em>number</em></syntax></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><usage>
c28749e97052f09388969427adf7df641cdcdc22kais<p>The <code class="directive">MinSpareThreads</code> directive sets the
c28749e97052f09388969427adf7df641cdcdc22kaisdesired minimum number of <em>idle</em> worker threads. An idle worker
c28749e97052f09388969427adf7df641cdcdc22kaisthread is one which is not handling a request. If there are fewer than
c28749e97052f09388969427adf7df641cdcdc22kaisMinSpareThreads idle, then the main thread spawns new worker.</p>
c28749e97052f09388969427adf7df641cdcdc22kais <p>Tuning of this parameter should only be necessary on very
2bd70d4be73561631df9cb3d9eb4c65fa94fa665krishna busy sites. Setting this parameter to a large number is almost
2bd70d4be73561631df9cb3d9eb4c65fa94fa665krishna always a bad idea.</p>
c28749e97052f09388969427adf7df641cdcdc22kais</usage><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><syntax>StartThreads <em>number</em></syntax></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><usage>
2bd70d4be73561631df9cb3d9eb4c65fa94fa665krishna<p>The StartThreads directive sets the desired
2bd70d4be73561631df9cb3d9eb4c65fa94fa665krishna number of worker threads to spawn and startup</p>
c28749e97052f09388969427adf7df641cdcdc22kais</usage><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><syntax>ThreadStackSize <em>number</em></syntax></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><usage>
2bd70d4be73561631df9cb3d9eb4c65fa94fa665krishna <p>This directive tells the server what stack size to use for
2bd70d4be73561631df9cb3d9eb4c65fa94fa665krishna each of the running threads. If you ever get a stack overflow
c28749e97052f09388969427adf7df641cdcdc22kais you will need to bump this number to a higher setting.</p>
