📄 stopping.html.en
字号:
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --><title>Stopping and Restarting - Apache HTTP Server</title><link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /><link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /><link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link href="./images/favicon.ico" rel="shortcut icon" /></head><body id="manual-page"><div id="page-header"><p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p><p class="apache">Apache HTTP Server Version 2.2</p><img alt="" src="./images/feather.gif" /></div><div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div><div id="path"><a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.2</a></div><div id="page-content"><div id="preamble"><h1>Stopping and Restarting</h1><div class="toplang"><p><span>Available Languages: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |<a href="./en/stopping.html" title="English"> en </a> |<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Espa駉l"> es </a> |<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Fran鏰is"> fr </a> |<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |<a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="T黵k鏴"> tr </a></p></div> <p>This document covers stopping and restarting Apache on Unix-like systems. Windows NT, 2000 and XP users should see <a href="platform/windows.html#winsvc">Running Apache as a Service</a> and Windows 9x and ME users should see <a href="platform/windows.html#wincons">Running Apache as a Console Application</a> for information on how to control Apache on those platforms.</p></div><div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Introduction</a></li><li><img alt="" src="./images/down.gif" /> <a href="#term">Stop Now</a></li><li><img alt="" src="./images/down.gif" /> <a href="#graceful">Graceful Restart</a></li><li><img alt="" src="./images/down.gif" /> <a href="#hup">Restart Now</a></li><li><img alt="" src="./images/down.gif" /> <a href="#gracefulstop">Graceful Stop</a></li></ul><h3>See also</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="invoking.html">Starting</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div><div class="section"><h2><a name="introduction" id="introduction">Introduction</a></h2> <p>In order to stop or restart Apache, you must send a signal to the running <code class="program"><a href="./programs/httpd.html">httpd</a></code> processes. There are two ways to send the signals. First, you can use the unix <code>kill</code> command to directly send signals to the processes. You will notice many <code class="program"><a href="./programs/httpd.html">httpd</a></code> executables running on your system, but you should not send signals to any of them except the parent, whose pid is in the <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>. That is to say you shouldn't ever need to send signals to any process except the parent. There are four signals that you can send the parent: <code><a href="#term">TERM</a></code>, <code><a href="#graceful">USR1</a></code>, <code><a href="#hup">HUP</a></code>, and <code><a href="#gracefulstop">WINCH</a></code>, which will be described in a moment.</p> <p>To send a signal to the parent you should issue a command such as:</p><div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div> <p>The second method of signaling the <code class="program"><a href="./programs/httpd.html">httpd</a></code> processes is to use the <code>-k</code> command line options: <code>stop</code>, <code>restart</code>, <code>graceful</code> and <code>graceful-stop</code>, as described below. These are arguments to the <code class="program"><a href="./programs/httpd.html">httpd</a></code> binary, but we recommend that you send them using the <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> control script, which will pass them through to <code class="program"><a href="./programs/httpd.html">httpd</a></code>.</p> <p>After you have signaled <code class="program"><a href="./programs/httpd.html">httpd</a></code>, you can read about its progress by issuing:</p><div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div> <p>Modify those examples to match your <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> and <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> settings.</p></div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div><div class="section"><h2><a name="term" id="term">Stop Now</a></h2><dl><dt>Signal: TERM</dt><dd><code>apachectl -k stop</code></dd></dl> <p>Sending the <code>TERM</code> or <code>stop</code> signal to the parent causes it to immediately attempt to kill off all of its children. It may take it several seconds to complete killing off its children. Then the parent itself exits. Any requests in progress are terminated, and no further requests are served.</p></div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div><div class="section"><h2><a name="graceful" id="graceful">Graceful Restart</a></h2><dl><dt>Signal: USR1</dt><dd><code>apachectl -k graceful</code></dd></dl> <p>The <code>USR1</code> or <code>graceful</code> signal causes the parent process to <em>advise</em> the children to exit after their current request (or to exit immediately if they're not serving anything). The parent re-reads its configuration files and re-opens its log files. As each child dies off the parent replaces it with a child from the new <em>generation</em> of the configuration, which begins serving new requests immediately.</p> <p>This code is designed to always respect the process control directive of the MPMs, so the number of processes and threads available to serve clients will be maintained at the appropriate values throughout the restart process. Furthermore, it respects <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> in the following manner: if after one second at least <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> new children have not been created, then create enough to pick up the slack. Hence the code tries to maintain both the number of children appropriate for the current load on the server, and respect your wishes with the <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> parameter.</p>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -