home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 November / CMCD1104.ISO / Software / Complet / Apache / apache_2.0.52-win32-x86-no_ssl.msi / Data.Cab / F278660_fdlimits.xml < prev    next >
Extensible Markup Language  |  2004-04-17  |  5KB  |  130 lines
  1. <?xml version='1.0' encoding='UTF-8' ?>
  2. <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
  3. <?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
  4. <!-- $Revision: 1.4.2.6 $ -->
  5.  
  6. <!--
  7.  Copyright 2002-2004 The Apache Software Foundation
  8.  
  9.  Licensed under the Apache License, Version 2.0 (the "License");
  10.  you may not use this file except in compliance with the License.
  11.  You may obtain a copy of the License at
  12.  
  13.      http://www.apache.org/licenses/LICENSE-2.0
  14.  
  15.  Unless required by applicable law or agreed to in writing, software
  16.  distributed under the License is distributed on an "AS IS" BASIS,
  17.  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  18.  See the License for the specific language governing permissions and
  19.  limitations under the License.
  20. -->
  21.  
  22. <manualpage metafile="fd-limits.xml.meta">
  23. <parentdocument href="./">Virtual Hosts</parentdocument>
  24.   <title>File Descriptor Limits</title>
  25.  
  26. <summary>
  27.  
  28.     <p>When using a large number of Virtual Hosts, Apache may run
  29.     out of available file descriptors (sometimes called <cite>file
  30.     handles</cite>) if each Virtual Host specifies different log
  31.     files. The total number of file descriptors used by Apache is
  32.     one for each distinct error log file, one for every other log
  33.     file directive, plus 10-20 for internal use. Unix operating
  34.     systems limit the number of file descriptors that may be used
  35.     by a process; the limit is typically 64, and may usually be
  36.     increased up to a large hard-limit.</p>
  37.  
  38.     <p>Although Apache attempts to increase the limit as required,
  39.     this may not work if:</p>
  40.  
  41.     <ol>
  42.       <li>Your system does not provide the <code>setrlimit()</code>
  43.       system call.</li>
  44.  
  45.       <li>The <code>setrlimit(RLIMIT_NOFILE)</code> call does not
  46.       function on your system (such as Solaris 2.3)</li>
  47.  
  48.       <li>The number of file descriptors required exceeds the hard
  49.       limit.</li>
  50.       
  51.       <li>Your system imposes other limits on file descriptors,
  52.       such as a limit on stdio streams only using file descriptors
  53.       below 256. (Solaris 2)</li>
  54.     </ol>
  55.  
  56.     <p>In the event of problems you can:</p>
  57.  
  58.     <ul>
  59.       <li>Reduce the number of log files; don't specify log files
  60.       in the <directive type="section" module="core">VirtualHost</directive>
  61.       sections, but only log to the main log files. (See <a
  62.       href="#splitlogs">Splitting up your log files</a>, below, for more
  63.       information on doing this.)</li>
  64.  
  65.       <li>
  66.         If you system falls into 1 or 2 (above), then increase the
  67.         file descriptor limit before starting Apache, using a
  68.         script like
  69.  
  70.         <example>
  71.           <code>#!/bin/sh<br />
  72.            ulimit -S -n 100<br />
  73.            exec httpd</code>
  74.         </example>
  75.       </li>
  76.     </ul>
  77.  
  78.     <p>Please see the <a
  79.     href="../misc/descriptors.html">Descriptors and Apache</a>
  80.     document containing further details about file descriptor
  81.     problems and how they can be solved on your operating
  82.     system.</p>
  83.  
  84. </summary>
  85.  
  86. <section id="splitlogs"><title>Splitting up your log files</title>
  87.  
  88. <p>If you want to log multiple virtual hosts to the same log file, you
  89. may want to split up the log files afterwards in order to run
  90. statistical analysis of the various virtual hosts. This can be
  91. accomplished in the following manner.</p>
  92.  
  93. <p>First, you will need to add the virtual host information to the log
  94. entries. This can be done using the <directive module="mod_log_config">
  95. LogFormat</directive>
  96. directive, and the <code>%v</code> variable. Add this to the beginning
  97. of your log format string:</p>
  98.  
  99. <example>
  100. LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost<br />
  101. CustomLog logs/multiple_vhost_log vhost
  102. </example>
  103.  
  104. <p>This will create a log file in the common log format, but with the
  105. canonical virtual host (whatever appears in the
  106. <directive module="core">ServerName</directive> directive) prepended to
  107. each line. (See <directive
  108. module="mod_log_config">Custom Log Formats</directive> for
  109. more about customizing your log files.)</p>
  110.  
  111. <p>When you wish to split your log file into its component parts (one
  112. file per virtual host) you can use the program <code><a
  113. href="../programs/other.html">split-logfile</a></code> to accomplish
  114. this. You'll find this program in the <code>support</code> directory
  115. of the Apache distribution.</p>
  116.  
  117. <p>Run this program with the command:</p>
  118.  
  119. <example>
  120. split-logfile < /logs/multiple_vhost_log
  121. </example>
  122.  
  123. <p>This program, when run with the name of your vhost log file, will
  124. generate one file for each virtual host that appears in your log file.
  125. Each file will be called <code>hostname.log</code>.</p>
  126.  
  127. </section>
  128. </manualpage>
  129.  
  130.