File Descriptor Limits
When using a large number of Virtual Hosts, Apache may run out of available file descriptors (sometimes called file handles) 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.
Although Apache attempts to increase the limit as required, this may not work if:
- Your system does not provide the
setrlimit() system call. - The
setrlimit(RLIMIT_NOFILE) call does not function on your system (such as Solaris 2.3) - The number of file descriptors required exceeds the hard limit.
- Your system imposes other limits on file descriptors, such as a limit on stdio streams only using file descriptors below 256. (Solaris 2)
In the event of problems you can:
- Reduce the number of log files; don't specify log files in the
<VirtualHost> sections, but only log to the main log files. (See Splitting up your log files, below, for more information on doing this.) - If you system falls into 1 or 2 (above), then increase the file descriptor limit before starting Apache, using a script like
#!/bin/sh
ulimit -S -n 100
exec httpd
Splitting up your log files
If you want to log multiple virtual hosts to the same log file, youmay want to split up the log files afterwards in order to runstatistical analysis of the various virtual hosts. This can beaccomplished in the following manner.
First, you will need to add the virtual host information to the logentries. This can be done using the LogFormatdirective, and the %v variable. Add this to the beginningof your log format string:
LogFormat "%v %h %l %u %t "%r" %>s %b" vhost
CustomLog logs/multiple_vhost_log vhost
This will create a log file in the common log format, but with thecanonical virtual host (whatever appears in theServerName directive) prepended toeach line. (See Custom Log Formats formore about customizing your log files.)
When you wish to split your log file into its component parts (onefile per virtual host) you can use the program split-logfile to accomplishthis. You'll find this program in the support directoryof the Apache distribution.
Run this program with the command:
split-logfile < /logs/multiple_vhost_log
This program, when run with the name of your vhost log file, willgenerate one file for each virtual host that appears in your log file.Each file will be called hostname.log.
