From: Eric Covener <covener@apache.org>
Date: Fri, 6 Feb 2015 15:14:57 +0000 (+0000)
Subject: Merge r1657854, r1657856 from trunk:
X-Git-Tag: 2.2.30~184
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b48ff91f74e84ebc8c868ddae9aa5f990f0e451c;p=thirdparty%2Fapache%2Fhttpd.git

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

diff --git a/docs/manual/logs.xml b/docs/manual/logs.xml
index 8d438e3e436..3cf9aede057 100644
--- a/docs/manual/logs.xml
+++ b/docs/manual/logs.xml
@@ -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">
diff --git a/docs/manual/platform/windows.xml b/docs/manual/platform/windows.xml
index c38550b7e0b..e09eb16d68e 100644
--- a/docs/manual/platform/windows.xml
+++ b/docs/manual/platform/windows.xml
@@ -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>