← Back to branch summary

~ubuntu-branches/ubuntu/feisty/apache2/feisty

« back to all changes in this revision

Viewing changes to docs/manual/vhosts/fd-limits.html.en

  • Committer: Bazaar Package Importer
  • Author(s): Andreas Barth
  • Date: 2006-12-09 21:05:45 UTC
  • mfrom: (0.6.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20061209210545-h70s0xaqc2v8vqr2
Tags: 2.2.3-3.2
http://bugs.debian.org/396265
* Non-maintainer upload.
* 043_ajp_connection_reuse: Patch from upstream Bugzilla, fixing a critical
  issue with regard to connection reuse in mod_proxy_ajp.
  Closes: #396265

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/manual/vhosts/fd-limits.html.en
 
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" class="no-sidebar"><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.2</p>
 
16
<img alt="" src="../images/feather.gif" /></div>
 
17
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
 
18
<div id="path">
 
19
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.2</a> &gt; <a href="./">Virtual Hosts</a></div><div id="page-content"><div id="preamble"><h1>File Descriptor Limits</h1>
 
20
<div class="toplang">
 
21
<p><span>Available Languages: </span><a href="../en/vhosts/fd-limits.html" title="English">&nbsp;en&nbsp;</a> |
 
22
<a href="../fr/vhosts/fd-limits.html" hreflang="fr" rel="alternate" title="Fran�ais">&nbsp;fr&nbsp;</a> |
 
23
<a href="../ja/vhosts/fd-limits.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 
24
<a href="../ko/vhosts/fd-limits.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 
25
</div>
 
26
 
 
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 <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
 
61
      sections, but only log to the main log files. (See <a href="#splitlogs">Splitting up your log files</a>, below, for more
 
62
      information on doing this.)</li>
 
63
 
 
64
      <li>
 
65
        If you system falls into 1 or 2 (above), then increase the
 
66
        file descriptor limit before starting Apache, using a
 
67
        script like
 
68
 
 
69
        <div class="example"><p><code>
 
70
          <code>#!/bin/sh<br />
 
71
           ulimit -S -n 100<br />
 
72
           exec httpd</code>
 
73
        </code></p></div>
 
74
      </li>
 
75
    </ul>
 
76
 
 
77
</div>
 
78
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 
79
<div class="section">
 
80
<h2><a name="splitlogs" id="splitlogs">Splitting up your log files</a></h2>
 
81
 
 
82
<p>If you want to log multiple virtual hosts to the same log file, you
 
83
may want to split up the log files afterwards in order to run
 
84
statistical analysis of the various virtual hosts. This can be
 
85
accomplished in the following manner.</p>
 
86
 
 
87
<p>First, you will need to add the virtual host information to the log
 
88
entries. This can be done using the <code class="directive"><a href="../mod/mod_log_config.html#&#10;logformat">
 
89
LogFormat</a></code>
 
90
directive, and the <code>%v</code> variable. Add this to the beginning
 
91
of your log format string:</p>
 
92
 
 
93
<div class="example"><p><code>
 
94
LogFormat "%v %h %l %u %t \"%r\" %&gt;s %b" vhost<br />
 
95
CustomLog logs/multiple_vhost_log vhost
 
96
</code></p></div>
 
97
 
 
98
<p>This will create a log file in the common log format, but with the
 
99
canonical virtual host (whatever appears in the
 
100
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> directive) prepended to
 
101
each line. (See <code class="directive"><a href="../mod/mod_log_config.html#custom log formats">Custom Log Formats</a></code> for
 
102
more about customizing your log files.)</p>
 
103
 
 
104
<p>When you wish to split your log file into its component parts (one
 
105
file per virtual host) you can use the program <code><a href="../programs/other.html">split-logfile</a></code> to accomplish
 
106
this. You'll find this program in the <code>support</code> directory
 
107
of the Apache distribution.</p>
 
108
 
 
109
<p>Run this program with the command:</p>
 
110
 
 
111
<div class="example"><p><code>
 
112
split-logfile &lt; /logs/multiple_vhost_log
 
113
</code></p></div>
 
114
 
 
115
<p>This program, when run with the name of your vhost log file, will
 
116
generate one file for each virtual host that appears in your log file.
 
117
Each file will be called <code>hostname.log</code>.</p>
 
118
 
 
119
</div></div>
 
120
<div class="bottomlang">
 
121
<p><span>Available Languages: </span><a href="../en/vhosts/fd-limits.html" title="English">&nbsp;en&nbsp;</a> |
 
122
<a href="../fr/vhosts/fd-limits.html" hreflang="fr" rel="alternate" title="Fran�ais">&nbsp;fr&nbsp;</a> |
 
123
<a href="../ja/vhosts/fd-limits.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 
124
<a href="../ko/vhosts/fd-limits.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 
125
</div><div id="footer">
 
126
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 
127
<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>
 
128
</body></html>
 
 
b'\\ No newline at end of file'