You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by co...@apache.org on 2015/02/06 16:13:06 UTC
svn commit: r1657858 - in /httpd/httpd/branches/2.4.x/docs/manual: logs.xml
platform/windows.xml
Author: covener
Date: Fri Feb 6 15:13:05 2015
New Revision: 1657858
URL: http://svn.apache.org/r1657858
Log:
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
Modified:
httpd/httpd/branches/2.4.x/docs/manual/logs.xml
httpd/httpd/branches/2.4.x/docs/manual/platform/windows.xml
Modified: httpd/httpd/branches/2.4.x/docs/manual/logs.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/logs.xml?rev=1657858&r1=1657857&r2=1657858&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/logs.xml (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/logs.xml Fri Feb 6 15:13:05 2015
@@ -594,10 +594,6 @@ LogFormat "%!200,304,302{Referer}i" refe
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>
@@ -618,6 +614,18 @@ CustomLog "|$/usr/local/apache/bin/rotat
For compatibility reasons with Apache 2.2 the notation
"<code>||</code>" is also supported and equivalent to using
"<code>|</code>".</p>
+
+ <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">
Modified: httpd/httpd/branches/2.4.x/docs/manual/platform/windows.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/platform/windows.xml?rev=1657858&r1=1657857&r2=1657858&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/platform/windows.xml (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/platform/windows.xml Fri Feb 6 15:13:05 2015
@@ -628,4 +628,13 @@ Alias /images/ //imagehost/www/images/
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>