Moved apache code into a folder to help prepare for packaging where we dont want...
[httpd-crcsyncproxy.git] / apache / docs / manual / mod / worker.xml.de
blob70c546665989c5f9f484aa94b56a24c002cd9b5c
1 <?xml version="1.0"?>
2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.de.xsl"?>
4 <!-- English Revision: 280384:713242 (outdated) -->
6 <!--
7 Licensed to the Apache Software Foundation (ASF) under one or more
8 contributor license agreements. See the NOTICE file distributed with
9 this work for additional information regarding copyright ownership.
10 The ASF licenses this file to You under the Apache License, Version 2.0
11 (the "License"); you may not use this file except in compliance with
12 the License. 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.
21 -->
23 <modulesynopsis metafile="worker.xml.meta">
24 <name>worker</name>
25 <description>Multi-Processing-Modul, das einen Hybrid-Webserver mit
26 Multi-Thread und Multi-Prozess-Unterst&uuml;tzung implementiert</description>
27 <status>MPM</status>
28 <sourcefile>worker.c</sourcefile>
29 <identifier>mpm_worker_module</identifier>
31 <summary>
32 <p>Dieses Multi-Processing-Modul (MPM) implementiert einen Hybrid-Server
33 mit Multi-Thread und Multi-Prozess-Unterst&uuml;tzung. Durch die Verwendung
34 von Threads f&uuml;r die Bedienung von Anfragen ist er in der Lage,
35 eine gro&szlig;e Anzahl von Anfragen mit weniger Systemressourcen als
36 ein Prozess-basierter Server zu bedienen. Er beh&auml;lt jedoch viel von
37 der Stabilit&auml;t eines Prozess-basierten Servers bei, indem er
38 mehrere Prozesse verf&uuml;gbar h&auml;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
45 k&ouml;nnen.</p>
46 </summary>
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&uuml;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
57 eintreffen.</p>
59 <p>Der Apache versucht immer, einen Vorrat von <dfn>freien</dfn> oder
60 unbesch&auml;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&auml;hrend des Betriebes, berechnet der Apache die Gesamtzahl
67 der unbesch&auml;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 &auml;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&uuml;r die Anzahl der aktiven
81 Kindprozesse fest und k&ouml;nnen nur ge&auml;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&uuml;r
84 die Anzahl der aktiven Kindprozesse dar und muss gr&ouml;&szlig;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&uuml;r
89 die Anzahl der Server-Threads und muss gr&ouml;&szlig;er oder gleich
90 <directive module="mpm_common">ThreadsPerChild</directive> sein. Sofern f&uuml;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&ouml;glicherweise noch
95 zus&auml;tzliche Kindprozesse, welche gerade beendet werden, wo allerdings
96 zumindest noch ein Server-Thread eine existierende Verbindung bearbeitet.
97 Obwohl die tats&auml;chlich zu erwartende Anzahl deutlich kleiner ist,
98 k&ouml;nnen bis zu <directive module="mpm_common">MaxClients</directive>
99 solcher Prozesse auftreten. Dieses Verhalten k&ouml;nnen Sie vermeiden,
100 indem Sie die Terminierung einzelner Kindprozesse wie folgt abschalten:</p>
102 <ul>
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>
109 </ul>
111 <p>Eine typische Konfiguration der Prozess-Thread-Steuerung f&uuml;r
112 das MPM <module>worker</module> k&ouml;nnte wie folgt aussehen:</p>
114 <example>
115 ServerLimit 16<br />
116 StartServers 2<br />
117 MaxClients 150<br />
118 MinSpareThreads 25<br />
119 MaxSpareThreads 75<br />
120 ThreadsPerChild 25
121 </example>
123 <p>W&auml;hrend der Elternprozess unter Unix normalerweise als
124 <code>root</code> gestartet wird, um sich an Port 80 binden zu k&ouml;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&uuml;ssen in der Lage sein, alle Inhalte zu lesen, die sie ausliefern
131 sollen, sollten dar&uuml;ber hinaus jedoch so wenig wie m&ouml;glich Rechte
132 besitzen. Zus&auml;tzlich, solange nicht <program>
133 suexec</program> verwendet wird, legen diese
134 Direktiven auch die Privilegien fest, die von CGI-Skripts
135 geerbt werden.</p>
137 <p><directive module="mpm_common">MaxRequestsPerChild</directive>
138 bestimmt, wie h&auml;ufig der Server Prozesse erneuert, indem er alte
139 beendet und neue startet.</p>
140 </section>
142 <directivesynopsis location="mpm_common"><name>AcceptMutex</name>
143 </directivesynopsis>
144 <directivesynopsis location="mpm_common"><name>CoreDumpDirectory</name>
145 </directivesynopsis>
146 <directivesynopsis location="mpm_common"><name>EnableExceptionHook</name>
147 </directivesynopsis>
148 <directivesynopsis location="mpm_common"><name>Group</name>
149 </directivesynopsis>
150 <directivesynopsis location="mpm_common"><name>PidFile</name>
151 </directivesynopsis>
152 <directivesynopsis location="mpm_common"><name>Listen</name>
153 </directivesynopsis>
154 <directivesynopsis location="mpm_common"><name>ListenBacklog</name>
155 </directivesynopsis>
156 <directivesynopsis location="mpm_common"><name>LockFile</name>
157 </directivesynopsis>
158 <directivesynopsis location="mpm_common"><name>MaxClients</name>
159 </directivesynopsis>
160 <directivesynopsis location="mpm_common"><name>MaxMemFree</name>
161 </directivesynopsis>
162 <directivesynopsis location="mpm_common"><name>MaxRequestsPerChild</name>
163 </directivesynopsis>
164 <directivesynopsis location="mpm_common"><name>MaxSpareThreads</name>
165 </directivesynopsis>
166 <directivesynopsis location="mpm_common"><name>MinSpareThreads</name>
167 </directivesynopsis>
168 <directivesynopsis location="mpm_common"><name>ScoreBoardFile</name>
169 </directivesynopsis>
170 <directivesynopsis location="mpm_common"><name>ReceiveBufferSize</name>
171 </directivesynopsis>
172 <directivesynopsis location="mpm_common"><name>SendBufferSize</name>
173 </directivesynopsis>
174 <directivesynopsis location="mpm_common"><name>ServerLimit</name>
175 </directivesynopsis>
176 <directivesynopsis location="mpm_common"><name>StartServers</name>
177 </directivesynopsis>
178 <directivesynopsis location="mpm_common"><name>ThreadLimit</name>
179 </directivesynopsis>
180 <directivesynopsis location="mpm_common"><name>ThreadsPerChild</name>
181 </directivesynopsis>
182 <directivesynopsis location="mpm_common"><name>ThreadStackSize</name>
183 </directivesynopsis>
184 <directivesynopsis location="mpm_common"><name>User</name>
185 </directivesynopsis>
187 </modulesynopsis>