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

docs/manual/logs.xml

+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">

docs/manual/platform/windows.xml

+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>