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