2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.de.xsl"?>
4 <!-- English Revision: 280384:354164 (outdated) -->
7 Copyright 2003-2005 The Apache Software Foundation or its licensors,
10 Licensed under the Apache License, Version 2.0 (the "License");
11 you may not use this file except in compliance with the License.
12 You may obtain a copy of the License at
14 http://www.apache.org/licenses/LICENSE-2.0
16 Unless required by applicable law or agreed to in writing, software
17 distributed under the License is distributed on an "AS IS" BASIS,
18 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
19 See the License for the specific language governing permissions and
20 limitations under the License.
23 <modulesynopsis metafile="worker.xml.meta">
25 <description>Multi-Processing-Modul, das einen Hybrid-Webserver mit
26 Multi-Thread und Multi-Prozess-Unterstützung implementiert</description>
28 <sourcefile>worker.c</sourcefile>
29 <identifier>mpm_worker_module</identifier>
32 <p>Dieses Multi-Processing-Modul (MPM) implementiert einen Hybrid-Server
33 mit Multi-Thread und Multi-Prozess-Unterstützung. Durch die Verwendung
34 von Threads für die Bedienung von Anfragen ist er in der Lage,
35 eine große Anzahl von Anfragen mit weniger Systemressourcen als
36 ein Prozess-basierter Server zu bedienen. Er behält jedoch viel von
37 der Stabilität eines Prozess-basierten Servers bei, indem er
38 mehrere Prozesse verfügbar hält, jeden mit etlichen Threads.</p>
40 <p>Die wichtigsten Direktiven zur Steuerung des MPMs sind <directive
41 module="mpm_common">ThreadsPerChild</directive>, welche die Anzahl
42 der Threads beeinflusst, die von jedem Kindprozess verwendet werden, und
43 <directive module="mpm_common">MaxClients</directive>, welche die
44 maximale Gesamtzahl an Threads regelt, die gestartet werden
47 <seealso><a href="../bind.html">Bestimmen der vom Apache verwendeten Adressen
48 und Ports</a></seealso>
50 <section id="how-it-works"><title>Arbeitsweise</title>
51 <p>Ein einzelner Steuerprozess (der Elternprozess) ist für den
52 Start der Kindprozesse verantwortlich. Jeder Kindprozess erstellt eine
53 feste Anzahl von Server-Threads, wie durch die <directive
54 module="mpm_common">ThreadsPerChild</directive>-Direktive
55 angegeben, sowie einen "Listener-Thread", der auf Verbindungen wartet und
56 diese an einen Server-Thread zur Bearbeitung weiterreicht, sobald sie
59 <p>Der Apache versucht immer, einen Vorrat von <dfn>freien</dfn> oder
60 unbeschäftigten Threads zu verwalten, die zur Bedienung
61 hereinkommender Anfragen bereit stehen. Auf diese Weise brauchen
62 Clients nicht auf die Erstellung eines neuen Threads oder Prozesses
63 zu warten, bevor ihre Anfrage bedient werden kann. Die Anzahl der
64 Prozesse, die anfangs gestartet wird, wird mit der Direktive
65 <directive module="mpm_common">StartServers</directive> festgelegt.
66 Dann, während des Betriebes, berechnet der Apache die Gesamtzahl
67 der unbeschäftigten Threads und forkt oder beendet Prozesse, um diese
68 Anzahl innerhalb der durch <directive
69 module="mpm_common">MinSpareThreads</directive> und <directive
70 module="mpm_common">MaxSpareThreads</directive> angegebenen Grenzen
71 zu halten. Da dieser Prozess sehr selbstregulierend ist, ist es nur selten
72 notwendig, die Voreinstellung dieser Direktiven zu ändern. Die
73 maximale Anzahl Clients, die gleichzeitig bedient werden kann (d.h.
74 die maximale Gesamtzahl der Threads in allen Prozessen), wird mit der
75 Direktive <directive module="mpm_common">MaxClients</directive>
76 festgelegt. Die maximale Anzahl der aktiven Kindprozesse ergibt sich aus
77 <directive module="mpm_common">MaxClients</directive> dividiert durch
78 <directive module="mpm_common">ThreadsPerChild</directive>.</p>
80 <p>Zwei Direktiven legen harte Limits für die Anzahl der aktiven
81 Kindprozesse fest und können nur geändert werden, indem der Server
82 komplett gestoppt und dann wieder neu gestartet wird. <directive
83 module="mpm_common">ServerLimit</directive> stellt die obere Grenze für
84 die Anzahl der aktiven Kindprozesse dar und muss größer oder
85 gleich dem Quotienten aus <directive
86 module="mpm_common">MaxClients</directive> und <directive
87 module="mpm_common">ThreadsPerChild</directive> sein. <directive
88 module="mpm_common">ThreadLimit</directive> ist die obere Grenze für
89 die Anzahl der Server-Threads und muss größer oder gleich
90 <directive module="mpm_common">ThreadsPerChild</directive> sein. Sofern für
91 diese Direktiven keine Voreinstellungen verwendet werden, sollten sie vor
92 allen anderen <module>worker</module>-Direktiven platziert werden.</p>
94 <p>Neben den normalen aktiven Kindprozessen gibt es möglicherweise noch
95 zusätzliche Kindprozesse, welche gerade beendet werden, wo allerdings
96 zumindest noch ein Server-Thread eine existierende Verbindung bearbeitet.
97 Obwohl die tatsächlich zu erwartende Anzahl deutlich kleiner ist,
98 können bis zu <directive module="mpm_common">MaxClients</directive>
99 solcher Prozesse auftreten. Dieses Verhalten können Sie vermeiden,
100 indem Sie die Terminierung einzelner Kindprozesse wie folgt abschalten:</p>
103 <li>setzen Sie den Wert von <directive module="mpm_common"
104 >MaxRequestsPerChild</directive> auf Null</li>
106 <li>setzen Sie den Wert von <directive module="mpm_common"
107 >MaxSpareThreads</directive> auf den gleichen Wert wie <directive
108 module="mpm_common">MaxClients</directive></li>
111 <p>Eine typische Konfiguration der Prozess-Thread-Steuerung für
112 das MPM <module>worker</module> könnte wie folgt aussehen:</p>
118 MinSpareThreads 25<br />
119 MaxSpareThreads 75<br />
123 <p>Während der Elternprozess unter Unix normalerweise als
124 <code>root</code> gestartet wird, um sich an Port 80 binden zu können,
125 werden die Kindprozesse und Threads unter einem weniger privilegierten
126 Benutzer gestartet. Die Direktiven <directive
127 module="mpm_common">User</directive> und <directive
128 module="mpm_common">Group</directive> werden dazu verwendet, die
129 Privilegien der Apache-Kindprozesse festzulegen. Die Kindprozesse
130 müssen in der Lage sein, alle Inhalte zu lesen, die sie ausliefern
131 sollen, sollten darüber hinaus jedoch so wenig wie möglich Rechte
132 besitzen. Zusätzlich, solange nicht <program>
133 suexec</program> verwendet wird, legen diese
134 Direktiven auch die Privilegien fest, die von CGI-Skripts
137 <p><directive module="mpm_common">MaxRequestsPerChild</directive>
138 bestimmt, wie häufig der Server Prozesse erneuert, indem er alte
139 beendet und neue startet.</p>
142 <directivesynopsis location="mpm_common"><name>AcceptMutex</name>
144 <directivesynopsis location="mpm_common"><name>CoreDumpDirectory</name>
146 <directivesynopsis location="mpm_common"><name>EnableExceptionHook</name>
148 <directivesynopsis location="mpm_common"><name>Group</name>
150 <directivesynopsis location="mpm_common"><name>PidFile</name>
152 <directivesynopsis location="mpm_common"><name>Listen</name>
154 <directivesynopsis location="mpm_common"><name>ListenBacklog</name>
156 <directivesynopsis location="mpm_common"><name>LockFile</name>
158 <directivesynopsis location="mpm_common"><name>MaxClients</name>
160 <directivesynopsis location="mpm_common"><name>MaxMemFree</name>
162 <directivesynopsis location="mpm_common"><name>MaxRequestsPerChild</name>
164 <directivesynopsis location="mpm_common"><name>MaxSpareThreads</name>
166 <directivesynopsis location="mpm_common"><name>MinSpareThreads</name>
168 <directivesynopsis location="mpm_common"><name>ScoreBoardFile</name>
170 <directivesynopsis location="mpm_common"><name>ReceiveBufferSize</name>
172 <directivesynopsis location="mpm_common"><name>SendBufferSize</name>
174 <directivesynopsis location="mpm_common"><name>ServerLimit</name>
176 <directivesynopsis location="mpm_common"><name>StartServers</name>
178 <directivesynopsis location="mpm_common"><name>ThreadLimit</name>
180 <directivesynopsis location="mpm_common"><name>ThreadsPerChild</name>
182 <directivesynopsis location="mpm_common"><name>ThreadStackSize</name>
184 <directivesynopsis location="mpm_common"><name>User</name>