Commit 3a98307f authored by Eric Covener's avatar Eric Covener
Browse files

Merge r1657854, r1657856 from trunk:

PR57094: Provide some hints about Windows problems 
with more than a few dozen piped loggers.

Submitted by: Edward Lu



add a generic tuning section and linked to the piped logger
issue in logs.html



git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x@1657859 13f79535-47bb-0310-9956-ffa450edef68
parent b7c3013a
Loading
Loading
Loading
Loading
+12 −4
Original line number Diff line number Diff line
@@ -506,10 +506,6 @@
    for the access log, the same technique can be used for the
    error log.</p>

    <p>A similar but much more flexible log rotation program
    called <a href="http://www.cronolog.org/">cronolog</a>
    is available at an external site.</p>

    <p>As with conditional logging, piped logs are a very powerful
    tool, but they should not be used where a simpler solution like
    off-line post-processing is available.</p>
@@ -529,6 +525,18 @@
      CustomLog "||/usr/local/apache/bin/rotatelogs
      /var/log/access_log 86400" common
    </example>

    <note><title>Windows note</title>
    <p>Note that on Windows, you may run into problems when running many piped
    logger processes, especially when HTTPD is running as a service. This is
    caused by running out of desktop heap space. The desktop heap space given
    to each service is specified by the third argument to the
    <code>SharedSection</code> parameter in the
    HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\SessionManager\SubSystems\Windows
    registry value. <strong>Change this value with care</strong>; the normal
    caveats for changing the Windows registry apply, but you might also exhaust
    the desktop heap pool if the number is adjusted too high.</p>
    </note>
  </section>

  <section id="virtualhost">
+9 −0
Original line number Diff line number Diff line
@@ -801,4 +801,13 @@
  above.</p>
  </section>

  <section id="tuning">
    <title>Windows Tuning</title>
    <ul>
      <li><p>If more than a few dozen piped loggers are used on an operating system 
      instance is necesar, scaling up the "desktop heap" is often necessary. For
      more detailed information, refer to the <a href="../logs.html#piped"
      >piped logging</a> documntation.</p></li>
    </ul>
  </section>
</manualpage>