home *** CD-ROM | disk | FTP | other *** search
/ PC World 2003 May / PCWorld_2003-05_cd.bin / Komunik / apache / apache_2.0.45-win32-x86-no_ssl.msi / Data.Cab / F233083_fdlimits.html.en < prev    next >
Extensible Markup Language  |  2003-03-30  |  6KB  |  121 lines
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
  4.         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  5.               This file is generated from xml source: DO NOT EDIT
  6.         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  7.       -->
  8. <title>File Descriptor Limits - Apache HTTP Server</title>
  9. <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10. <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11. <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12. <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13. <body id="manual-page"><div id="page-header">
  14. <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
  15. <p class="apache">Apache HTTP Server Version 2.0</p>
  16. <img alt="" src="../images/feather.gif" /></div>
  17. <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
  18. <div id="path">
  19. <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.0</a> > <a href="./">Virtual Hosts</a></div><div id="page-content"><div id="preamble"><h1>File Descriptor Limits</h1>
  20.  
  21.     <p>When using a large number of Virtual Hosts, Apache may run
  22.     out of available file descriptors (sometimes called <cite>file
  23.     handles</cite>) if each Virtual Host specifies different log
  24.     files. The total number of file descriptors used by Apache is
  25.     one for each distinct error log file, one for every other log
  26.     file directive, plus 10-20 for internal use. Unix operating
  27.     systems limit the number of file descriptors that may be used
  28.     by a process; the limit is typically 64, and may usually be
  29.     increased up to a large hard-limit.</p>
  30.  
  31.     <p>Although Apache attempts to increase the limit as required,
  32.     this may not work if:</p>
  33.  
  34.     <ol>
  35.       <li>Your system does not provide the <code>setrlimit()</code>
  36.       system call.</li>
  37.  
  38.       <li>The <code>setrlimit(RLIMIT_NOFILE)</code> call does not
  39.       function on your system (such as Solaris 2.3)</li>
  40.  
  41.       <li>The number of file descriptors required exceeds the hard
  42.       limit.</li>
  43.       
  44.       <li>Your system imposes other limits on file descriptors,
  45.       such as a limit on stdio streams only using file descriptors
  46.       below 256. (Solaris 2)</li>
  47.     </ol>
  48.  
  49.     <p>In the event of problems you can:</p>
  50.  
  51.     <ul>
  52.       <li>Reduce the number of log files; don't specify log files
  53.       in the <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
  54.       sections, but only log to the main log files. (See <a href="#splitlogs">Splitting up your log files</a>, below, for more
  55.       information on doing this.)</li>
  56.  
  57.       <li>
  58.         If you system falls into 1 or 2 (above), then increase the
  59.         file descriptor limit before starting Apache, using a
  60.         script like
  61.  
  62.         <div class="example"><p><code>
  63.           <code>#!/bin/sh<br />
  64.            ulimit -S -n 100<br />
  65.            exec httpd</code>
  66.         </code></p></div>
  67.       </li>
  68.     </ul>
  69.  
  70.     <p>Please see the <a href="../misc/descriptors.html">Descriptors and Apache</a>
  71.     document containing further details about file descriptor
  72.     problems and how they can be solved on your operating
  73.     system.</p>
  74.  
  75. </div>
  76. <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  77. <div class="section">
  78. <h2><a name="splitlogs" id="splitlogs">Splitting up your log files</a></h2>
  79.  
  80. <p>If you want to log multiple virtual hosts to the same log file, you
  81. may want to split up the log files afterwards in order to run
  82. statistical analysis of the various virtual hosts. This can be
  83. accomplished in the following manner.</p>
  84.  
  85. <p>First, you will need to add the virtual host information to the log
  86. entries. This can be done using the <code class="directive"><a href="../mod/mod_log_config.html# logformat">
  87. LogFormat</a></code>
  88. directive, and the <code>%v</code> variable. Add this to the beginning
  89. of your log format string:</p>
  90.  
  91. <div class="example"><p><code>
  92. LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost<br />
  93. CustomLog logs/multiple_vhost_log vhost
  94. </code></p></div>
  95.  
  96. <p>This will create a log file in the common log format, but with the
  97. canonical virtual host (whatever appears in the
  98. <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> directive) prepended to
  99. each line. (See <code class="directive"><a href="../mod/mod_log_config.html#custom log formats">Custom Log Formats</a></code> for
  100. more about customizing your log files.)</p>
  101.  
  102. <p>When you wish to split your log file into its component parts (one
  103. file per virtual host) you can use the program <code><a href="../programs/other.html">split-logfile</a></code> to accomplish
  104. this. You'll find this program in the <code>support</code> directory
  105. of the Apache disribution.</p>
  106.  
  107. <p>Run this program with the command:</p>
  108.  
  109. <div class="example"><p><code>
  110. split-logfile < /logs/multiple_vhost_log
  111. </code></p></div>
  112.  
  113. <p>This program, when run with the name of your vhost log file, will
  114. generate one file for each virtual host that appears in your log file.
  115. Each file will be called <code>hostname.log</code>.</p>
  116.  
  117. </div></div>
  118. <div id="footer">
  119. <p class="apache">Maintained by the <a href="http://httpd.apache.org/docs-project/">Apache HTTP Server Documentation Project</a></p>
  120. <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
  121. </body></html>