1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="de" xml:lang="de"><head><!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Beenden und Neustarten - Apache HTTP Server</title>
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p>
<p class="apache">Apache HTTP Server Version 2.2</p>
<img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP-Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a> > <a href="./">Version 2.2</a></div><div id="page-content"><div id="preamble"><h1>Beenden und Neustarten</h1>
<div class="toplang">
<p><span>Verfügbare Sprachen: </span><a href="./de/stopping.html" title="Deutsch"> de </a> |
<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Diese Übersetzung ist möglicherweise
nicht mehr aktuell. Bitte prüfen Sie die englische Version auf
die neuesten Änderungen.</div>
<p>Dieses Dokument umfasst das Beenden und Neustarten des
Apache auf Unix-ähnlichen Systemen. Anwender von Windows NT, 2000
und XP sollten <a href="platform/windows.html#winsvc">Betreiben
des Apache als Dienst</a> lesen, während hingegen Anwender von
Windows 9x sowie ME <a href="platform/windows.html#wincons">Betreiben
des Apache als Konsolenanwendung</a> lesen sollten, um mehr Informationen
zur Handhabung des Apache auf diesen Systemen zu erhalten.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Einleitung</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#term">Beenden</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#graceful">Unterbrechungsfreier Neustart</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#hup">Neustarten</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#gracefulstop">Rücksichtsvolles Beenden</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#race">Anhang: Signale und Wettlaufsituationen</a></li>
</ul><h3>Siehe auch</h3><ul class="seealso"><li><code class="program"><a href="./programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="./programs/apachectl.html">apachectl</a></code></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="introduction" id="introduction">Einleitung</a></h2>
<p>Um den Apache zu stoppen oder neu zu starten, müssen Sie
ein Signal an den laufenden <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Prozess senden. Es gibt
zwei Möglichkeiten, diese Signale zu senden. Zum einen können
Sie den Unix-Befehl <code>kill</code> verwenden, um den Prozessen
direkt Signale zu senden. Sie werden feststellen, dass auf Ihrem
System mehrere <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Programme laufen. Sie sollten
jedoch nicht jedem dieser Prozesse ein Signal senden, sondern nur dem
Elternprozess, dessen PID im <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> steht. Das heißt, Sie
sollten es niemals nötig haben, einem anderen Prozess, als dem
Elternprozess, ein Signal zu senden. Es gibt drei Signale, die Sie an den
Elternprozess senden können: <code><a href="#term">TERM</a></code>,
<code><a href="#hup">HUP</a></code> und
<code><a href="#graceful">USR1</a></code>, die nachfolgend beschrieben
werden.</p>
<p>Um dem Elternprozess ein Signal zu senden, verwenden Sie einen
Befehl wie z.B.:</p>
<div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div>
<p>Die zweite Methode, dem <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Prozess zu
signalisieren, ist die Verwendung der <code>-k</code>-Befehlszeilenoptionen
<code>stop</code>, <code>restart</code>, <code>graceful</code> und
<code>graceful-stop</code>, wie unten beschrieben. Dies sind Argumente des
<code class="program"><a href="./programs/httpd.html">httpd</a></code>-Programms, es wird jedoch empfohlen, sie unter
Verwendung des Steuerskripts <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> zu senden,
welches diese an <code class="program"><a href="./programs/httpd.html">httpd</a></code> durchreicht.</p>
<p>Nachdem Sie <code class="program"><a href="./programs/httpd.html">httpd</a></code> signalisiert haben, können Sie
dessen Fortschritt beobachten, indem Sie eingeben:</p>
<div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div>
<p>Passen Sie diese Beispiele entsprechend Ihren <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code>- und <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>-Einstellungen an.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="term" id="term">Beenden</a></h2>
<dl><dt>Signal: TERM</dt>
<dd><code>apachectl -k stop</code></dd>
</dl>
<p>Das Senden des <code>TERM</code>- oder <code>stop</code>-Signals an
den Elternprozess veranlasst diesen, sofort zu versuchen, alle seine
Kindprozesse zu beenden. Es kann einige Sekunden dauern, bis alle
Kindprozesse komplett beendet sind. Danach beendet sich der Elternprozess
selbst. Alle gerade bearbeiteten Anfragen werden abgebrochen.
Es werden keine weiteren Anfragen mehr bedient.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="graceful" id="graceful">Unterbrechungsfreier Neustart</a></h2>
<dl><dt>Signal: USR1</dt>
<dd><code>apachectl -k graceful</code></dd>
</dl>
<p>Das <code>USR1</code>- oder <code>graceful</code>-Signal
veranlasst den Elternprozess, die Kinder <em>anzuweisen</em>, sich
nach Abschluß ihrer momentanen bearbeiteten Anfrage zu beenden
(oder sich sofort zu beenden, wenn sie gerade keine Anfrage bedienen).
Der Elternprozess liest seine Konfigurationsdateien erneut ein und
öffnet seine Logdateien neu. Wenn ein Kindprozess stirbt,
ersetzt der Elternprozess ihn durch ein Kind der neuen
Konfigurations-<em>Generation</em>. Dieses beginnt sofort damit,
neue Anfragen zu bedienen.</p>
<p>Der Code ist dafür ausgelegt, stets die MPM-Direktiven
zur Prozesssteuerung zu beachten, so dass die Anzahl der Prozesse
und Threads, die zur Bedienung der Clients bereitstehen, während
des Neustarts auf die entsprechenden Werte gesetzt werden.
Weiterhin wird <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code>
auf folgende Art und Weise interpretiert: Wenn nach einer Sekunde
nicht mindestens <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code>
neue Kindprozesse erstellt wurden, dann werden, um den Durchsatz zu
beschleunigen, entsprechend weitere erstellt. Auf diese Weise versucht
der Code sowohl die Anzahl der Kinder entsprechend der Serverlast
anzupassen als auch Ihre Wünsche hinsichtlich des Parameters
<code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> zu
berücksichtigen.</p>
<p>Benutzer von <code class="module"><a href="./mod/mod_status.html">mod_status</a></code> werden feststellen,
dass die Serverstatistiken <strong>nicht</strong> auf Null
zurückgesetzt werden, wenn ein <code>USR1</code> gesendet
wurde. Der Code wurde so geschrieben, dass sowohl die Zeit minimiert
wird, in der der Server nicht in der Lage ist, neue Anfragen zu
bedienen (diese werden vom Betriebssystem in eine Warteschlange
gestellt, so dass sie auf keinen Fall verloren gehen) als auch
Ihre Parameter zur Feinabstimmung berücksichtigt werden.
Um dies zu erreichen, muss die <em>Statustabelle</em> (Scoreboard),
die dazu verwendet wird, alle Kinder über mehrere Generationen
zu verfolgen, erhalten bleiben.</p>
<p>Das Statusmodul benutzt außerdem ein <code>G</code>, um
diejenigen Kinder zu kennzeichen, die noch immer Anfragen bedienen,
welche gestartet wurden, bevor ein unterbrechungsfreier Neustart
veranlaßt wurde.</p>
<p>Derzeit gibt es keine Möglichkeit für ein
Log-Rotationsskript, das <code>USR1</code> verwendet, sicher
festzustellen, dass alle Kinder, die in ein vor dem Neustart
geöffnetes Log schreiben, beendet sind. Wir schlagen vor, dass
Sie nach dem Senden des Signals <code>USR1</code> eine angemessene
Zeitspanne warten, bevor Sie das alte Log anfassen. Wenn beispielsweise
die meisten Ihrer Zugriffe bei Benutzern mit niedriger Bandbreite
weniger als 10 Minuten für eine vollständige Antwort
benötigen, dann könnten Sie 15 Minuten warten, bevor Sie auf
das alte Log zugreifen.</p>
<div class="note">Wenn Ihre Konfigurationsdatei Fehler enthält, während
Sie einen Neustart anweisen, dann wird Ihr Elternprozess nicht neu starten,
sondern sich mit einem Fehler beenden. Im Falle eines unterbrechungsfreien
Neustarts läßt er die Kinder weiterlaufen, wenn er sich beendet.
(Dies sind die Kinder, die sich "sanft beenden", indem sie ihre letzte
Anfrage erledigen.) Das verursacht Probleme, wenn Sie versuchen,
den Server neu zu starten -- er ist nicht in der Lage, sich an die Ports zu
binden, an denen er lauschen soll. Bevor Sie einen Neustart
durchführen, können Sie die Syntax der Konfigurationsdateien
mit dem Befehlszeilenargument <code>-t</code> überprüfen
(siehe auch <code class="program"><a href="./programs/httpd.html">httpd</a></code>). Das garantiert
allerdings nicht, dass der Server korrekt starten wird. Um sowohl die
Syntax als auch die Semantik der Konfigurationsdateien zu prüfen,
können Sie versuchen, <code class="program"><a href="./programs/httpd.html">httpd</a></code> als nicht-root-Benutzer
zu starten. Wenn dabei keine Fehler auftreten, wird er versuchen, seine
Sockets und Logdateien zu öffnen und fehlschlagen, da er nicht root
ist (oder weil sich der gegenwärtig laufende <code class="program"><a href="./programs/httpd.html">httpd</a></code>
bereits diese Ports gebunden hat). Wenn er aus einem anderen Grund
fehlschlägt, dann liegt wahrscheinlich ein Konfigurationsfehler vor.
Der Fehler sollte behoben werden, bevor der unterbrechungsfreie Neustart
angewiesen wird.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="hup" id="hup">Neustarten</a></h2>
<dl><dt>Signal: HUP</dt>
<dd><code>apachectl -k restart</code></dd>
</dl>
<p>Das Senden des Signals <code>HUP</code> oder <code>restart</code>
veranlaßt den Elternprozess, wie bei <code>TERM</code> alle seine
Kinder zu beenden. Der Elternprozess beendet sich jedoch nicht. Er liest
seine Konfigurationsdateien neu ein und öffnet alle Logdateien
erneut. Dann erzeugt er einen neuen Satz Kindprozesse und setzt die
Bedienung von Zugriffen fort.</p>
<p>Benutzer von <code class="module"><a href="./mod/mod_status.html">mod_status</a></code> werden feststellen, dass
die Serverstatistiken auf Null gesetzt werden, wenn ein <code>HUP</code>
gesendet wurde.</p>
<div class="note">Wenn Ihre Konfigurationsdatei einen Fehler enthält,
während Sie einen Neustart anweisen, dann wird Ihr Elternprozess
nicht neu starten, sondern sich mit einem Fehler beenden. Lesen Sie oben,
wie Sie das vermeiden können.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="gracefulstop" id="gracefulstop">Rücksichtsvolles Beenden</a></h2>
<dl>
<dt>Signal: WINCH</dt>
<dd><code>apachectl -k gracefull stop</code></dd>
</dl>
<p>Das <code>WINCH</code>- oder <code>graceful-stop</code>-Signal
veranlasst den Elternprozess, die Kinder <em>anzuweisen</em>, sich nach
Abschluß ihrer momentan bearbeiteten Anfrage zu beenden (oder sich
sofort zu beenden, wenn sie gerade nichts bedienen). Der Elternprozess
entfernt dann sein <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> und
stellt das Lauschen auf allen Ports ein. Er läuft weiter und
beobachtet alle Kindprozesse, die noch Anfragen bearbeiten. Sobald alle
Kindprozesse fertig sind und beendet haben oder die mit <code class="directive"><a href="./mod/mpm_common.html#gracefulshutdowntimeout">GracefulShutdownTimeout</a></code> definierte
Zeitüberschreitung erreicht wurde, beendet sich der Elternprozess
ebenfalls. Jedem verbliebenen Kindprozess wird beim Erreichen der
Zeitüberschreitung das <code>TERM</code>-Signal gesendet, um diesen
zum Beenden zu zwingen.</p>
<p>Ein <code>TERM</code>-Signal beendet den Elternprozess und alle
Kindprozesse unverzüglich, wenn sie sich im "graceful"-Status
<span class="transnote">(<em>Anm.d.Ü.:</em> wörtl. "gnädiger" Status)</span> befinden. Da jedoch das
<code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>dann schon gelöscht
ist, werden Sie dieses Signal nicht mehr mit <code>apachectl</code> oder
<code>httpd</code> senden können.</p>
<div class="note"><p>Das Signal <code>graceful-stop</code> ermöglicht Ihnen den
Betrieb mehrerer identisch konfigurierter Instanzen von <code>httpd</code>
zur gleichen Zeit. Dies ist eine mächtige Funktionalität bei der
Aufrüstung des Apache. Sie kann jedoch bei einigen Konfigurationen
auch zur gegenseitigen Blockierung und zu Wettlaufsituationen
führen.</p>
<p>Es ist besonders darauf zu achten, dass auf Festplatte gespeicherte
Dateien wie <code class="directive"><a href="./mod/core.html#lockfile">Lockfile</a></code> und <code class="directive"><a href="./mod/mod_cgid.html#scriptsock">ScriptSock</a></code> die Server-PID enthalten und ohne
Probleme nebeneinander existieren müssen. Wann auch immer eine
Konfigurationsanweisung, ein Drittanbieter-Modul oder ein persistentes
CGI-Skript irgend eine Sperre oder eine Statusdatei auf Festplatte
speichert, muss besonders darauf geachtet werden, dass mehrere
gleichzeitig laufende Instanzen von <code>httpd</code> sich nicht
gegenseitig die Dateien zerstören.</p>
<p>Sie sollten ebenfalls vorsichtig mit möglichen Wettlaufsituationen
sein, wie beispielsweise der Verwendung von weitergeleiteter
Protokollierung nach der Art von <code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code>. Mehrere
gleichzeitig laufende Instanzen von <code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code>, die
versuchen, die gleichen Protokolldateien zu rotieren, können sich
gegenseitig die Protokolldateien zerstören.</p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="race" id="race">Anhang: Signale und Wettlaufsituationen</a></h2>
<p>Vor der Version 1.2b9 des Apache existierten verschiedene
<em>Wettlaufsituationen</em> <span class="transnote">(<em>Anm.d.Ü.:</em> engl.: race
conditions)</span>, die den Neustart und die Signale beeinflußt
haben (einfach gesagt, eine Wettlaufstituation ist ein zeitabhängiges
Problem - wenn etwas zum falschen Zeitpunkt oder in der falschen
Reihenfolge geschieht, kommt es zu nicht erwünschten Ergebnissen.
Geschehen die gleichen Dinge zur rechten Zeit, ist alles in Ordnung). Bei
Architekturen mit dem "richtigen" <span class="transnote">(<em>Anm.d.Ü.:</em> im Sinne von
"geeignet")</span> Funktionsumfang haben wir so viele eliminiert wie
wir nur konnten. Dennoch sollte beachtet werden, dass noch immer
Wettlaufsituationen auf bestimmten Architekturen existieren.</p>
<p>Bei Architekturen, die ein <code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code> auf Platte verwenden,
kann die Statustabelle beschädigt werden.
Das kann zu "bind: Address already in use" ("bind: Adresse wird
bereits verwendet", nach einem <code>HUP</code>) oder "long lost
child came home!" ("Der verlorene Sohn ist heimgekehrt", nach einem
<code>USR1</code>) führen. Ersteres ist ein schwerer Fehler,
wärend letzteres lediglich bewirkt, dass der Server einen Eintrag
in der Statustabelle verliert. So kann es ratsam sein, unterbrechungsfreie
Neustarts zusammen mit einem gelegentlichen harten Neustart zu verwenden.
Diese Probleme lassen sich nur sehr schwer umgehen, aber
glücklicherweise benötigen die meisten Architekturen keine
Statustabelle in Form einer Datei. Bitte lesen Sie für Architekturen,
die sie benötigen, die Dokumentation zu <code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code>.</p>
<p>Alle Architekturen haben in jedem Kindprozess eine kleine
Wettlaufsituation, welche die zweite und nachfolgende Anfragen
einer persistenten HTTP-Verbindung (KeepAlive) umfaßt. Der Prozess
kann nach dem Lesen der Anfragezeile aber vor dem Lesen der Anfrage-Header
enden. Es existiert eine Korrektur, die für 1.2 zu spät kam.
Theoretisch sollte das kein Problem darstellen, da
der KeepAlive-Client derartige Ereignisse aufgrund von
Netzwerk-Latenzzeiten und Auszeiten des Servers erwarten sollte.
In der Praxis scheint keiner von beiden beeinflußt zu werden
-- in einem Testfall wurde der Server zwanzig mal
pro Sekunde neu gestartet, während Clients das Angebot abgegrast
haben, ohne kaputte Bilder oder leere Dokumente zu erhalten.</p>
</div></div>
<div class="bottomlang">
<p><span>Verfügbare Sprachen: </span><a href="./de/stopping.html" title="Deutsch"> de </a> |
<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2011 The Apache Software Foundation.<br />Lizenziert unter der <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p></div>
</body></html>
|
