From: Yoshiki Hayashi Date: Wed, 10 Jul 2002 07:01:02 +0000 (+0000) Subject: Oops. I don't know why but these files weren't committed at previous attempt. X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=d64b4a277d4a2c5360b873f429b133fd6fce2195;p=apache Oops. I don't know why but these files weren't committed at previous attempt. New Japanese translation. Submitted by: Hiroaki KAWAI Reviewed by: Yoshiki Hayashi git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@95999 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/stopping.html b/docs/manual/stopping.html deleted file mode 100644 index 628c40403b..0000000000 --- a/docs/manual/stopping.html +++ /dev/null @@ -1,209 +0,0 @@ - - - - - - - Stopping and Restarting the Server - - - - - - -

Stopping and Restarting the Server

- -

This document covers stopping and restarting Apache on - Unix-like systems. Windows users should see Signalling Apache when - running.

- -

You will notice many httpd executables running - on your system, but you should not send signals to any of them - except the parent, whose pid is in the PidFile. That is to say you - shouldn't ever need to send signals to any process except the - parent. There are three signals that you can send the parent: - TERM, HUP, and USR1, - which will be described in a moment.

- -

To send a signal to the parent you should issue a command - such as:

- -

-    kill -TERM `cat /usr/local/apache/logs/httpd.pid`
-

- You can read about its progress by issuing: - -

-    tail -f /usr/local/apache/logs/error_log
-

- Modify those examples to match your ServerRoot and PidFile settings. - -

A shell script called apachectl is provided which - automates the processing of signalling Apache. For details - about this script, see the documentation on starting Apache.

- -

Stop Now

- -

Signal: TERM
- apachectl stop

- -

Sending the TERM 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.

- -

Graceful Restart

- -

Signal: USR1
- apachectl graceful

- -

The USR1 signal causes the parent process to - advise 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 generation of - the configuration, which begins serving new requests - immediately.

- On certain platforms that do not allow USR1 to be used for a - graceful restart, an alternative signal may be used (such as - WINCH). apachectl graceful will send the right signal for your - platform. - -

This code is designed to always respect the MaxClients, MinSpareServers, - and MaxSpareServers - settings. Furthermore, it respects StartServers in the - following manner: if after one second at least StartServers new - children have not been created, then create enough to pick up - the slack. This is to say that the code tries to maintain both - the number of children appropriate for the current load on the - server, and respect your wishes with the StartServers - parameter.

- -

Users of the status module - will notice that the server statistics are not - set to zero when a USR1 is sent. The code was - written to both minimize the time in which the server is unable - to serve new requests (they will be queued up by the operating - system, so they're not lost in any event) and to respect your - tuning parameters. In order to do this it has to keep the - scoreboard used to keep track of all children across - generations.

- -

The status module will also use a G to indicate - those children which are still serving requests started before - the graceful restart was given.

- -

At present there is no way for a log rotation script using - USR1 to know for certain that all children writing - the pre-restart log have finished. We suggest that you use a - suitable delay after sending the USR1 signal - before you do anything with the old log. For example if most of - your hits take less than 10 minutes to complete for users on - low bandwidth links then you could wait 15 minutes before doing - anything with the old log.

- -

Note: If your configuration file has errors - in it when you issue a restart then your parent will not - restart, it will exit with an error. In the case of graceful - restarts it will also leave children running when it exits. - (These are the children which are "gracefully exiting" by - handling their last request.) This will cause problems if you - attempt to restart the server -- it will not be able to bind to - its listening ports. Before doing a restart, you can check the - syntax of the configuration files with the -t - command line argument (see httpd). This still will not - guarantee that the server will restart correctly. To check the - semantics of the configuration files as well as the syntax, you - can try starting httpd as a non-root user. If there are no - errors it will attempt to open its sockets and logs and fail - because it's not root (or because the currently running httpd - already has those ports bound). If it fails for any other - reason then it's probably a config file error and the error - should be fixed before issuing the graceful restart.

- -

Restart Now

- -

Signal: HUP
- apachectl restart

- -

Sending the HUP signal to the parent causes it - to kill off its children like in TERM but the - parent doesn't exit. It re-reads its configuration files, and - re-opens any log files. Then it spawns a new set of children - and continues serving hits.

- -

Users of the status module - will notice that the server statistics are set to zero when a - HUP is sent.

- -

Note: If your configuration file has errors - in it when you issue a restart then your parent will not - restart, it will exit with an error. See below for a method of - avoiding this.

- -

Appendix: signals and race conditions

- -

Prior to Apache 1.2b9 there were several race - conditions involving the restart and die signals (a simple - description of race condition is: a time-sensitive problem, as - in if something happens at just the wrong time it won't behave - as expected). For those architectures that have the "right" - feature set we have eliminated as many as we can. But it should - be noted that there still do exist race conditions on certain - architectures.

- -

Architectures that use an on disk ScoreBoardFile have the - potential to corrupt their scoreboards. This can result in the - "bind: Address already in use" (after HUP) or - "long lost child came home!" (after USR1). The - former is a fatal error, while the latter just causes the - server to lose a scoreboard slot. So it might be advisable to - use graceful restarts, with an occasional hard restart. These - problems are very difficult to work around, but fortunately - most architectures do not require a scoreboard file. See the ScoreBoardFile - documentation for a architecture uses it.

- -

NEXT and MACHTEN (68k only) have - small race conditions which can cause a restart/die signal to - be lost, but should not cause the server to do anything - otherwise problematic. - -

- -

All architectures have a small race condition in each child - involving the second and subsequent requests on a persistent - HTTP connection (KeepAlive). It may exit after reading the - request line but before reading any of the request headers. - There is a fix that was discovered too late to make 1.2. In - theory this isn't an issue because the KeepAlive client has to - expect these events because of network latencies and server - timeouts. In practice it doesn't seem to affect anything either - -- in a test case the server was restarted twenty times per - second and clients successfully browsed the site without - getting broken images or empty documents. - -

- - - diff --git a/docs/manual/stopping.html.ja.jis b/docs/manual/stopping.html.ja.jis new file mode 100644 index 0000000000..e4f416bc1d --- /dev/null +++ b/docs/manual/stopping.html.ja.jis @@ -0,0 +1,220 @@ + + + + + + $BDd;_$H:F5/F0(B + + + + + + + +

$B%5!<%P$NDd;_$H:F5/F0(B

+ +

$B$3$NJ8=q$G$O(B Unix $B$KN`;w$7$?%7%9%F%`$G$N(B + Apache $B$NDd;_$H:F5/F0$K$D$$$F07$C$F$$$^$9!#(BWindows + $B%f!<%6(B (Windows $B$G(B Apache $B$r;H$&>l9g(B) $B$O!"(B$B$B$b$4Mw2<$5$$!#(B

+ +

$B$?$/$5$s$Nhttpd $B$,%7%9%F%`>e$G(B + $BPidFile + $B$K=q$+$l$F$$$^$9!#$3$l$O$D$^$j!"?F0J30$N%W%m%;%9$K(B + $B%7%0%J%k$rAw$kI,MW$9$i$J$$!"$H$$$&$3$H$G$9!#(B + $B?F%W%m%;%9$KAw$k$3$H$,$G$-$k(B 3 $BTERM, HUP, USR1 + $B$G$9!#$3$l$i$N@bL@$K$D$$$F$OB3$-$r$4Mw2<$5$$!#(B

+ +

$B?F%W%m%;%9$K%7%0%J%k$rAw$k$K$O!"(B + $B + +

+    kill -TERM `cat /usr/local/apache/logs/httpd.pid`
+

+ $B$3$l$Nu67$O +

+    tail -f /usr/local/apache/logs/error_log
+

+ + $B$3$3$K5s$2$?Nc$O!"3F<+$N(B + ServerRoot + $B$H(B + PidFile + $B$N@_Dj$KE,9g$9$k$h$&$KE,59=$@5$7$F2<$5$$!#(B + +

apachectl + $B$H8F$P$l$k%7%'%k%9%/%j%W%H$G!"(BApache $B$K%7%0%J%k$rAw$k\:Y$K4X$7$F$O!"(B + Apache $B$N5/F0(B$B$NJ8=q$r$4Mw2<$5$$!#(B

+ +

$B5^$JDd;_(B

+ +

$B%7%0%J%k(B: TERM
+ apachectl stop

+ +

TERM $B%7%0%J%k$r?F%W%m%;%9$KAw$k$H!"(B + $BB(:B$K;R%W%m%;%9A4$F$r(B kill $B$7$h$&$H$7$^$9!#(B + $B;R%W%m%;%9$r40A4$K(B kill $B$7=*$o$k$^$G$K?tIC$+$+$k$+$b$7$l$^$;$s!#(B + $B$=$N8e!"?F%W%m%;%9<+?H$,=*N;$7$^$9!#(B + $B=hM}Cf$N%j%/%(%9%H$OA4$FDd;_$5$l!"$b$O$d%j%/%(%9%H$KBP$9$k(B + $B1~Ez$O$5$l$^$;$s!#(B

+ +

$B4K$d$+$J:F5/F0(B

+ +

$B%7%0%J%k(B: USR1
+ apachectl graceful

+ +

$B?F%W%m%;%9$O(B USR1 $B%7%0%J%k$r$B=u8@(B$B$7$^$9!#(B + $B?F%W%m%;%9$O@_Dj%U%!%$%k$r:FFI9~$7$F!"%m%0%U%!%$%k$r3+$-D>$7$^$9!#(B + $B;R%W%m%;%9$,=y!9$K$J$/$J$k$K=>$C$F!"(B + $B?7$7$$(B$B@$Be(B$B$N@_Dj$K$h$k;R%W%m%;%9$KCV$-49$($F$$$-$^$9!#(B + $B$=$7$F!"$3$l$i$,?7$?$J%j%/%(%9%H$KB(:B$K1~Ez$7;O$a$^$9!#(B

+ $BFCDj$N%W%i%C%H%[!<%`$G$O(B USR1 $B$r4K$d$+$J:F5/F0$N$?$a$K(B + $B;H$&$3$H$,$G$-$^$;$s$,!"Be$o$j$N%7%0%J%k(B + ($BNc$($P(B WINCH) $B$,;HMQ$G$-$k$G$7$g$&!#(B + apachectl graceful + $B$H$$$&%3%^%s%I$O%W%i%C%H%[!<%`$K9g$C$?%7%0%J%k$rAw$j$^$9!#(B + +

$B$3$N%3!<%I$O>o$K(B + MaxClients, + MinSpareServers, + MaxSpareServers + $B$N@_Dj$r=E;k$7$^$9!#$^$?!"StartServers + $B$r/$J$/$H$b(B 1 $BIC8e$K(B StartServers $B8D$N?7$7$$;R%W%m%;%9$,(B + $B@8@.$5$l$F$$$J$1$l$P!"$=$N?t$K$J$k$h$&$KE,59%W%m%;%9$r@8@.$7$^$9!#(B + $B$3$N5sF0$O8@$C$F$_$l$P!"8=:_$NIi2Y$KBP$7$FE,@Z$J;R%W%m%;%9$N?t$H(B + StartServers $B%Q%i%a!<%?$G$N4uK>$N?t$NN>J}$r0];}$7$h$&$H(B + $B$7$F$$$k$H$$$($k$G$7$g$&!#(B

+ +

status $B%b%8%e!<%k(B$B$r(B + $B;HMQ$7$F$$$k>l9g$O!"(BUSR1 $B%7%0%J%k$,Aw$i$l$?:]$K(B + $B%5!<%PE}7W$,%<%m$K(B$B@_Dj$5$l$J$$(B$B$3$H$K(B + $BCm0U$7$F$/$@$5$$!#(B + $B%5!<%P$,?7$7$$%j%/%(%9%H$K1~EzITG=$J;~4V$r:G>.$K$9$k$h$&$K(B + ($B%j%/%(%9%H$O(B OS $B$K$h$C$F%-%e!<$KDI2C$5$l$k$N$G@dBP$KJ6<:$O$7$^$;$s(B)$B!"(B + $B$^$?F1;~$K!"4uK>$N%A%e!<%K%s%0%Q%i%a!<%?$r$B%9%3%"%\!<%I(B$B$r0];}$7$J$1$l$P$J$j$^$;$s!#(B

+ +

status $B%b%8%e!<%k$O!"4K$d$+$J:F5/F00JA0$+$i3+;O$7$F(B + $B%j%/%(%9%H$K1~Ez$7B3$1$F$$$k;R%W%m%;%9$rFCDj$9$k$?$a$K!"(B + G $B$r;H$&$3$H$b$7$^$9!#(B

+ +

$B8=:_!"(BUSR1 $B$r;H$&%m%00\F0%9%/%j%W%H$G$O!"(B + $B:F5/F0A0$N;R%W%m%;%9$,%m%0$r=q$-=*$o$C$?$3$H$r3N>Z$9$kJ}K!$,(B + $B$"$j$^$;$s!#8E$$%m%0$KBP$7$F2?$+$9$kA0$K!"(B + USR1 $B%7%0%J%k$rAw$C$?8e$$$/$i$+E,Ev$J;~4VBT$D$3$H$r(B + $BDs0F$7$^$9!#Nc$($P!"BS0h$N69$$DL?.O)$N%f!<%6$N%j%/%(%9%H$N$[$H$s$I$,(B 10 + $BJ,0J2<$G40N;$7$F$$$k$H$$$&$3$H$,J,$+$C$F$$$l$P!"(B + $B8E$$%m%0$K2?$+$9$kA0$K(B 15 $BJ,BT$D$H$$$&$3$H$G$9!#(B

+ +

$BCm0U(B: $B:F5/F0;~$K@_Dj%U%!%$%k$K8m$j$,$"$k$H!"(B + $B?F%W%m%;%9$O:F5/F0$;$:$K%(%i!<$H$H$b$K=*N;$7$^$9!#(B + $B4K$d$+$J:F5/F0$N>l9g$O!"?F%W%m%;%9$,=*N;$7$?8e$G$b;R%W%m%;%9$,(B + $B-t + $B%3%^%s%I%i%$%s0z?t(B + (httpd $B$r$4Mw2<$5$$(B) + $B$r;H$C$F8!>Z$9$k$3$H$,$G$-$^$9!#(B + $B@_Dj%U%!%$%k$N0UL#E*$JFbMF$r9=J8$HF1MM$K8!>Z$7$?$$>l9g$O!"(B + $BHs(B root $B%f!<%6$G(B httpd $B$r5/F0$7$h$&$H$9$l$P$o$+$j$^$9!#(B + $B$b$7%(%i!<$,$J$1$l$P!"%=%1%C%H$d%m%0$r3+$3$&$H$7$F(B + root $B$G$J$$$?$a(B + ($B$b$7$/$O(B httpd $B$,4{$KI,MW$J%]!<%H$K%P%$%s%I$7$F$$$k$?$a(B) + $B$K<:GT$9$k$G$7$g$&!#(B + $B$3$l0J30$NM}M3$G5/F0$K<:GT$7$?$N$G$"$l$P!"(B + $B$=$l$O@_Dj%U%!%$%k$N%(%i!<$G!"(B + $B4K$d$+$J:F5/F0$r9T$&A0$K$=$N8m$j$r=$@5$7$J$1$l$P$J$j$^$;$s!#(B

+ +

$B5^$J:F5/F0(B

+ +

$B%7%0%J%k(B: HUP
+ apachectl restart

+ +

HUP $B%7%0%J%k$r?F%W%m%;%9$KAw$k$H!"(B + TERM $B$HF1MM$K;R%W%m%;%9$r(B kill $B$7$^$9$,!"(B + $B?F%W%m%;%9$O=*N;$7$^$;$s!#(B + $B@_Dj%U%!%$%k$r:FFI9~$7$F!"%m%0%U%!%$%kA4$F$r3+$-D>$7$^$9!#(B + $B$=$N8e!"?7$7$$;R%W%m%;%9$r5/F0$7$F1~Ez$rB3$1$^$9!#(B

+ +

status $B%b%8%e!<%k(B + $B$r;H$C$F$$$k>l9g$O!"(BHUP $B$,Aw$i$l$?>l9g$K(B + $B%5!<%PE}7W$,%<%m$K@_Dj$5$l$k$3$H$KCm0U$7$F$/$@$5$$!#(B

+ +

$BCm0U(B: $B:F5/F0;~$K@_Dj%U%!%$%k$K8m$j$,$"$k$H!"(B + $B?F%W%m%;%9$O:F5/F0$;$:$K%(%i!<$H$H$b$K=*N;$7$^$9!#(B + $B$3$l$rHr$1$k$K$O + +

$BIUO?(B: $B%7%0%J%k$H6%9g>uBV(B

+ +

Apache 1.2b9 $B0JA0$O!":F5/F0$dDd;_$N%7%0%J%k$r4^$`(B$B6%9g>uBV(B + ($B6%9g>uBV$r4JC1$K@bL@$9$k$H(B: $B%?%$%_%s$K%0$h$kLdBj$G!"(B + $B6q9g$N0-$$;~4VBS$K$A$g$&$I2?$+$,5/$3$k$HM=A[30$NF0:n$r$9$k(B + $B$h$&$J$3$H$r;X$7$^$9(B) $B$,$"$j$^$7$?!#(B + $B!V@5$7$$!W5!G=$r;}$C$F$$$k%"!<%-%F%/%A%c$G$O!"$G$-$k$@$1(B + $B$3$N$h$&$J$3$H$,5/$3$i$J$$$h$&$K$7$F$$$^$9!#(B + $B$7$+$7!"$"$kuBV$OL$$@3N + +

$B%G%#%9%/>e$G(B + ScoreBoardFile + $B$r;HMQ$7$F$$$k%"!<%-%F%/%A%c$G$O!"(B + $B@x:_E*$K%9%3%"%\!<%I$,2u$l$k2DG=@-$,$"$j$^$9!#(B + $B%9%3%"%\!<%I$,2u$l$?>l9g$O!"(B + "bind: Address already in use" (HUP $B8e(B) $B$d(B + "long lost child came home!" (USR1 $B8e(B) + $B$H$$$C$?7k2L$K$J$j$^$9!#(B + $BA0o$KFq$7$$$N$G$9$,!"(B + $B9,$$$J$3$H$KBgItJ,$N%"!<%-%F%/%A%c$G$O%9%3%"%\!<%I$N%U%!%$%k$OI,MW$"$j$^$;$s!#(B + $B$3$l$r;HMQ$9$k%"!<%-%F%/%A%c$O!"(B + ScoreBoardFile + $B$r$4Mw2<$5$$!#(B

+ +

NEXT $B$d(B MACHTEN (68k $B$N$_(B) + $B$O!":F5/F0$H=*N;$N%7%0%J%k$r<:$&$h$&$J>.$5$J6%9g>uBV$r;}$C$F$$$^$9$,!"(B + $B$=$NB>$KLdBj$K$J$k$h$&$J$3$H$r%5!<%P$K5Z$\$9$3$H$O$"$j$^$;$s!#(B + +

+ +

$BA4$F$N%"!<%-%F%/%A%c$K$*$$$F!"8D!9$N;R%W%m%;%9$G(B + $B7QB3E*$J(B HTTP $B%3%M%/%7%g%s(B (KeepAlive) + $B$K4X$9$k>.$5$J6%9g>uBV$,5/$3$j$($^$9!#(B + $B%j%/%(%9%H9T$rFI$s$@8e!"$=$7$F%j%/%(%9%H%X%C%@$rFI$`A0$K(B + $B;R%W%m%;%9$O=*N;$9$k$+$bCN$l$^$;$s!#(B + $B$3$l$KBP$9$k=$@5$,$"$j$^$9$,(B 1.2 $B$G=$@5$9$k$K$OH/8+$,CY$9$.$^$7$?!#(B + $BM}O@E*$K$O!"$3$l$OLdBj$G$O$"$j$^$;$s!#(B + $B$J$<$J$i(B KeepAlive $B$N%/%i%$%"%s%H$O!"%M%C%H%o!<%/CY1d$d(B + $B%5!<%P$N%?%$%`%"%&%H$J$I$KHw$($F$$$J$1$l$P$J$i$J$$$+$i$G$9!#(B + $Bo$K1\Mw$G$-$F$$$^$9!#(B

+ + + +

Stopping and Restarting the Server

Stop Now

Graceful Restart

Restart Now

Appendix: signals and race conditions

$B%5!<%P$NDd;_$H:F5/F0(B

$B5^$JDd;_(B

$B4K$d$+$J:F5/F0(B

$B5^$J:F5/F0(B

$BIUO?(B: $B%7%0%J%k$H6%9g>uBV(B

$B%5!<%P$NDd;_$H:F5/F0(B

$B5^$JDd;_(B

$B4K$d$+$J:F5/F0(B

$B5^$J:F5/F0(B

$BIUO?(B: $B%7%0%J%k$H6%9g>uBV(B