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