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 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7 This file is generated from xml source: DO NOT EDIT
8 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
10 <title>Beenden und Neustarten - Apache HTTP Server Version 2.5</title>
11 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
12 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
13 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
14 <script src="./style/scripts/prettify.min.js" type="text/javascript">
17 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
18 <body id="manual-page"><div id="page-header">
19 <p class="menu"><a href="./mod/">Module</a> | <a href="./mod/quickreference.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p>
20 <p class="apache">Apache HTTP Server Version 2.5</p>
21 <img alt="" src="./images/feather.png" /></div>
22 <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
24 <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP-Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a> > <a href="./">Version 2.5</a></div><div id="page-content"><div id="preamble"><h1>Beenden und Neustarten</h1>
26 <p><span>Verfügbare Sprachen: </span><a href="./de/stopping.html" title="Deutsch"> de </a> |
27 <a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
28 <a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
29 <a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
30 <a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
31 <a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
32 <a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
34 <div class="outofdate">Diese Übersetzung ist möglicherweise
35 nicht mehr aktuell. Bitte prüfen Sie die englische Version auf
36 die neuesten Änderungen.</div>
38 <p>Dieses Dokument umfasst das Beenden und Neustarten des
39 Apache auf Unix-ähnlichen Systemen. Anwender von Windows NT, 2000
40 und XP sollten <a href="platform/windows.html#winsvc">Betreiben
41 des Apache als Dienst</a> lesen, während hingegen Anwender von
42 Windows 9x sowie ME <a href="platform/windows.html#wincons">Betreiben
43 des Apache als Konsolenanwendung</a> lesen sollten, um mehr Informationen
44 zur Handhabung des Apache auf diesen Systemen zu erhalten.</p>
46 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Einleitung</a></li>
47 <li><img alt="" src="./images/down.gif" /> <a href="#term">Beenden</a></li>
48 <li><img alt="" src="./images/down.gif" /> <a href="#graceful">Unterbrechungsfreier Neustart</a></li>
49 <li><img alt="" src="./images/down.gif" /> <a href="#hup">Neustarten</a></li>
50 <li><img alt="" src="./images/down.gif" /> <a href="#race">Anhang: Signale und Wettkampfsituationen</a></li>
51 </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><li><a href="#comments_section">Kommentare</a></li></ul></div>
52 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
54 <h2><a name="introduction" id="introduction">Einleitung</a> <a title="Permanent link" href="#introduction" class="permalink">¶</a></h2>
56 <p>Um den Apache zu stoppen oder neu zu starten, müssen Sie
57 ein Signal an den laufenden <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Prozess senden. Es gibt
58 zwei Möglichkeiten, diese Signale zu senden. Zum einen können
59 Sie den Unix-Befehl <code>kill</code> verwenden, um den Prozessen
60 direkt Signale zu senden. Sie werden feststellen, dass auf Ihrem
61 System mehrere <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Programme laufen. Sie sollten
62 jedoch nicht jedem dieser Prozesse ein Signal senden, sondern nur dem
63 Elternprozess, dessen PID im <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> steht. Das heißt, Sie
64 sollten es niemals nötig haben, einem anderen Prozess, als dem
65 Elternprozess, ein Signal zu senden. Es gibt drei Signale, die Sie an den
66 Elternprozess senden können: <code><a href="#term">TERM</a></code>,
67 <code><a href="#hup">HUP</a></code> und
68 <code><a href="#graceful">USR1</a></code>, die nachfolgend beschrieben
71 <p>Um dem Elternprozess ein Signal zu senden, verwenden Sie einen
74 <div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div>
76 <p>Die zweite Methode, dem <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Prozess zu
77 signalisieren, ist die Verwendung der <code>-k</code>-Befehlszeilenoptionen
78 <code>stop</code>, <code>restart</code> und <code>graceful</code>, wie
79 unten beschrieben. Dies sind Argumente des <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Programms, es wird jedoch
80 empfohlen, sie unter Verwendung des Steuerskripts <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> zu senden, welches diese
81 an <code class="program"><a href="./programs/httpd.html">httpd</a></code> durchreicht.</p>
83 <p>Nachdem Sie <code class="program"><a href="./programs/httpd.html">httpd</a></code> signalisiert haben, können Sie
84 dessen Fortschritt beobachten, indem Sie eingeben:</p>
86 <div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div>
88 <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>
89 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
91 <h2><a name="term" id="term">Beenden</a> <a title="Permanent link" href="#term" class="permalink">¶</a></h2>
93 <dl><dt>Signal: TERM</dt>
94 <dd><code>apachectl -k stop</code></dd>
97 <p>Das Senden des <code>TERM</code>- oder <code>stop</code>-Signals an
98 den Elternprozess veranlasst diesen, sofort zu versuchen, alle seine
99 Kindprozesse zu beenden. Es kann einige Sekunden dauern, bis alle
100 Kindprozesse komplett beendet sind. Danach beendet sich der Elternprozess
101 selbst. Alle gerade bearbeiteten Anfragen werden abgebrochen.
102 Es werden keine weiteren Anfragen mehr bedient.</p>
103 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
104 <div class="section">
105 <h2><a name="graceful" id="graceful">Unterbrechungsfreier Neustart</a> <a title="Permanent link" href="#graceful" class="permalink">¶</a></h2>
107 <dl><dt>Signal: USR1</dt>
108 <dd><code>apachectl -k graceful</code></dd>
111 <p>Das <code>USR1</code>- oder <code>graceful</code>-Signal
112 veranlasst den Elternprozess, die Kinder <em>anzuweisen</em>, sich
113 nach Abschluß ihrer momentanen bearbeiteten Anfrage zu beenden
114 (oder sich sofort zu beenden, wenn sie gerade keine Anfrage bedienen).
115 Der Elternprozess liest seine Konfigurationsdateien erneut ein und
116 öffnet seine Logdateien neu. Wenn ein Kindprozess stirbt,
117 ersetzt der Elternprozess ihn durch ein Kind der neuen
118 Konfigurations-<em>Generation</em>. Dieses beginnt sofort damit,
119 neue Anfragen zu bedienen.</p>
121 <div class="note">Auf bestimmten Plattformen, welche kein <code>USR1</code>
122 für einen unterbrechungsfreien Neustart erlauben, kann ein
123 alternatives Signal verwendet werden (wie z.B.
124 <code>WINCH</code>). Der Befehl <code>apachectl graceful</code>
125 sendet das jeweils richtige Signal für Ihre Platform.</div>
127 <p>Der Code ist dafür ausgelegt, stets die MPM-Direktiven
128 zur Prozesssteuerung zu beachten, so dass die Anzahl der Prozesse
129 und Threads, die zur Bedienung der Clients bereitstehen, während
130 des Neustarts auf die entsprechenden Werte gesetzt werden.
131 Weiterhin wird <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code>
132 auf folgende Art und Weise interpretiert: Wenn nach einer Sekunde
133 nicht mindestens <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code>
134 neue Kindprozesse erstellt wurden, dann werden, um den Durchsatz zu
135 beschleunigen, entsprechend weitere erstellt. Auf diese Weise versucht
136 der Code sowohl die Anzahl der Kinder entsprechend der Serverlast
137 anzupassen als auch Ihre Wünsche hinsichtlich des Parameters
138 <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> zu
141 <p>Benutzer von <code class="module"><a href="./mod/mod_status.html">mod_status</a></code> werden feststellen,
142 dass die Serverstatistiken <strong>nicht</strong> auf Null
143 zurückgesetzt werden, wenn ein <code>USR1</code> gesendet
144 wurde. Der Code wurde so geschrieben, dass sowohl die Zeit minimiert
145 wird, in der der Server nicht in der Lage ist, neue Anfragen zu
146 bedienen (diese werden vom Betriebssystem in eine Warteschlange
147 gestellt, so dass sie auf keinen Fall verloren gehen) als auch
148 Ihre Parameter zur Feinabstimmung berücksichtigt werden.
149 Um dies zu erreichen, muss die <em>Statustabelle</em> (Scoreboard),
150 die dazu verwendet wird, alle Kinder über mehrere Generationen
151 zu verfolgen, erhalten bleiben.</p>
153 <p>Das Statusmodul benutzt außerdem ein <code>G</code>, um
154 diejenigen Kinder zu kennzeichen, die noch immer Anfragen bedienen,
155 welche gestartet wurden, bevor ein unterbrechungsfreier Neustart
158 <p>Derzeit gibt es keine Möglichkeit für ein
159 Log-Rotationsskript, das <code>USR1</code> verwendet, sicher
160 festzustellen, dass alle Kinder, die in ein vor dem Neustart
161 geöffnetes Log schreiben, beendet sind. Wir schlagen vor, dass
162 Sie nach dem Senden des Signals <code>USR1</code> eine angemessene
163 Zeitspanne warten, bevor Sie das alte Log anfassen. Wenn beispielsweise
164 die meisten Ihrer Zugriffe bei Benutzern mit niedriger Bandbreite
165 weniger als 10 Minuten für eine vollständige Antwort
166 benötigen, dann könnten Sie 15 Minuten warten, bevor Sie auf
167 das alte Log zugreifen.</p>
169 <div class="note">Wenn Ihre Konfigurationsdatei Fehler enthält, während
170 Sie einen Neustart anweisen, dann wird Ihr Elternprozess nicht neu starten,
171 sondern sich mit einem Fehler beenden. Im Falle eines unterbrechungsfreien
172 Neustarts läßt er die Kinder weiterlaufen, wenn er sich beendet.
173 (Dies sind die Kinder, die sich "sanft beenden", indem sie ihre letzte
174 Anfrage erledigen.) Das verursacht Probleme, wenn Sie versuchen,
175 den Server neu zu starten -- er ist nicht in der Lage, sich an die Ports zu
176 binden, an denen er lauschen soll. Bevor Sie einen Neustart
177 durchführen, können Sie die Syntax der Konfigurationsdateien
178 mit dem Befehlszeilenargument <code>-t</code> überprüfen
179 (siehe auch <code class="program"><a href="./programs/httpd.html">httpd</a></code>). Das garantiert
180 allerdings nicht, dass der Server korrekt starten wird. Um sowohl die
181 Syntax als auch die Semantik der Konfigurationsdateien zu prüfen,
182 können Sie versuchen, <code class="program"><a href="./programs/httpd.html">httpd</a></code> als nicht-root-Benutzer
183 zu starten. Wenn dabei keine Fehler auftreten, wird er versuchen, seine
184 Sockets und Logdateien zu öffnen und fehlschlagen, da er nicht root
185 ist (oder weil sich der gegenwärtig laufende <code class="program"><a href="./programs/httpd.html">httpd</a></code>
186 bereits diese Ports gebunden hat). Wenn er aus einem anderen Grund
187 fehlschlägt, dann liegt wahrscheinlich ein Konfigurationsfehler vor.
188 Der Fehler sollte behoben werden, bevor der unterbrechungsfreie Neustart
189 angewiesen wird.</div>
190 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
191 <div class="section">
192 <h2><a name="hup" id="hup">Neustarten</a> <a title="Permanent link" href="#hup" class="permalink">¶</a></h2>
194 <dl><dt>Signal: HUP</dt>
195 <dd><code>apachectl -k restart</code></dd>
198 <p>Das Senden des Signals <code>HUP</code> oder <code>restart</code>
199 veranlaßt den Elternprozess, wie bei <code>TERM</code> alle seine
200 Kinder zu beenden. Der Elternprozess beendet sich jedoch nicht. Er liest
201 seine Konfigurationsdateien neu ein und öffnet alle Logdateien
202 erneut. Dann erzeugt er einen neuen Satz Kindprozesse und setzt die
203 Bedienung von Zugriffen fort.</p>
205 <p>Benutzer von <code class="module"><a href="./mod/mod_status.html">mod_status</a></code> werden feststellen, dass
206 die Serverstatistiken auf Null gesetzt werden, wenn ein <code>HUP</code>
209 <div class="note">Wenn Ihre Konfigurationsdatei einen Fehler enthält,
210 während Sie einen Neustart anweisen, dann wird Ihr Elternprozess
211 nicht neu starten, sondern sich mit einem Fehler beenden. Lesen Sie oben,
212 wie Sie das vermeiden können.</div>
213 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
214 <div class="section">
215 <h2><a name="race" id="race">Anhang: Signale und Wettkampfsituationen</a> <a title="Permanent link" href="#race" class="permalink">¶</a></h2>
217 <p>Vor der Version 1.2b9 des Apache existierten verschiedene
218 <em>Wettkampfsituationen</em> (race conditions), die den Neustart und
219 die Signale beeinflußt haben. (Einfach erklärt ist eine
220 Wettkampfsituation ein zeitabhängiges Problem - wenn
221 etwas zum falschen Zeitpunkt erfolgt oder Dinge in der falschen
222 Reihenfolge passieren, ist unerwartetes Verhalten die Folge. Wenn die
223 gleichen Dinge zur richtigen Zeit geschehen, funktioniert alles korrekt.)
224 Bei Architekturen mit dem "richtigen" Funktionsumfang
225 haben wir so viele eliminiert wie wir nur konnten. Dennoch
226 sollte beachtet werden, dass noch immer Wettkampfsituationen auf
227 bestimmten Architekturen existieren.</p>
229 <p>Bei Architekturen, die ein <code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code> auf Platte verwenden,
230 besteht die Gefahr, dass die Statustabelle beschädigt wird.
231 Das kann zu "bind: Address already in use" ("bind: Adresse wird
232 bereits verwendet", nach einem <code>HUP</code>) oder "long lost
233 child came home!" ("Der verlorene Sohn ist heimgekehrt", nach einem
234 <code>USR1</code>) führen. Ersteres ist ein schwerer Fehler,
235 wärend letzteres lediglich bewirkt, dass der Server einen Eintrag
236 in der Statustabelle verliert. So kann es ratsam sein, unterbrechungsfreie
237 Neustarts zusammen mit einem gelegentlichen harten Neustart zu verwenden.
238 Diese Probleme lassen sich nur sehr schwer umgehen, aber
239 glücklicherweise benötigen die meisten Architekturen keine
240 Statustabelle in Form einer Datei. Bitte lesen Sie für Architekturen,
241 die sie benötigen, die Dokumentation zu <code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code>.</p>
243 <p>Alle Architekturen haben in jedem Kindprozess eine kleine
244 Wettkampfsituation, welche die zweite und nachfolgende Anfragen
245 einer persistenten HTTP-Verbindung (KeepAlive) umfaßt. Der Prozess
246 kann nach dem Lesen der Anfragezeile aber vor dem Lesen der Anfrage-Header
247 enden. Es existiert eine Korrektur, die für 1.2 zu spät kam.
248 Theoretisch sollte das kein Problem darstellen, da
249 der KeepAlive-Client derartige Ereignisse aufgrund von
250 Netzwerk-Latenzzeiten und Auszeiten des Servers erwarten sollte.
251 In der Praxis scheint keiner von beiden beeinflußt zu werden
252 -- in einem Testfall wurde der Server zwanzig mal
253 pro Sekunde neu gestartet, während Clients das Angebot abgegrast
254 haben, ohne kaputte Bilder oder leere Dokumente zu erhalten.</p>
256 <div class="bottomlang">
257 <p><span>Verfügbare Sprachen: </span><a href="./de/stopping.html" title="Deutsch"> de </a> |
258 <a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
259 <a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
260 <a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
261 <a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
262 <a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
263 <a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
264 </div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Kommentare</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
265 <script type="text/javascript"><!--//--><![CDATA[//><!--
266 var comments_shortname = 'httpd';
267 var comments_identifier = 'http://httpd.apache.org/docs/trunk/stopping.html';
269 if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
270 d.write('<div id="comments_thread"><\/div>');
271 var s = d.createElement('script');
272 s.type = 'text/javascript';
274 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
275 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
278 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
280 })(window, document);
281 //--><!]]></script></div><div id="footer">
282 <p class="apache">Copyright 2019 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>
283 <p class="menu"><a href="./mod/">Module</a> | <a href="./mod/quickreference.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p></div><script type="text/javascript"><!--//--><
projects / apache / blob