home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 November / CMCD1104.ISO / Software / Complet / Apache / apache_2.0.52-win32-x86-no_ssl.msi / Data.Cab / F277742_stopping.xml.de < prev    next >
Extensible Markup Language  |  2004-04-17  |  13KB  |  247 lines
  1. <?xml version='1.0' encoding='UTF-8' ?>
  2. <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
  3. <?xml-stylesheet type="text/xsl" href="./style/manual.de.xsl"?>
  4. <!-- English Revision: 1.2.2.9 -->
  5.  
  6. <!--
  7.  Copyright 2002-2004 The Apache Software Foundation
  8.  
  9.  Licensed under the Apache License, Version 2.0 (the "License");
  10.  you may not use this file except in compliance with the License.
  11.  You may obtain a copy of the License at
  12.  
  13.      http://www.apache.org/licenses/LICENSE-2.0
  14.  
  15.  Unless required by applicable law or agreed to in writing, software
  16.  distributed under the License is distributed on an "AS IS" BASIS,
  17.  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  18.  See the License for the specific language governing permissions and
  19.  limitations under the License.
  20. -->
  21.  
  22. <manualpage metafile="stopping.xml.meta">
  23.  
  24.   <title>Beenden und Neustarten</title>
  25.  
  26. <summary>
  27.     <p>Dieses Dokument umfasst das Beenden und Neustarten des
  28.     Apache auf Unix-ähnlichen Systemen. Anwender von Windows NT, 2000
  29.     und XP sollten <a href="platform/windows.html#winsvc">Betreiben
  30.     des Apache als Dienst</a> lesen, während hingegen Anwender von
  31.     Windows 9x sowie ME <a href="platform/windows.html#wincons">Betreiben
  32.     des Apache als Konsolenanwendung</a> lesen sollten, um mehr Informationen
  33.     zur Handhabung des Apache auf diesen Systemen zu erhalten.</p>
  34. </summary>
  35.  
  36. <seealso><a href="programs/httpd.html">httpd</a></seealso>
  37. <seealso><a href="programs/apachectl.html">apachectl</a></seealso>
  38.  
  39. <section id="introduction"><title>Einleitung</title>
  40.  
  41.     <p>Um den Apache zu stoppen oder neu zu starten, müssen Sie
  42.     ein Signal an den laufenden <code>httpd</code>-Prozess senden. Es gibt
  43.     zwei Möglichkeiten, diese Signale zu senden. Zum einen können
  44.     Sie den Unix-Befehl <code>kill</code> verwenden, um den Prozessen
  45.     direkt Signale zu senden. Sie werden feststellen, dass auf Ihrem
  46.     System mehrere <code>httpd</code>-Programme laufen. Sie sollten jedoch
  47.     nicht jedem dieser Prozesse ein Signal senden, sondern nur dem
  48.     Elternprozess, dessen PID im <directive
  49.     module="mpm_common">PidFile</directive> steht. Das heißt, Sie
  50.     sollten es niemals nötig haben, einem anderen Prozess, als dem
  51.     Elternprozess, ein Signal zu senden. Es gibt drei Signale, die Sie an den
  52.     Elternprozess senden können: <code><a href="#term">TERM</a></code>,
  53.     <code><a href="#hup">HUP</a></code> und
  54.     <code><a href="#graceful">USR1</a></code>, die nachfolgend beschrieben
  55.     werden.</p>
  56.  
  57.     <p>Um dem Elternprozess ein Signal zu senden, verwenden Sie einen
  58.     Befehl wie z.B.:</p>
  59.  
  60.     <example>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</example>
  61.  
  62.     <p>Die zweite Methode, dem <code>httpd</code>-Prozess zu signalisieren,
  63.     ist die Verwendung der <code>-k</code>-Befehlszeilenoptionen
  64.     <code>stop</code>, <code>restart</code> und <code>graceful</code>, wie
  65.     unten beschrieben. Dies sind Argumente des <a
  66.     href="programs/httpd.html">httpd</a>-Programms, es wird jedoch
  67.     empfohlen, sie unter Verwendung des Steuerskripts <a
  68.     href="programs/apachectl.html">apachectl</a> zu senden, welches diese
  69.     an <code>httpd</code> durchreicht.</p>
  70.  
  71.     <p>Nachdem Sie <code>httpd</code> signalisiert haben, können Sie
  72.     dessen Fortschritt beobachten, indem Sie eingeben:</p>
  73.  
  74.     <example>tail -f /usr/local/apache2/logs/error_log</example>
  75.  
  76.     <p>Passen Sie diese Beispiele entsprechend Ihren <directive
  77.     module="core">ServerRoot</directive>- und <directive
  78.     module="mpm_common">PidFile</directive>-Einstellungen an.</p>
  79. </section>
  80.  
  81. <section id="term"><title>Beenden</title>
  82.  
  83.     <dl><dt>Signal: TERM</dt>
  84.       <dd><code>apachectl -k stop</code></dd>
  85.     </dl>
  86.  
  87.     <p>Das Senden des <code>TERM</code>- oder <code>stop</code>-Signals an
  88.     den Elternprozess veranlasst diesen, sofort zu versuchen, alle seine
  89.     Kindprozesse zu beenden. Es kann einige Sekunden dauern, bis alle
  90.     Kindprozesse komplett beendet sind. Danach beendet sich der Elternprozess
  91.     selbst. Alle gerade bearbeiteten Anfragen werden abgebrochen.
  92.     Es werden keine weiteren Anfragen mehr bedient.</p>
  93. </section>
  94.  
  95. <section id="graceful"><title>Unterbrechungsfreier Neustart</title>
  96.  
  97.     <dl><dt>Signal: USR1</dt>
  98.       <dd><code>apachectl -k graceful</code></dd>
  99.     </dl>
  100.  
  101.     <p>Das <code>USR1</code>- oder <code>graceful</code>-Signal
  102.     veranlasst den Elternprozess, die Kinder <em>anzuweisen</em>, sich
  103.     nach Abschluß ihrer momentanen bearbeiteten Anfrage zu beenden
  104.     (oder sich sofort zu beenden, wenn sie gerade keine Anfrage bedienen).
  105.     Der Elternprozess liest seine Konfigurationsdateien erneut ein und
  106.     öffnet seine Logdateien neu. Wenn ein Kindprozess stirbt,
  107.     ersetzt der Elternprozess ihn durch ein Kind der neuen
  108.     Konfigurations-<em>Generation</em>. Dieses beginnt sofort damit,
  109.     neue Anfragen zu bedienen.</p>
  110.  
  111.     <note>Auf bestimmten Plattformen, welche kein <code>USR1</code>
  112.     für einen unterbrechungsfreien Neustart erlauben, kann ein
  113.     alternatives Signal verwendet werden (wie z.B.
  114.     <code>WINCH</code>). Der Befehl <code>apachectl graceful</code>
  115.     sendet das jeweils richtige Signal für Ihre Platform.</note>
  116.  
  117.     <p>Der Code ist dafür ausgelegt, stets die MPM-Direktiven
  118.     zur Prozesssteuerung zu beachten, so dass die Anzahl der Prozesse
  119.     und Threads, die zur Bedienung der Clients bereitstehen, während
  120.     des Neustarts auf die entsprechenden Werte gesetzt werden.
  121.     Weiterhin wird <directive module="mpm_common">StartServers</directive>
  122.     auf folgende Art und Weise interpretiert: Wenn nach einer Sekunde
  123.     nicht mindestens <directive module="mpm_common">StartServers</directive>
  124.     neue Kindprozesse erstellt wurden, dann werden, um den Durchsatz zu
  125.     beschleunigen, entsprechend weitere erstellt. Auf diese Weise versucht
  126.     der Code sowohl die Anzahl der Kinder entsprechend der Serverlast
  127.     anzupassen als auch Ihre Wünsche hinsichtlich des Parameters
  128.     <directive>StartServers</directive> zu berücksichtigen.</p>
  129.  
  130.     <p>Benutzer von <module>mod_status</module> werden feststellen,
  131.     dass die Serverstatistiken <strong>nicht</strong> auf Null
  132.     zurückgesetzt werden, wenn ein <code>USR1</code> gesendet
  133.     wurde. Der Code wurde so geschrieben, dass sowohl die Zeit minimiert
  134.     wird, in der der Server nicht in der Lage ist, neue Anfragen zu
  135.     bedienen (diese werden vom Betriebssystem in eine Warteschlange
  136.     gestellt, so dass sie auf keinen Fall verloren gehen) als auch
  137.     Ihre Parameter zur Feinabstimmung berücksichtigt werden.
  138.     Um dies zu erreichen, muss die <em>Statustabelle</em> (Scoreboard),
  139.     die dazu verwendet wird, alle Kinder über mehrere Generationen
  140.     zu verfolgen, erhalten bleiben.</p>
  141.  
  142.     <p>Das Statusmodul benutzt außerdem ein <code>G</code>, um
  143.     diejenigen Kinder zu kennzeichen, die noch immer Anfragen bedienen,
  144.     welche gestartet wurden, bevor ein unterbrechungsfreier Neustart
  145.     veranlaßt wurde.</p>
  146.  
  147.     <p>Derzeit gibt es keine Möglichkeit für ein
  148.     Log-Rotationsskript, das <code>USR1</code> verwendet, sicher
  149.     festzustellen, dass alle Kinder, die in ein vor dem Neustart
  150.     geöffnetes Log schreiben, beendet sind. Wir schlagen vor, dass
  151.     Sie nach dem Senden des Signals <code>USR1</code> eine angemessene
  152.     Zeitspanne warten, bevor Sie das alte Log anfassen. Wenn beispielsweise
  153.     die meisten Ihrer Zugriffe bei Benutzern mit niedriger Bandbreite
  154.     weniger als 10 Minuten für eine vollständige Antwort
  155.     benötigen, dann könnten Sie 15 Minuten warten, bevor Sie auf
  156.     das alte Log zugreifen.</p>
  157.  
  158.     <note>Wenn Ihre Konfigurationsdatei Fehler enthält, während
  159.     Sie einen Neustart anweisen, dann wird Ihr Elternprozess nicht neu starten,
  160.     sondern sich mit einem Fehler beenden. Im Falle eines unterbrechungsfreien
  161.     Neustarts läßt er die Kinder weiterlaufen, wenn er sich beendet.
  162.     (Dies sind die Kinder, die sich "sanft beenden", indem sie ihre letzte
  163.     Anfrage erledigen.) Das verursacht Probleme, wenn Sie versuchen,
  164.     den Server neu zu starten -- er ist nicht in der Lage, sich an die Ports zu
  165.     binden, an denen er lauschen soll. Bevor Sie einen Neustart
  166.     durchführen, können Sie die Syntax der Konfigurationsdateien
  167.     mit dem Befehlszeilenargument <code>-t</code> überprüfen
  168.     (siehe auch <a href="programs/httpd.html">httpd</a>). Das garantiert
  169.     allerdings nicht, dass der Server korrekt starten wird. Um sowohl die
  170.     Syntax als auch die Semantik der Konfigurationsdateien zu prüfen,
  171.     können Sie versuchen, <code>httpd</code> als nicht-root-Benutzer
  172.     zu starten. Wenn dabei keine Fehler auftreten, wird er versuchen, seine
  173.     Sockets und Logdateien zu öffnen und fehlschlagen, da er nicht root
  174.     ist (oder weil sich der gegenwärtig laufende <code>httpd</code>
  175.     bereits diese Ports gebunden hat). Wenn er aus einem anderen Grund
  176.     fehlschlägt, dann liegt wahrscheinlich ein Konfigurationsfehler vor.
  177.     Der Fehler sollte behoben werden, bevor der unterbrechungsfreie Neustart
  178.     angewiesen wird.</note>
  179. </section>
  180.  
  181. <section id="hup"><title>Neustarten</title>
  182.  
  183.     <dl><dt>Signal: HUP</dt>
  184.       <dd><code>apachectl -k restart</code></dd>
  185.     </dl>
  186.  
  187.     <p>Das Senden des Signals <code>HUP</code> oder <code>restart</code>
  188.     veranlaßt den Elternprozess, wie bei <code>TERM</code> alle seine
  189.     Kinder zu beenden. Der Elternprozess beendet sich jedoch nicht. Er liest
  190.     seine Konfigurationsdateien neu ein und öffnet alle Logdateien
  191.     erneut. Dann erzeugt er einen neuen Satz Kindprozesse und setzt die
  192.     Bedienung von Zugriffen fort.</p>
  193.  
  194.     <p>Benutzer von <module>mod_status</module> werden feststellen, dass
  195.     die Serverstatistiken auf Null gesetzt werden, wenn ein <code>HUP</code>
  196.     gesendet wurde.</p>
  197.  
  198.     <note>Wenn Ihre Konfigurationsdatei einen Fehler enthält,
  199.     während Sie einen Neustart anweisen, dann wird Ihr Elternprozess
  200.     nicht neu starten, sondern sich mit einem Fehler beenden. Lesen Sie oben,
  201.     wie Sie das vermeiden können.</note>
  202. </section>
  203.  
  204. <section id="race"><title>Anhang: Signale und Wettkampfsituationen</title>
  205.  
  206.     <p>Vor der Version 1.2b9 des Apache existierten verschiedene
  207.     <em>Wettkampfsituationen</em> (race conditions), die den Neustart und
  208.     die Signale beeinflußt haben. (Eine einfache Beschreibung einer
  209.     Wettkampfsituation lautet: es ist ein zeitabhängiges Problem; wenn
  210.     etwas zum falschen Zeitpunkt erfolgt, wird es sich nicht wie erwartet
  211.     verhalten.) Bei Architekturen mit dem "richtigen" Funktionsumfang
  212.     haben wir so viele eliminiert wie wir nur konnten. Dennoch
  213.     sollte beachtet werden, dass noch immer Wettkampfsituationen auf
  214.     bestimmten Architekturen existieren.</p>
  215.  
  216.     <p>Bei Architekturen, die ein <directive
  217.     module="mpm_common">ScoreBoardFile</directive> auf Platte verwenden,
  218.     besteht die Gefahr, dass die Statustabelle beschädigt wird.
  219.     Das kann zu "bind: Address already in use" ("bind: Adresse wird
  220.     bereits verwendet", nach einem <code>HUP</code>) oder "long lost
  221.     child came home!" ("Der verlorene Sohn ist heimgekehrt", nach einem
  222.     <code>USR1</code>) führen. Ersteres ist ein schwerer Fehler,
  223.     wärend letzteres lediglich bewirkt, dass der Server einen Eintrag
  224.     in der Statustabelle verliert. So kann es ratsam sein, unterbrechungsfreie
  225.     Neustarts zusammen mit einem gelegentlichen harten Neustart zu verwenden.
  226.     Diese Probleme lassen sich nur sehr schwer umgehen, aber
  227.     glücklicherweise benötigen die meisten Architekturen keine
  228.     Statustabelle in Form einer Datei. Bitte lesen Sie für Architekturen,
  229.     die sie benötigen, die Dokumentation zu <directive
  230.     module="mpm_common">ScoreBoardFile</directive>.</p>
  231.  
  232.     <p>Alle Architekturen haben in jedem Kindprozess eine kleine
  233.     Wettkampfsituation, welche die zweite und nachfolgende Anfragen
  234.     einer persistenten HTTP-Verbindung (KeepAlive) umfaßt. Der Prozess
  235.     kann nach dem Lesen der Anfragezeile aber vor dem Lesen der Anfrage-Header
  236.     enden. Es existiert eine Korrektur, die für 1.2 zu spät kam.
  237.     Theoretisch sollte das kein Problem darstellen, da
  238.     der KeepAlive-Client derartige Ereignisse aufgrund von
  239.     Netzwerk-Latenzzeiten und Auszeiten des Servers erwarten sollte.
  240.     In der Praxis scheint keiner von beiden beeinflußt zu werden
  241.     -- in einem Testfall wurde der Server zwanzig mal
  242.     pro Sekunde neu gestartet, während Clients das Angebot abgegrast
  243.     haben, ohne kaputte Bilder oder leere Dokumente zu erhalten.</p>
  244. </section>
  245.  
  246. </manualpage>
  247.