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