cvs commit: apache/htdocs/manual stopping.html

[Dean Gaudet <dg...@hyperreal.com>]

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>