dgaudet 97/04/30 15:57:50
Modified: htdocs/manual stopping.html Log: Document the problem of config file errors. Revision Changes Path 1.5 +18 -0 apache/htdocs/manual/stopping.html Index: stopping.html =================================================================== RCS file: /export/home/cvs/apache/htdocs/manual/stopping.html,v retrieving revision 1.4 retrieving revision 1.5 diff -C3 -r1.4 -r1.5 *** stopping.html 1997/04/27 07:45:00 1.4 --- stopping.html 1997/04/30 22:57:47 1.5 *************** *** 52,57 **** --- 52,61 ---- will notice that the server statistics are set to zero when a <code>HUP</code> is sent. + <p><b>Note:</b> 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. + <h3>USR1 Signal: graceful restart</h3> <p><b>Note:</b> prior to release 1.2b9 this code is quite unstable and *************** *** 96,101 **** --- 100,119 ---- 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. + + <p><b>Note:</b> 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. At present the only work + around is to check the syntax of your files before doing a restart. The + easiest way is to just run 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. <h3>Appendix: signals and race conditions</h3>