1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="de" xml:lang="de"><head><!--
4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5 This file is generated from xml source: DO NOT EDIT
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
8 <title>Beenden und Neustarten - Apache HTTP Server</title>
9 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
12 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
13 <body id="manual-page"><div id="page-header">
14 <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>
15 <p class="apache">Apache HTTP Server Version 2.0</p>
16 <img alt="" src="./images/feather.gif" /></div>
17 <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
19 <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.0</a></div><div id="page-content"><div id="preamble"><h1>Beenden und Neustarten</h1>
21 <p><span>Verfügbare Sprachen: </span><a href="./de/stopping.html" title="Deutsch"> de </a> |
22 <a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
23 <a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
24 <a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
25 <a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
26 <a href="./ru/stopping.html" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
27 <a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
29 <div class="outofdate">Diese Übersetzung ist möglicherweise
30 nicht mehr aktuell. Bitte prüfen Sie die englische Version auf
31 die neuesten Änderungen.</div>
33 <p>Dieses Dokument umfasst das Beenden und Neustarten des
34 Apache auf Unix-ähnlichen Systemen. Anwender von Windows NT, 2000
35 und XP sollten <a href="platform/windows.html#winsvc">Betreiben
36 des Apache als Dienst</a> lesen, während hingegen Anwender von
37 Windows 9x sowie ME <a href="platform/windows.html#wincons">Betreiben
38 des Apache als Konsolenanwendung</a> lesen sollten, um mehr Informationen
39 zur Handhabung des Apache auf diesen Systemen zu erhalten.</p>
41 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Einleitung</a></li>
42 <li><img alt="" src="./images/down.gif" /> <a href="#term">Beenden</a></li>
43 <li><img alt="" src="./images/down.gif" /> <a href="#graceful">Unterbrechungsfreier Neustart</a></li>
44 <li><img alt="" src="./images/down.gif" /> <a href="#hup">Neustarten</a></li>
45 <li><img alt="" src="./images/down.gif" /> <a href="#race">Anhang: Signale und Wettkampfsituationen</a></li>
46 </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>
47 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
49 <h2><a name="introduction" id="introduction">Einleitung</a></h2>
51 <p>Um den Apache zu stoppen oder neu zu starten, müssen Sie
52 ein Signal an den laufenden <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Prozess senden. Es gibt
53 zwei Möglichkeiten, diese Signale zu senden. Zum einen können
54 Sie den Unix-Befehl <code>kill</code> verwenden, um den Prozessen
55 direkt Signale zu senden. Sie werden feststellen, dass auf Ihrem
56 System mehrere <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Programme laufen. Sie sollten
57 jedoch nicht jedem dieser Prozesse ein Signal senden, sondern nur dem
58 Elternprozess, dessen PID im <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> steht. Das heißt, Sie
59 sollten es niemals nötig haben, einem anderen Prozess, als dem
60 Elternprozess, ein Signal zu senden. Es gibt drei Signale, die Sie an den
61 Elternprozess senden können: <code><a href="#term">TERM</a></code>,
62 <code><a href="#hup">HUP</a></code> und
63 <code><a href="#graceful">USR1</a></code>, die nachfolgend beschrieben
66 <p>Um dem Elternprozess ein Signal zu senden, verwenden Sie einen
69 <div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div>
71 <p>Die zweite Methode, dem <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Prozess zu
72 signalisieren, ist die Verwendung der <code>-k</code>-Befehlszeilenoptionen
73 <code>stop</code>, <code>restart</code> und <code>graceful</code>, wie
74 unten beschrieben. Dies sind Argumente des <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Programms, es wird jedoch
75 empfohlen, sie unter Verwendung des Steuerskripts <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> zu senden, welches diese
76 an <code class="program"><a href="./programs/httpd.html">httpd</a></code> durchreicht.</p>
78 <p>Nachdem Sie <code class="program"><a href="./programs/httpd.html">httpd</a></code> signalisiert haben, können Sie
79 dessen Fortschritt beobachten, indem Sie eingeben:</p>
81 <div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div>
83 <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>
84 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
86 <h2><a name="term" id="term">Beenden</a></h2>
88 <dl><dt>Signal: TERM</dt>
89 <dd><code>apachectl -k stop</code></dd>
92 <p>Das Senden des <code>TERM</code>- oder <code>stop</code>-Signals an
93 den Elternprozess veranlasst diesen, sofort zu versuchen, alle seine
94 Kindprozesse zu beenden. Es kann einige Sekunden dauern, bis alle
95 Kindprozesse komplett beendet sind. Danach beendet sich der Elternprozess
96 selbst. Alle gerade bearbeiteten Anfragen werden abgebrochen.
97 Es werden keine weiteren Anfragen mehr bedient.</p>
98 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
100 <h2><a name="graceful" id="graceful">Unterbrechungsfreier Neustart</a></h2>
102 <dl><dt>Signal: USR1</dt>
103 <dd><code>apachectl -k graceful</code></dd>
106 <p>Das <code>USR1</code>- oder <code>graceful</code>-Signal
107 veranlasst den Elternprozess, die Kinder <em>anzuweisen</em>, sich
108 nach Abschluß ihrer momentanen bearbeiteten Anfrage zu beenden
109 (oder sich sofort zu beenden, wenn sie gerade keine Anfrage bedienen).
110 Der Elternprozess liest seine Konfigurationsdateien erneut ein und
111 öffnet seine Logdateien neu. Wenn ein Kindprozess stirbt,
112 ersetzt der Elternprozess ihn durch ein Kind der neuen
113 Konfigurations-<em>Generation</em>. Dieses beginnt sofort damit,
114 neue Anfragen zu bedienen.</p>
116 <div class="note">Auf bestimmten Plattformen, welche kein <code>USR1</code>
117 für einen unterbrechungsfreien Neustart erlauben, kann ein
118 alternatives Signal verwendet werden (wie z.B.
119 <code>WINCH</code>). Der Befehl <code>apachectl graceful</code>
120 sendet das jeweils richtige Signal für Ihre Platform.</div>
122 <p>Der Code ist dafür ausgelegt, stets die MPM-Direktiven
123 zur Prozesssteuerung zu beachten, so dass die Anzahl der Prozesse
124 und Threads, die zur Bedienung der Clients bereitstehen, während
125 des Neustarts auf die entsprechenden Werte gesetzt werden.
126 Weiterhin wird <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code>
127 auf folgende Art und Weise interpretiert: Wenn nach einer Sekunde
128 nicht mindestens <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code>
129 neue Kindprozesse erstellt wurden, dann werden, um den Durchsatz zu
130 beschleunigen, entsprechend weitere erstellt. Auf diese Weise versucht
131 der Code sowohl die Anzahl der Kinder entsprechend der Serverlast
132 anzupassen als auch Ihre Wünsche hinsichtlich des Parameters
133 <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> zu
136 <p>Benutzer von <code class="module"><a href="./mod/mod_status.html">mod_status</a></code> werden feststellen,
137 dass die Serverstatistiken <strong>nicht</strong> auf Null
138 zurückgesetzt werden, wenn ein <code>USR1</code> gesendet
139 wurde. Der Code wurde so geschrieben, dass sowohl die Zeit minimiert
140 wird, in der der Server nicht in der Lage ist, neue Anfragen zu
141 bedienen (diese werden vom Betriebssystem in eine Warteschlange
142 gestellt, so dass sie auf keinen Fall verloren gehen) als auch
143 Ihre Parameter zur Feinabstimmung berücksichtigt werden.
144 Um dies zu erreichen, muss die <em>Statustabelle</em> (Scoreboard),
145 die dazu verwendet wird, alle Kinder über mehrere Generationen
146 zu verfolgen, erhalten bleiben.</p>
148 <p>Das Statusmodul benutzt außerdem ein <code>G</code>, um
149 diejenigen Kinder zu kennzeichen, die noch immer Anfragen bedienen,
150 welche gestartet wurden, bevor ein unterbrechungsfreier Neustart
153 <p>Derzeit gibt es keine Möglichkeit für ein
154 Log-Rotationsskript, das <code>USR1</code> verwendet, sicher
155 festzustellen, dass alle Kinder, die in ein vor dem Neustart
156 geöffnetes Log schreiben, beendet sind. Wir schlagen vor, dass
157 Sie nach dem Senden des Signals <code>USR1</code> eine angemessene
158 Zeitspanne warten, bevor Sie das alte Log anfassen. Wenn beispielsweise
159 die meisten Ihrer Zugriffe bei Benutzern mit niedriger Bandbreite
160 weniger als 10 Minuten für eine vollständige Antwort
161 benötigen, dann könnten Sie 15 Minuten warten, bevor Sie auf
162 das alte Log zugreifen.</p>
164 <div class="note">Wenn Ihre Konfigurationsdatei Fehler enthält, während
165 Sie einen Neustart anweisen, dann wird Ihr Elternprozess nicht neu starten,
166 sondern sich mit einem Fehler beenden. Im Falle eines unterbrechungsfreien
167 Neustarts läßt er die Kinder weiterlaufen, wenn er sich beendet.
168 (Dies sind die Kinder, die sich "sanft beenden", indem sie ihre letzte
169 Anfrage erledigen.) Das verursacht Probleme, wenn Sie versuchen,
170 den Server neu zu starten -- er ist nicht in der Lage, sich an die Ports zu
171 binden, an denen er lauschen soll. Bevor Sie einen Neustart
172 durchführen, können Sie die Syntax der Konfigurationsdateien
173 mit dem Befehlszeilenargument <code>-t</code> überprüfen
174 (siehe auch <code class="program"><a href="./programs/httpd.html">httpd</a></code>). Das garantiert
175 allerdings nicht, dass der Server korrekt starten wird. Um sowohl die
176 Syntax als auch die Semantik der Konfigurationsdateien zu prüfen,
177 können Sie versuchen, <code class="program"><a href="./programs/httpd.html">httpd</a></code> als nicht-root-Benutzer
178 zu starten. Wenn dabei keine Fehler auftreten, wird er versuchen, seine
179 Sockets und Logdateien zu öffnen und fehlschlagen, da er nicht root
180 ist (oder weil sich der gegenwärtig laufende <code class="program"><a href="./programs/httpd.html">httpd</a></code>
181 bereits diese Ports gebunden hat). Wenn er aus einem anderen Grund
182 fehlschlägt, dann liegt wahrscheinlich ein Konfigurationsfehler vor.
183 Der Fehler sollte behoben werden, bevor der unterbrechungsfreie Neustart
184 angewiesen wird.</div>
185 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
186 <div class="section">
187 <h2><a name="hup" id="hup">Neustarten</a></h2>
189 <dl><dt>Signal: HUP</dt>
190 <dd><code>apachectl -k restart</code></dd>
193 <p>Das Senden des Signals <code>HUP</code> oder <code>restart</code>
194 veranlaßt den Elternprozess, wie bei <code>TERM</code> alle seine
195 Kinder zu beenden. Der Elternprozess beendet sich jedoch nicht. Er liest
196 seine Konfigurationsdateien neu ein und öffnet alle Logdateien
197 erneut. Dann erzeugt er einen neuen Satz Kindprozesse und setzt die
198 Bedienung von Zugriffen fort.</p>
200 <p>Benutzer von <code class="module"><a href="./mod/mod_status.html">mod_status</a></code> werden feststellen, dass
201 die Serverstatistiken auf Null gesetzt werden, wenn ein <code>HUP</code>
204 <div class="note">Wenn Ihre Konfigurationsdatei einen Fehler enthält,
205 während Sie einen Neustart anweisen, dann wird Ihr Elternprozess
206 nicht neu starten, sondern sich mit einem Fehler beenden. Lesen Sie oben,
207 wie Sie das vermeiden können.</div>
208 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
209 <div class="section">
210 <h2><a name="race" id="race">Anhang: Signale und Wettkampfsituationen</a></h2>
212 <p>Vor der Version 1.2b9 des Apache existierten verschiedene
213 <em>Wettkampfsituationen</em> (race conditions), die den Neustart und
214 die Signale beeinflußt haben. (Einfach erklärt ist eine
215 Wettkampfsituation ein zeitabhängiges Problem - wenn
216 etwas zum falschen Zeitpunkt erfolgt oder Dinge in der falschen
217 Reihenfolge passieren, ist unerwartetes Verhalten die Folge. Wenn die
218 gleichen Dinge zur richtigen Zeit geschehen, funktioniert alles korrekt.)
219 Bei Architekturen mit dem "richtigen" Funktionsumfang
220 haben wir so viele eliminiert wie wir nur konnten. Dennoch
221 sollte beachtet werden, dass noch immer Wettkampfsituationen auf
222 bestimmten Architekturen existieren.</p>
224 <p>Bei Architekturen, die ein <code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code> auf Platte verwenden,
225 besteht die Gefahr, dass die Statustabelle beschädigt wird.
226 Das kann zu "bind: Address already in use" ("bind: Adresse wird
227 bereits verwendet", nach einem <code>HUP</code>) oder "long lost
228 child came home!" ("Der verlorene Sohn ist heimgekehrt", nach einem
229 <code>USR1</code>) führen. Ersteres ist ein schwerer Fehler,
230 wärend letzteres lediglich bewirkt, dass der Server einen Eintrag
231 in der Statustabelle verliert. So kann es ratsam sein, unterbrechungsfreie
232 Neustarts zusammen mit einem gelegentlichen harten Neustart zu verwenden.
233 Diese Probleme lassen sich nur sehr schwer umgehen, aber
234 glücklicherweise benötigen die meisten Architekturen keine
235 Statustabelle in Form einer Datei. Bitte lesen Sie für Architekturen,
236 die sie benötigen, die Dokumentation zu <code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code>.</p>
238 <p>Alle Architekturen haben in jedem Kindprozess eine kleine
239 Wettkampfsituation, welche die zweite und nachfolgende Anfragen
240 einer persistenten HTTP-Verbindung (KeepAlive) umfaßt. Der Prozess
241 kann nach dem Lesen der Anfragezeile aber vor dem Lesen der Anfrage-Header
242 enden. Es existiert eine Korrektur, die für 1.2 zu spät kam.
243 Theoretisch sollte das kein Problem darstellen, da
244 der KeepAlive-Client derartige Ereignisse aufgrund von
245 Netzwerk-Latenzzeiten und Auszeiten des Servers erwarten sollte.
246 In der Praxis scheint keiner von beiden beeinflußt zu werden
247 -- in einem Testfall wurde der Server zwanzig mal
248 pro Sekunde neu gestartet, während Clients das Angebot abgegrast
249 haben, ohne kaputte Bilder oder leere Dokumente zu erhalten.</p>
251 <div class="bottomlang">
252 <p><span>Verfügbare Sprachen: </span><a href="./de/stopping.html" title="Deutsch"> de </a> |
253 <a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
254 <a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
255 <a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
256 <a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
257 <a href="./ru/stopping.html" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
258 <a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
259 </div><div id="footer">
260 <p class="apache">Copyright 2009 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>
261 <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>
Code Review / bottlenecks.git / blob