stopping.xml.de revision a9bd7a08fb2fb0f5ce6cc841667aec2abe9272d1
6ae232055d4d8a97267517c5e50074c2c819941and<?xml-stylesheet type="text/xsl" href="/style/manual.de.xsl"?>
6ae232055d4d8a97267517c5e50074c2c819941and<!-- English revision: 1.9 -->
6ae232055d4d8a97267517c5e50074c2c819941and <p>Dieses Dokument umfasst das Beenden und Neustarten des
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen Apache auf Unix-ähnlichen Systemen. Anwender von Windows NT, 2000
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen und XP sollten <a href="platform/windows.html#winsvc">Betreiben
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen des Apache als Dienst</a> lesen, während hingegen Anwender von
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen Windows 9x sowie ME <a href="platform/windows.html#wincons">Betreiben
6ae232055d4d8a97267517c5e50074c2c819941and des Apache als Konsolenanwendung</a> lesen sollten, um mehr Informationen
6ae232055d4d8a97267517c5e50074c2c819941and zur Handhabung des Apache auf diesen Systemen zu erhalten.</p>
6ae232055d4d8a97267517c5e50074c2c819941and<seealso><a href="programs/httpd.html">httpd</a></seealso>
6ae232055d4d8a97267517c5e50074c2c819941and<seealso><a href="programs/apachectl.html">apachectl</a></seealso>
b43f840409794ed298e8634f6284741f193b6c4ftakashi <p>Um den Apache zu stoppen oder neu zu starten, müssen Sie
c04f76acce77126cf88b09350e56ea8c6b4a064enilgun ein Signal an den laufenden <code>httpd</code>-Prozess senden. Es gibt
6ae232055d4d8a97267517c5e50074c2c819941and zwei Möglichkeiten, diese Signale zu senden. Zum einen können
91f378b5a10f2d83820902ed10ba7967a3920c18nilgun Sie den Unix-Befehl <code>kill</code> verwenden, um den Prozessen
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung direkt Signale zu senden. Sie werden feststellen, dass auf Ihrem
6ae232055d4d8a97267517c5e50074c2c819941and System mehrere <code>httpd</code>-Programme laufen. Sie sollten jedoch
b43f840409794ed298e8634f6284741f193b6c4ftakashi nicht jedem dieser Prozesse ein Signal senden, sondern nur dem
b43f840409794ed298e8634f6284741f193b6c4ftakashi Elternprozess, dessen PID im <directive
b43f840409794ed298e8634f6284741f193b6c4ftakashi module="mpm_common">PidFile</directive> steht. Das heißt, Sie
b43f840409794ed298e8634f6284741f193b6c4ftakashi sollten es niemals nötig haben, einem anderen Prozess, als dem
6ae232055d4d8a97267517c5e50074c2c819941and Elternprozess, ein Signal zu senden. Es gibt drei Signale, die Sie an den
6ae232055d4d8a97267517c5e50074c2c819941and Elternprozess senden können: <code><a href="#term">TERM</a></code>,
6ae232055d4d8a97267517c5e50074c2c819941and <code><a href="#graceful">USR1</a></code>, die nachfolgend beschrieben
6ae232055d4d8a97267517c5e50074c2c819941and werden.</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>Um dem Elternprozess ein Signal zu senden, verwenden Sie einen
6ae232055d4d8a97267517c5e50074c2c819941and <example>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</example>
6ae232055d4d8a97267517c5e50074c2c819941and <p>Die zweite Methode, dem <code>httpd</code>-Prozess zu signalisieren,
6ae232055d4d8a97267517c5e50074c2c819941and ist die Verwendung der <code>-k</code>-Befehlszeilenoptionen
6ae232055d4d8a97267517c5e50074c2c819941and <code>stop</code>, <code>restart</code> und <code>graceful</code>, wie
6ae232055d4d8a97267517c5e50074c2c819941and unten beschrieben. Dies sind Argumente des <a
6ae232055d4d8a97267517c5e50074c2c819941and href="programs/httpd.html">httpd</a>-Programms, es wird jedoch
6ae232055d4d8a97267517c5e50074c2c819941and empfohlen, sie unter Verwendung des Steuerskripts <a
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh href="programs/apachectl.html">apachectl</a> zu senden, welches diese
6ae232055d4d8a97267517c5e50074c2c819941and <p>Nachdem Sie <code>httpd</code> signalisiert haben, können Sie
6ae232055d4d8a97267517c5e50074c2c819941and dessen Fortschritt beobachten, indem Sie eingeben:</p>
6ae232055d4d8a97267517c5e50074c2c819941and <example>tail -f /usr/local/apache2/logs/error_log</example>
6ae232055d4d8a97267517c5e50074c2c819941and <p>Passen Sie diese Beispiele entsprechend Ihren <directive
6ae232055d4d8a97267517c5e50074c2c819941and module="mpm_common">PidFile</directive>-Einstellungen an.</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>Das Senden des <code>TERM</code>- oder <code>stop</code>-Signals an
6ae232055d4d8a97267517c5e50074c2c819941and den Elternprozess veranlasst diesen, sofort zu versuchen, alle seine
6ae232055d4d8a97267517c5e50074c2c819941and Kindprozesse zu beenden. Es kann einige Sekunden dauern, bis alle
6ae232055d4d8a97267517c5e50074c2c819941and Kindprozesse komplett beendet sind. Danach beendet sich der Elternprozess
6ae232055d4d8a97267517c5e50074c2c819941and selbst. Alle gerade bearbeiteten Anfragen werden abgebrochen.
6ae232055d4d8a97267517c5e50074c2c819941and Es werden keine weiteren Anfragen mehr bedient.</p>
6ae232055d4d8a97267517c5e50074c2c819941and<section id="graceful"><title>Unterbrechungsfreier Neustart</title>
6ae232055d4d8a97267517c5e50074c2c819941and <p>Das <code>USR1</code>- oder <code>graceful</code>-Signal
6ae232055d4d8a97267517c5e50074c2c819941and veranlasst den Elternprozess, die Kinder <em>anzuweisen</em>, sich
6ae232055d4d8a97267517c5e50074c2c819941and nach Abschluß ihrer momentanen bearbeiteten Anfrage zu beenden
6ae232055d4d8a97267517c5e50074c2c819941and (oder sich sofort zu beenden, wenn sie gerade keine Anfrage bedienen).
6ae232055d4d8a97267517c5e50074c2c819941and Der Elternprozess liest seine Konfigurationsdateien erneut ein und
6ae232055d4d8a97267517c5e50074c2c819941and öffnet seine Logdateien neu. Wenn ein Kindprozess stirbt,
6ae232055d4d8a97267517c5e50074c2c819941and ersetzt der Elternprozess ihn durch ein Kind der neuen
6ae232055d4d8a97267517c5e50074c2c819941and Konfigurations-<em>Generation</em>. Dieses beginnt sofort damit,
6ae232055d4d8a97267517c5e50074c2c819941and neue Anfragen zu bedienen.</p>
6ae232055d4d8a97267517c5e50074c2c819941and <note>Auf bestimmten Plattformen, welche kein <code>USR1</code>
6ae232055d4d8a97267517c5e50074c2c819941and für einen unterbrechungsfreien Neustart erlauben, kann ein
6ae232055d4d8a97267517c5e50074c2c819941and alternatives Signal verwendet werden (wie z.B.
6ae232055d4d8a97267517c5e50074c2c819941and <code>WINCH</code>). Der Befehl <code>apachectl graceful</code>
6ae232055d4d8a97267517c5e50074c2c819941and sendet das jeweils richtige Signal für Ihre Platform.</note>
6ae232055d4d8a97267517c5e50074c2c819941and <p>Der Code ist dafür ausgelegt, stets die MPM-Direktiven
6ae232055d4d8a97267517c5e50074c2c819941and zur Prozesssteuerung zu beachten, so dass die Anzahl der Prozesse
6ae232055d4d8a97267517c5e50074c2c819941and und Threads, die zur Bedienung der Clients bereitstehen, während
6ae232055d4d8a97267517c5e50074c2c819941and des Neustarts auf die entsprechenden Werte gesetzt werden.
6ae232055d4d8a97267517c5e50074c2c819941and Weiterhin wird <directive module="mpm_common">StartServers</directive>
6ae232055d4d8a97267517c5e50074c2c819941and auf folgende Art und Weise interpretiert: Wenn nach einer Sekunde
6ae232055d4d8a97267517c5e50074c2c819941and nicht mindestens <directive module="mpm_common">StartServers</directive>
6ae232055d4d8a97267517c5e50074c2c819941and neue Kindprozesse erstellt wurden, dann werden, um den Durchsatz zu
6ae232055d4d8a97267517c5e50074c2c819941and beschleunigen, entsprechend weitere erstellt. Auf diese Weise versucht
6ae232055d4d8a97267517c5e50074c2c819941and der Code sowohl die Anzahl der Kinder entsprechend der Serverlast
6ae232055d4d8a97267517c5e50074c2c819941and anzupassen als auch Ihre Wünsche hinsichtlich des Parameters
6ae232055d4d8a97267517c5e50074c2c819941and <directive>StartServers</directive> zu berücksichtigen.</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>Benutzer von <module>mod_status</module> werden feststellen,
6ae232055d4d8a97267517c5e50074c2c819941and dass die Serverstatistiken <strong>nicht</strong> auf Null
6ae232055d4d8a97267517c5e50074c2c819941and zurückgesetzt werden, wenn ein <code>USR1</code> gesendet
6ae232055d4d8a97267517c5e50074c2c819941and wurde. Der Code wurde so geschrieben, dass sowohl die Zeit minimiert
6ae232055d4d8a97267517c5e50074c2c819941and wird, in der der Server nicht in der Lage ist, neue Anfragen zu
6ae232055d4d8a97267517c5e50074c2c819941and bedienen (diese werden vom Betriebssystem in eine Warteschlange
6ae232055d4d8a97267517c5e50074c2c819941and gestellt, so dass sie auf keinen Fall verloren gehen) als auch
6ae232055d4d8a97267517c5e50074c2c819941and Ihre Parameter zur Feinabstimmung berücksichtigt werden.
6ae232055d4d8a97267517c5e50074c2c819941and Um dies zu erreichen, muss die <em>Statustabelle</em> (Scoreboard),
6ae232055d4d8a97267517c5e50074c2c819941and die dazu verwendet wird, alle Kinder über mehrere Generationen
6ae232055d4d8a97267517c5e50074c2c819941and zu verfolgen, erhalten bleiben.</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>Das Statusmodul benutzt außerdem ein <code>G</code>, um
6ae232055d4d8a97267517c5e50074c2c819941and diejenigen Kinder zu kennzeichen, die noch immer Anfragen bedienen,
6ae232055d4d8a97267517c5e50074c2c819941and welche gestartet wurden, bevor ein unterbrechungsfreier Neustart
6ae232055d4d8a97267517c5e50074c2c819941and veranlaßt wurde.</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>Derzeit gibt es keine Möglichkeit für ein
6ae232055d4d8a97267517c5e50074c2c819941and Log-Rotationsskript, das <code>USR1</code> verwendet, sicher
6ae232055d4d8a97267517c5e50074c2c819941and festzustellen, dass alle Kinder, die in ein vor dem Neustart
6ae232055d4d8a97267517c5e50074c2c819941and geöffnetes Log schreiben, beendet sind. Wir schlagen vor, dass
6ae232055d4d8a97267517c5e50074c2c819941and Sie nach dem Senden des Signals <code>USR1</code> eine angemessene
6ae232055d4d8a97267517c5e50074c2c819941and Zeitspanne warten, bevor Sie das alte Log anfassen. Wenn beispielsweise
6ae232055d4d8a97267517c5e50074c2c819941and die meisten Ihrer Zugriffe bei Benutzern mit niedriger Bandbreite
6ae232055d4d8a97267517c5e50074c2c819941and weniger als 10 Minuten für eine vollständige Antwort
6ae232055d4d8a97267517c5e50074c2c819941and benötigen, dann könnten Sie 15 Minuten warten, bevor Sie auf
6ae232055d4d8a97267517c5e50074c2c819941and das alte Log zugreifen.</p>
6ae232055d4d8a97267517c5e50074c2c819941and <note>Wenn Ihre Konfigurationsdatei Fehler enthält, während
6ae232055d4d8a97267517c5e50074c2c819941and Sie einen Neustart anweisen, dann wird Ihr Elternprozess nicht neu starten,
6ae232055d4d8a97267517c5e50074c2c819941and sondern sich mit einem Fehler beenden. Im Falle eines unterbrechungsfreien
6ae232055d4d8a97267517c5e50074c2c819941and Neustarts läßt er die Kinder weiterlaufen, wenn er sich beendet.
6ae232055d4d8a97267517c5e50074c2c819941and (Dies sind die Kinder, die sich "sanft beenden", indem sie ihre letzte
6ae232055d4d8a97267517c5e50074c2c819941and Anfrage erledigen.) Das verursacht Probleme, wenn Sie versuchen,
6ae232055d4d8a97267517c5e50074c2c819941and den Server neu zu starten -- er ist nicht in der Lage, sich an die Ports zu
6ae232055d4d8a97267517c5e50074c2c819941and binden, an denen er lauschen soll. Bevor Sie einen Neustart
6ae232055d4d8a97267517c5e50074c2c819941and durchführen, können Sie die Syntax der Konfigurationsdateien
6ae232055d4d8a97267517c5e50074c2c819941and mit dem Befehlszeilenargument <code>-t</code> überprüfen
6ae232055d4d8a97267517c5e50074c2c819941and (siehe auch <a href="programs/httpd.html">httpd</a>). Das garantiert
6ae232055d4d8a97267517c5e50074c2c819941and allerdings nicht, dass der Server korrekt starten wird. Um sowohl die
6ae232055d4d8a97267517c5e50074c2c819941and Syntax als auch die Semantik der Konfigurationsdateien zu prüfen,
6ae232055d4d8a97267517c5e50074c2c819941and können Sie versuchen, <code>httpd</code> als nicht-root-Benutzer
6ae232055d4d8a97267517c5e50074c2c819941and zu starten. Wenn dabei keine Fehler auftreten, wird er versuchen, seine
6ae232055d4d8a97267517c5e50074c2c819941and Sockets und Logdateien zu öffnen und fehlschlagen, da er nicht root
6ae232055d4d8a97267517c5e50074c2c819941and ist (oder weil sich der gegenwärtig laufende <code>httpd</code>
6ae232055d4d8a97267517c5e50074c2c819941and bereits diese Ports gebunden hat). Wenn er aus einem anderen Grund
6ae232055d4d8a97267517c5e50074c2c819941and fehlschlägt, dann liegt wahrscheinlich ein Konfigurationsfehler vor.
6ae232055d4d8a97267517c5e50074c2c819941and Der Fehler sollte behoben werden, bevor der unterbrechungsfreie Neustart
6ae232055d4d8a97267517c5e50074c2c819941and angewiesen wird.</note>
6ae232055d4d8a97267517c5e50074c2c819941and <p>Das Senden des Signals <code>HUP</code> oder <code>restart</code>
6ae232055d4d8a97267517c5e50074c2c819941and veranlaßt den Elternprozess, wie bei <code>TERM</code> alle seine
6ae232055d4d8a97267517c5e50074c2c819941and Kinder zu beenden. Der Elternprozess beendet sich jedoch nicht. Er liest
6ae232055d4d8a97267517c5e50074c2c819941and seine Konfigurationsdateien neu ein und öffnet alle Logdateien
6ae232055d4d8a97267517c5e50074c2c819941and erneut. Dann erzeugt er einen neuen Satz Kindprozesse und setzt die
6ae232055d4d8a97267517c5e50074c2c819941and Bedienung von Zugriffen fort.</p>
6ae232055d4d8a97267517c5e50074c2c819941and <p>Benutzer von <module>mod_status</module> werden feststellen, dass
6ae232055d4d8a97267517c5e50074c2c819941and die Serverstatistiken auf Null gesetzt werden, wenn ein <code>HUP</code>
6ae232055d4d8a97267517c5e50074c2c819941and gesendet wurde.</p>
6ae232055d4d8a97267517c5e50074c2c819941and <note>Wenn Ihre Konfigurationsdatei einen Fehler enthält,
6ae232055d4d8a97267517c5e50074c2c819941and während Sie einen Neustart anweisen, dann wird Ihr Elternprozess
6ae232055d4d8a97267517c5e50074c2c819941and nicht neu starten, sondern sich mit einem Fehler beenden. Lesen Sie oben,
6ae232055d4d8a97267517c5e50074c2c819941and wie Sie das vermeiden können.</note>
6ae232055d4d8a97267517c5e50074c2c819941and<section id="race"><title>Anhang: Signale und Wettkampfsituationen</title>
6ae232055d4d8a97267517c5e50074c2c819941and <p>Vor der Version 1.2b9 des Apache existierten verschiedene
6ae232055d4d8a97267517c5e50074c2c819941and <em>Wettkampfsituationen</em> (race conditions), die den Neustart und
6ae232055d4d8a97267517c5e50074c2c819941and die Signale beeinflußt haben. (Eine einfache Beschreibung einer
6ae232055d4d8a97267517c5e50074c2c819941and Wettkampfsituation lautet: es ist ein zeitabhängiges Problem; wenn
6ae232055d4d8a97267517c5e50074c2c819941and etwas zum falschen Zeitpunkt erfolgt, wird es sich nicht wie erwartet
6ae232055d4d8a97267517c5e50074c2c819941and verhalten.) Bei Architekturen mit dem "richtigen" Funktionsumfang
6ae232055d4d8a97267517c5e50074c2c819941and haben wir so viele eliminiert wie wir nur konnten. Dennoch
6ae232055d4d8a97267517c5e50074c2c819941and sollte beachtet werden, dass noch immer Wettkampfsituationen auf
6ae232055d4d8a97267517c5e50074c2c819941and bestimmten Architekturen existieren.</p>
6ae232055d4d8a97267517c5e50074c2c819941and module="mpm_common">ScoreBoardFile</directive> auf Platte verwenden,
6ae232055d4d8a97267517c5e50074c2c819941and besteht die Gefahr, dass die Statustabelle beschädigt wird.
6ae232055d4d8a97267517c5e50074c2c819941and Das kann zu "bind: Address already in use" ("bind: Adresse wird
6ae232055d4d8a97267517c5e50074c2c819941and bereits verwendet", nach einem <code>HUP</code>) oder "long lost
6ae232055d4d8a97267517c5e50074c2c819941and child came home!" ("Der verlorene Sohn ist heimgekehrt", nach einem
6ae232055d4d8a97267517c5e50074c2c819941and <code>USR1</code>) führen. Ersteres ist ein schwerer Fehler,
6ae232055d4d8a97267517c5e50074c2c819941and wärend letzteres lediglich bewirkt, dass der Server einen Eintrag
6ae232055d4d8a97267517c5e50074c2c819941and in der Statustabelle verliert. So kann es ratsam sein, unterbrechungsfreie
6ae232055d4d8a97267517c5e50074c2c819941and Neustarts zusammen mit einem gelegentlichen harten Neustart zu verwenden.
6ae232055d4d8a97267517c5e50074c2c819941and Diese Probleme lassen sich nur sehr schwer umgehen, aber
6ae232055d4d8a97267517c5e50074c2c819941and glücklicherweise benötigen die meisten Architekturen keine
6ae232055d4d8a97267517c5e50074c2c819941and Statustabelle in Form einer Datei. Bitte lesen Sie für Architekturen,
6ae232055d4d8a97267517c5e50074c2c819941and die sie benötigen, die Dokumentation zu <directive
6ae232055d4d8a97267517c5e50074c2c819941and <p>Alle Architekturen haben in jedem Kindprozess eine kleine
6ae232055d4d8a97267517c5e50074c2c819941and Wettkampfsituation, welche die zweite und nachfolgende Anfragen
6ae232055d4d8a97267517c5e50074c2c819941and einer persistenten HTTP-Verbindung (KeepAlive) umfaßt. Der Prozess
6ae232055d4d8a97267517c5e50074c2c819941and kann nach dem Lesen der Anfragezeile aber vor dem Lesen der Anfrage-Header
6ae232055d4d8a97267517c5e50074c2c819941and enden. Es existiert eine Korrektur, die für 1.2 zu spät kam.
6ae232055d4d8a97267517c5e50074c2c819941and Theoretisch sollte das kein Problem darstellen, da
6ae232055d4d8a97267517c5e50074c2c819941and der KeepAlive-Client derartige Ereignisse aufgrund von
6ae232055d4d8a97267517c5e50074c2c819941and Netzwerk-Latenzzeiten und Auszeiten des Servers erwarten sollte.
6ae232055d4d8a97267517c5e50074c2c819941and In der Praxis scheint keiner von beiden beeinflußt zu werden
6ae232055d4d8a97267517c5e50074c2c819941and -- in einem Testfall wurde der Server zwanzig mal
6ae232055d4d8a97267517c5e50074c2c819941and pro Sekunde neu gestartet, während Clients das Angebot abgegrast
6ae232055d4d8a97267517c5e50074c2c819941and haben, ohne kaputte Bilder oder leere Dokumente zu erhalten.</p>
6ae232055d4d8a97267517c5e50074c2c819941and</manualpage>