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