stopping.html.ja.utf8 revision c7ed811e89712261aaa4432198e331389044e1f8
4c1132f34493327abc632196f5876a89aa573687Bob Halley<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4c1132f34493327abc632196f5876a89aa573687Bob Halley<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head><!--
4c1132f34493327abc632196f5876a89aa573687Bob Halley XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
4c1132f34493327abc632196f5876a89aa573687Bob Halley This file is generated from xml source: DO NOT EDIT
4c1132f34493327abc632196f5876a89aa573687Bob Halley XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
4c1132f34493327abc632196f5876a89aa573687Bob Halley<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
4c1132f34493327abc632196f5876a89aa573687Bob Halley<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
4c1132f34493327abc632196f5876a89aa573687Bob Halley<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
4c1132f34493327abc632196f5876a89aa573687Bob Halley<link href="/images/favicon.ico" rel="shortcut icon" /></head>
4c1132f34493327abc632196f5876a89aa573687Bob Halley<p class="menu"><a href="/mod/">モジュール</a> | <a href="/mod/directives.html">ディレクティブ</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">用語</a> | <a href="/sitemap.html">サイトマップ</a></p>
f41f183f628a148860a6d1f0070208cddd45b0c6Bob Halley<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
f41f183f628a148860a6d1f0070208cddd45b0c6Bob Halley<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP サーバ</a> > <a href="http://httpd.apache.org/docs/">ドキュメンテーション</a> > <a href="./">バージョン
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley 2.3</a></div><div id="page-content"><div id="preamble"><h1>停止と再起動</h1>
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley<p><span>言語: </span><a href="/de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley<a href="/en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
51917258dbb23cfe6069ae1cf2b7fc5aefc1e0c2Bob Halley<a href="/es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
51917258dbb23cfe6069ae1cf2b7fc5aefc1e0c2Bob Halley<a href="/fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
51917258dbb23cfe6069ae1cf2b7fc5aefc1e0c2Bob Halley<a href="/ja/stopping.html" title="Japanese"> ja </a> |
6d5dcd0dc9bdbd679282b1ffc47987d24c3a1346Bob Halley<a href="/ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley<a href="/tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
c45abd11bb68005d8a5c56c14b16f4184c3e057dMichael Graff <p>この文書では Unix に類似したシステムでの
c45abd11bb68005d8a5c56c14b16f4184c3e057dMichael Graff Apache の停止と再起動について扱っています。
a685d9c3b608eb768d237f20e8e8b1c5d3902146David Lawrence Windows NT, 2000, XP ユーザは<a href="platform/windows.html#winsvc">サービスとして
feb08cecf318bba330437cfcb725f48d999804d8James Brister Apache を実行する</a>で、Windows 9x, MEユーザは<a href="platform/windows.html#wincons">コンソールアプリケーションとして
c6d0fc864de5153699688ffd28ef8a286b986354James Brister Apache を実行する</a>で、
feb08cecf318bba330437cfcb725f48d999804d8James Brister これらのプラットホームでの使用方法をご覧下さい。</p>
feb08cecf318bba330437cfcb725f48d999804d8James Brister<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#introduction">イントロダクション</a></li>
e49d50b4436d760c040dca81c8426ee806996d6bDavid Lawrence<li><img alt="" src="/images/down.gif" /> <a href="#term">急な停止</a></li>
e49d50b4436d760c040dca81c8426ee806996d6bDavid Lawrence<li><img alt="" src="/images/down.gif" /> <a href="#graceful">緩やかな再起動</a></li>
e323a667e0324e6ac67a10c6fdd82a6a57097dc8James Brister<li><img alt="" src="/images/down.gif" /> <a href="#hup">急な再起動</a></li>
feb08cecf318bba330437cfcb725f48d999804d8James Brister<li><img alt="" src="/images/down.gif" /> <a href="#gracefulstop">緩やかな停止</a></li>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington</ul><h3>参照</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>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
25811a89c64b7499130c7cbd907d638507f0cb87Brian Wellington<h2><a name="introduction" id="introduction">イントロダクション</a></h2>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington <p>Apache を停止したり再起動したりするためには、実行されている
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington <code class="program"><a href="/programs/httpd.html">httpd</a></code> プロセスにシグナルを送る必要があります。
15f7ee3c0b027d9a6a3e25e548215236326b3b04Brian Wellington シグナルを送るには二つの方法があります。
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington 一つ目はプロセスに直接シグナルを送る unix の <code>kill</code>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington コマンドを使用する方法です。
75e4800964642475632766068e8d99de3ea3e8f0Brian Wellington システムを見ればたくさんの <code class="program"><a href="/programs/httpd.html">httpd</a></code> が
75e4800964642475632766068e8d99de3ea3e8f0Brian Wellington 実行されているのに気が付くでしょうが、シグナルを送るのは
75e4800964642475632766068e8d99de3ea3e8f0Brian Wellington 親プロセスだけで、それ以外の個々のプロセスには
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington シグナルを送らないで下さい。その親プロセスの pid は
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington <code class="directive"><a href="/mod/mpm_common.html#pidfile">PidFile</a></code>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington に書かれています。これはつまり、親以外のプロセスに
75e4800964642475632766068e8d99de3ea3e8f0Brian Wellington シグナルを送る必要すらない、ということです。
75e4800964642475632766068e8d99de3ea3e8f0Brian Wellington 親プロセスに送ることができる 4 種類のシグナルがあります:
15f7ee3c0b027d9a6a3e25e548215236326b3b04Brian Wellington <code><a href="#gracefulstop">WINCH</a></code>
15f7ee3c0b027d9a6a3e25e548215236326b3b04Brian Wellington です。これらの説明については続きをご覧下さい。</p>
15f7ee3c0b027d9a6a3e25e548215236326b3b04Brian Wellington <p>親プロセスにシグナルを送るには、
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington 次のようなコマンドを発行して下さい:</p>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington<div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington <p><code class="program"><a href="/programs/httpd.html">httpd</a></code> プロセスにシグナルを送る 2 番目の方法は
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington 下で説明されているように、<code>stop</code>, <code>restart</code>,
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington <code>graceful</code>, <code>graceful-stop</code> を指定できます。
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington これらは <code class="program"><a href="/programs/httpd.html">httpd</a></code> の引数ですが、
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington 制御用のスクリプト <code class="program"><a href="/programs/apachectl.html">apachectl</a></code> はそれらの引数をそのまま
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington <code class="program"><a href="/programs/httpd.html">httpd</a></code> に渡します。</p>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington <p><code class="program"><a href="/programs/httpd.html">httpd</a></code> にシグナルを送った後、
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington 実行状況を次のコマンドで読むことができます:</p>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington<div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington <p>ここに挙げた例は、各自の
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington <code class="directive"><a href="/mod/core.html#serverroot">ServerRoot</a></code>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington <code class="directive"><a href="/mod/mpm_common.html#pidfile">PidFile</a></code>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington の設定に適合するように適宜修正して下さい。</p>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington <p><code>TERM</code> あるいは <code>stop</code>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington シグナルを親プロセスに送ると、即座に子プロセス全てを kill しようとします。
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington 子プロセスを完全に kill し終わるまでに数秒かかるかもしれません。
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington その後、親プロセス自身が終了します。
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington 処理中のリクエストは全て停止され、もはやリクエストに対する
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington 応答はされません。</p>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington<h2><a name="graceful" id="graceful">緩やかな再起動</a></h2>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington <p>親プロセスは <code>USR1</code> あるいは <code>graceful</code>
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington シグナルを受け取ると、子プロセスに現在のリクエストの処理の後に終了する
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington (あるいは何もしていなければすぐに終了する)
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington 親プロセスは設定ファイルを再読込して、ログファイルを開き直します。
65c4736d9c0ebc6d9b1d991593b55566909da9cdBrian Wellington 子プロセスが徐々になくなるに従って、
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence そして、これらが新たなリクエストに即座に応答し始めます。</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence MPM のプロセス制御ディレクティブの設定を重視しますので、
bf43fdafa3bff9e84cb03f1a19aca74514d2516eBob Halley クライアントのリクエストを扱うプロセスとスレッドの数を再起動の処理中も
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence 適切な値に維持されます。。また、次のようにして
e323a667e0324e6ac67a10c6fdd82a6a57097dc8James Brister <code class="directive"><a href="/mod/mpm_common.html#startservers">StartServers</a></code>
e420bc4e0dd289dbd5dfd2acf228f772b96ebd8fMark Andrews 少なくとも 1 秒後に <code class="directive"><a href="/mod/mpm_common.html#startservers">StartServers</a></code> 個の新しい子プロセスが
e420bc4e0dd289dbd5dfd2acf228f772b96ebd8fMark Andrews 生成されていなければ、その数になるように適宜プロセスを生成します。
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson この挙動は現在の負荷に対して適切な子プロセスの数と
bf43fdafa3bff9e84cb03f1a19aca74514d2516eBob Halley <code class="directive"><a href="/mod/mpm_common.html#startservers">StartServers</a></code> パラメータでの
6017f424ee3c02d7f22132c77576ea38542fa949Andreas Gustafsson 希望の数の両方を維持しようとしています。</p>
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley <p><code class="module"><a href="/mod/mod_status.html">mod_status</a></code> を
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence サーバが新しいリクエストに応答不能な時間を最小にするように
bf43fdafa3bff9e84cb03f1a19aca74514d2516eBob Halley (リクエストは OS によってキューに追加されるので絶対に紛失はしません)、
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence また同時に、希望のチューニングパラメータを守るように
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence このようにするために、世代をまたがった全子プロセスの追跡に使われている
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <p>status モジュールは、緩やかな再起動以前から開始して
bf43fdafa3bff9e84cb03f1a19aca74514d2516eBob Halley リクエストに応答し続けている子プロセスを特定するために、
4fd3e3482c7e4ce01e2cf28f13e0152c8e50d746Mark Andrews 再起動前の子プロセスがログを書き終わったことを確証する方法が
4fd3e3482c7e4ce01e2cf28f13e0152c8e50d746Mark Andrews ありません。古いログに対して何かする前に、
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley 提案します。例えば、帯域の狭い通信路のユーザのリクエストのほとんどが 10
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley 分以下で完了しているということが分かっていれば、
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley 古いログに何かする前に 15 分待つということです。</p>
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley <div class="note"><p>再起動が発行されると設定ファイルの構文チェックがまず走り、
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley 設定ファイルに (構文上の) 誤りがないかチェックされます。
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley 誤りがあった場合エラーメッセージでその旨が示され、サーバは再起動されません。
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley こうすることでサーバが終了しているけれども再起動できないという状況を
139154bd9894495042f4e748f554e9c8b98b7598Bob Halley 防ぎ、サーバが機能不全な状態になるのを防いでいます。</p>
193738b819e3c699f9edd18864a6810fcfcec855Andreas Gustafsson <p>ただしこれでもサーバが正しく再起動することは保証されません。
fd35453765c6494d077edca44f4d998af5fd4cfaDavid Lawrence 設定ファイルの意味的な内容を構文と同様に検証したい場合は、
fd35453765c6494d077edca44f4d998af5fd4cfaDavid Lawrence 非 root ユーザで <code class="program"><a href="/programs/httpd.html">httpd</a></code> を起動しようとすればわかります。
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley もしエラーがなければ、ソケットやログを開こうとして
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley (もしくは実行中の <code class="program"><a href="/programs/httpd.html">httpd</a></code>
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley が既に必要なポートにバインドしているため)
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley これ以外の理由で起動に失敗したのであれば、
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley それは設定ファイルのエラーで、
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley 緩やかな再起動を行う前にその誤りを修正しなければなりません。</p>
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley <p><code>HUP</code> あるいは <code>restart</code> シグナルを親プロセスに送ると、
fd35453765c6494d077edca44f4d998af5fd4cfaDavid Lawrence 親プロセスは終了しません。
c8a42d6d81ff2fd9ad7fac94d4b85323554493c0Bob Halley 設定ファイルを再読込して、ログファイル全てを開き直します。
4fd3e3482c7e4ce01e2cf28f13e0152c8e50d746Mark Andrews その後、新しい子プロセスを起動して応答を続けます。</p>
6ef838d427c1ea858d2f09194a369134babf8b98Mark Andrews <p><code class="module"><a href="/mod/mod_status.html">mod_status</a></code>
6ef838d427c1ea858d2f09194a369134babf8b98Mark Andrews サーバ統計がゼロに設定されることに注意してください。</p>
fe37278859bce157001cca14cdfa3a761b0d5012Mark Andrews <div class="note">graceful 再起動時は、再起動前に構文チェックが行われます。
fe37278859bce157001cca14cdfa3a761b0d5012Mark Andrews もし構文エラーがあればその旨が示され、再起動は行われません。</div>
dac2799ea19735503a4d27f517d821aea210e594Andreas Gustafsson</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5d51e67c3b4f35c1be742574aacc1d88fe6ed444Mark Andrews<h2><a name="gracefulstop" id="gracefulstop">緩やかな停止</a></h2>
6d7585b3e948dd31bf78321d83ac0e024f44a71bMark Andrews<dd><code>apachectl -k graceful-stop</code></dd>
6d7585b3e948dd31bf78321d83ac0e024f44a71bMark Andrews <p><code>WINCH</code> や <code>graceful-stop</code> シグナルを受け取ると、
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley 親プロセスは子プロセスに現在処理中のリクエストの後に終了する
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley (あるいは処理中のものが何もなければ直ちに終了する)
94a3bcd132e515b4baa0884ba9dd0f361d2e17bcMark Andrews その後親プロセスは <code class="directive"><a href="/mod/mpm_common.html#pidfile">PidFile</a></code>
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley を削除し、ポートでの Listen を全て停止します。
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley 親プロセスはどの子プロセスがリクエスト処理中かを監視し続けています。
4fd3e3482c7e4ce01e2cf28f13e0152c8e50d746Mark Andrews 全ての子プロセスが終了するか
5d51e67c3b4f35c1be742574aacc1d88fe6ed444Mark Andrews <code class="directive"><a href="/mod/mpm_common.html#gracefulshutdowntimeout">GracefulShutdownTimeout</a></code>
6d5dcd0dc9bdbd679282b1ffc47987d24c3a1346Bob Halley で設定した時間が過ぎると、親プロセスも終了します。
5d51e67c3b4f35c1be742574aacc1d88fe6ed444Mark Andrews シグナルが送信され強制的に終了されます。</p>
bb556a9bf3a15c7160fa4f1b71773ce12b1bedf6Bob Halley <p>"graceful" 状態の場合 <code>TERM</code> シグナルを受け取ると、
64e41159a919b0711321fe688ca5da4f4d1b7d80Bob Halley 親プロセスも子プロセスもすぐに終了します。しかしながら
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley <code class="directive"><a href="/mod/mpm_common.html#pidfile">PidFile</a></code>
1471a520e59ac12b413afa8d8b3158a87af97aa6Bob Halley <div class="note"><p><code>graceful-stop</code> を使うとまったく同一に設定された
<p><code class="program"><a href="/programs/rotatelogs.html">rotatelogs</a></code> 形式のパイプを使ったログといった、
<p><span>言語: </span><a href="/de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<p class="apache">Copyright 2010 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="/mod/">モジュール</a> | <a href="/mod/directives.html">ディレクティブ</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">用語</a> | <a href="/sitemap.html">サイトマップ</a></p></div>