blob: 983cd74a3a7b11e17070f09e6f8887b3a1ed3678 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
|
<?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head><!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>停止と再起動 - Apache HTTP サーバ</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/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.3</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 サーバ</a> > <a href="http://httpd.apache.org/docs/">ドキュメンテーション</a> > <a href="./">バージョン
2.3</a></div><div id="page-content"><div id="preamble"><h1>停止と再起動</h1>
<div class="toplang">
<p><span>言語: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/stopping.html" 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ürkçe"> tr </a></p>
</div>
<p>この文書では Unix に類似したシステムでの
Apache の停止と再起動について扱っています。
Windows NT, 2000, XP ユーザは<a href="platform/windows.html#winsvc">サービスとして
Apache を実行する</a>で、Windows 9x, MEユーザは<a href="platform/windows.html#wincons">コンソールアプリケーションとして
Apache を実行する</a>で、
これらのプラットホームでの使用方法をご覧下さい。</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">イントロダクション</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#term">急な停止</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#graceful">緩やかな再起動</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#hup">急な再起動</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#gracefulstop">緩やかな停止</a></li>
</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>
<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">イントロダクション</a></h2>
<p>Apache を停止したり再起動したりするためには、実行されている
<code class="program"><a href="./programs/httpd.html">httpd</a></code> プロセスにシグナルを送る必要があります。
シグナルを送るには二つの方法があります。
一つ目はプロセスに直接シグナルを送る unix の <code>kill</code>
コマンドを使用する方法です。
システムを見ればたくさんの <code class="program"><a href="./programs/httpd.html">httpd</a></code> が
実行されているのに気が付くでしょうが、シグナルを送るのは
親プロセスだけで、それ以外の個々のプロセスには
シグナルを送らないで下さい。その親プロセスの pid は
<code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>
に書かれています。これはつまり、親以外のプロセスに
シグナルを送る必要すらない、ということです。
親プロセスに送ることができる 4 種類のシグナルがあります:
<code><a href="#term">TERM</a></code>,
<code><a href="#hup">HUP</a></code>,
<code><a href="#graceful">USR1</a></code>,
<code><a href="#gracefulstop">WINCH</a></code>
です。これらの説明については続きをご覧下さい。</p>
<p>親プロセスにシグナルを送るには、
次のようなコマンドを発行して下さい:</p>
<div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div>
<p><code class="program"><a href="./programs/httpd.html">httpd</a></code> プロセスにシグナルを送る 2 番目の方法は
<code>-k</code> というコマンドライン引数を使用することです。
下で説明されているように、<code>stop</code>, <code>restart</code>,
<code>graceful</code>, <code>graceful-stop</code> を指定できます。
これらは <code class="program"><a href="./programs/httpd.html">httpd</a></code> の引数ですが、
制御用のスクリプト <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> はそれらの引数をそのまま
<code class="program"><a href="./programs/httpd.html">httpd</a></code> に渡します。</p>
<p><code class="program"><a href="./programs/httpd.html">httpd</a></code> にシグナルを送った後、
実行状況を次のコマンドで読むことができます:</p>
<div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div>
<p>ここに挙げた例は、各自の
<code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code>
と
<code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>
の設定に適合するように適宜修正して下さい。</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">急な停止</a></h2>
<dl><dt>シグナル: TERM</dt>
<dd><code>apachectl -k stop</code></dd>
</dl>
<p><code>TERM</code> あるいは <code>stop</code>
シグナルを親プロセスに送ると、即座に子プロセス全てを kill しようとします。
子プロセスを完全に kill し終わるまでに数秒かかるかもしれません。
その後、親プロセス自身が終了します。
処理中のリクエストは全て停止され、もはやリクエストに対する
応答はされません。</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">緩やかな再起動</a></h2>
<dl><dt>シグナル: USR1</dt>
<dd><code>apachectl -k graceful</code></dd>
</dl>
<p>親プロセスは <code>USR1</code> あるいは <code>graceful</code>
シグナルを受け取ると、子プロセスに現在のリクエストの処理の後に終了する
(あるいは何もしていなければすぐに終了する)
ように<em>助言</em>します。
親プロセスは設定ファイルを再読込して、ログファイルを開き直します。
子プロセスが徐々になくなるに従って、
新しい<em>世代</em>の設定による子プロセスに置き換えていきます。
そして、これらが新たなリクエストに即座に応答し始めます。</p>
<p>このコードは常に
MPM のプロセス制御ディレクティブの設定を重視しますので、
クライアントのリクエストを扱うプロセスとスレッドの数を再起動の処理中も
適切な値に維持されます。。また、次のようにして
<code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code>
を守ります:
少なくとも 1 秒後に <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> 個の新しい子プロセスが
生成されていなければ、その数になるように適宜プロセスを生成します。
この挙動は現在の負荷に対して適切な子プロセスの数と
<code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> パラメータでの
希望の数の両方を維持しようとしています。</p>
<p><code class="module"><a href="./mod/mod_status.html">mod_status</a></code> を
使用している場合は、<code>USR1</code> シグナルが送られた際に
サーバ統計がゼロに<strong>設定されない</strong>ことに
注意してください。
サーバが新しいリクエストに応答不能な時間を最小にするように
(リクエストは OS によってキューに追加されるので絶対に紛失はしません)、
また同時に、希望のチューニングパラメータを守るように
コードは書かれています。
このようにするために、世代をまたがった全子プロセスの追跡に使われている
<em>スコアボード</em>を維持しなければなりません。</p>
<p>status モジュールは、緩やかな再起動以前から開始して
リクエストに応答し続けている子プロセスを特定するために、
<code>G</code> を使うこともします。</p>
<p>現在、<code>USR1</code> を使うログ移動スクリプトでは、
再起動前の子プロセスがログを書き終わったことを確証する方法が
ありません。古いログに対して何かする前に、
<code>USR1</code> シグナルを送った後いくらか適当な時間待つことを
提案します。例えば、帯域の狭い通信路のユーザのリクエストのほとんどが 10
分以下で完了しているということが分かっていれば、
古いログに何かする前に 15 分待つということです。</p>
<div class="note"><p>再起動が発行されると設定ファイルの構文チェックがまず走り、
設定ファイルに (構文上の) 誤りがないかチェックされます。
誤りがあった場合エラーメッセージでその旨が示され、サーバは再起動されません。
こうすることでサーバが終了しているけれども再起動できないという状況を
防ぎ、サーバが機能不全な状態になるのを防いでいます。</p>
<p>ただしこれでもサーバが正しく再起動することは保証されません。
設定ファイルの意味的な内容を構文と同様に検証したい場合は、
非 root ユーザで <code class="program"><a href="./programs/httpd.html">httpd</a></code> を起動しようとすればわかります。
もしエラーがなければ、ソケットやログを開こうとして
root でないため
(もしくは実行中の <code class="program"><a href="./programs/httpd.html">httpd</a></code>
が既に必要なポートにバインドしているため)
に失敗するでしょう。
これ以外の理由で起動に失敗したのであれば、
それは設定ファイルのエラーで、
緩やかな再起動を行う前にその誤りを修正しなければなりません。</p>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="hup" id="hup">急な再起動</a></h2>
<dl><dt>シグナル: HUP</dt>
<dd><code>apachectl -k restart</code></dd>
</dl>
<p><code>HUP</code> あるいは <code>restart</code> シグナルを親プロセスに送ると、
<code>TERM</code> と同様に子プロセスを kill しますが、
親プロセスは終了しません。
設定ファイルを再読込して、ログファイル全てを開き直します。
その後、新しい子プロセスを起動して応答を続けます。</p>
<p><code class="module"><a href="./mod/mod_status.html">mod_status</a></code>
を使っている場合は、<code>HUP</code> が送られた場合に
サーバ統計がゼロに設定されることに注意してください。</p>
<div class="note">graceful 再起動時は、再起動前に構文チェックが行われます。
もし構文エラーがあればその旨が示され、再起動は行われません。</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="gracefulstop" id="gracefulstop">緩やかな停止</a></h2>
<dl><dt>Signal: WINCH</dt>
<dd><code>apachectl -k graceful-stop</code></dd>
</dl>
<p><code>WINCH</code> や <code>graceful-stop</code> シグナルを受け取ると、
親プロセスは子プロセスに現在処理中のリクエストの後に終了する
(あるいは処理中のものが何もなければ直ちに終了する)
ように<em>アドバイス</em>します。
その後親プロセスは <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>
を削除し、ポートでの Listen を全て停止します。
親プロセスはどの子プロセスがリクエスト処理中かを監視し続けています。
全ての子プロセスが終了するか
<code class="directive"><a href="./mod/mpm_common.html#gracefulshutdowntimeout">GracefulShutdownTimeout</a></code>
で設定した時間が過ぎると、親プロセスも終了します。
タイムアウトに達した場合、残りの子プロセスには <code>TERM</code>
シグナルが送信され強制的に終了されます。</p>
<p>"graceful" 状態の場合 <code>TERM</code> シグナルを受け取ると、
親プロセスも子プロセスもすぐに終了します。しかしながら
<code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>
が削除されてしまっているので、<code>apachectl</code>
や <code>httpd</code> にこのシグナルを送ることはできません。</p>
<div class="note"><p><code>graceful-stop</code> を使うとまったく同一に設定された
複数の <code class="program"><a href="./programs/httpd.html">httpd</a></code> を同時に実行することができます。
Apache を緩やかにアップグレードするのにはとても便利ですが、
設定ファイルによってはデッドロックやレースコンディションを
引き起こすこともあります。</p>
<p>ディスク上のファイルを使うもの、たとえば
<code class="directive"><a href="./mod/core.html#lockfile">Lockfile</a></code> や
<code class="directive"><a href="./mod/mod_cgid.html#scriptsock">ScriptSock</a></code>
のファイルなどはサーバの PID を含めて管理されていて、
共存できるよう注意が払われています。
しかしその他設定ディレクティブやサードパーティ製のモジュール、
CGI ユーティリティのパーシステント層などで
ディスク上にロックファイルや状態管理ファイルを
使っている場合は、実行されている複数の <code class="program"><a href="./programs/httpd.html">httpd</a></code>
が互いに衝突しないように気をつけなければなりません。</p>
<p><code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code> 形式のパイプを使ったログといった、
その他潜在的なレースコンディションについても注意しなければなりません。
複数の <code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code> が同じファイルを同時に
rotate しようとすると、互いにログファイルを破壊してしまいます。</p>
</div>
</div></div>
<div class="bottomlang">
<p><span>言語: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/stopping.html" 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ürkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2009 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>
</body></html>
|