apache/docs/manual/stopping.html.de

   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
   7       -->
   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="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
  18 <div id="path">
  19 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP-Server</a> &gt; <a href="http://httpd.apache.org/docs/">Dokumentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Beenden und Neustarten</h1>
  20 <div class="toplang">
  21 <p><span>Verfügbare Sprachen: </span><a href="./de/stopping.html" title="Deutsch">&nbsp;de&nbsp;</a> |
  22 <a href="./en/stopping.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  23 <a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
  24 <a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
  25 <a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  26 <a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  27 <a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  28 </div>
  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>
  32
  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>
  40 </div>
  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>
  48 <div class="section">
  49 <h2><a name="introduction" id="introduction">Einleitung</a></h2>
  50
  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
  64     werden.</p>
  65
  66     <p>Um dem Elternprozess ein Signal zu senden, verwenden Sie einen
  67     Befehl wie z.B.:</p>
  68
  69     <div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div>
  70
  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>
  77
  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>
  80
  81     <div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div>
  82
  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>
  85 <div class="section">
  86 <h2><a name="term" id="term">Beenden</a></h2>
  87
  88     <dl><dt>Signal: TERM</dt>
  89       <dd><code>apachectl -k stop</code></dd>
  90     </dl>
  91
  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>
  99 <div class="section">
 100 <h2><a name="graceful" id="graceful">Unterbrechungsfreier Neustart</a></h2>
 101
 102     <dl><dt>Signal: USR1</dt>
 103       <dd><code>apachectl -k graceful</code></dd>
 104     </dl>
 105
 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>
 115
 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>
 121
 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
 134     berücksichtigen.</p>
 135
 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>
 147
 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
 151     veranlaßt wurde.</p>
 152
 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>
 163
 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>
 188
 189     <dl><dt>Signal: HUP</dt>
 190       <dd><code>apachectl -k restart</code></dd>
 191     </dl>
 192
 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>
 199
 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>
 202     gesendet wurde.</p>
 203
 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>
 211
 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>
 223
 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>
 237
 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>
 250 </div></div>
 251 <div class="bottomlang">
 252 <p><span>Verfügbare Sprachen: </span><a href="./de/stopping.html" title="Deutsch">&nbsp;de&nbsp;</a> |
 253 <a href="./en/stopping.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 254 <a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
 255 <a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 256 <a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 257 <a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 258 <a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</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>
 262 </body></html>