Listing 9.1. continued

# ServerAdmin: Your address, where problems with the server should be

# e-mailed.



ServerAdmin you@your.address



# ServerRoot: The directory the server's config, error, and log files

# are kept in



ServerRoot /etc/httpd



# BindAddress: You can support virtual hosts with this option. This option

# is used to tell the server which IP address to listen to. It can either

# contain "*", an IP address, or a fully qualified Internet domain name.

# See also the VirtualHost directive.



#BindAddress *



# ErrorLog: The location of the error log file. If this does not start

# with /, ServerRoot is prepended to it.



ErrorLog logs/error_log



# TransferLog: The location of the transfer log file. If this does not

# start with /, ServerRoot is prepended to it.



TransferLog logs/access_log



# PidFile: The file the server should log its pid to

PidFile logs/httpd.pid



# ScoreBoardFile: File used to store internal server process information

ScoreBoardFile logs/apache_status



# ServerName allows you to set a host name which is sent back to clients for

# your server if it's different than the one the program would get (i.e. use

# "www" instead of the host's real name).

#

# Note: You cannot just invent host names and hope they work. The name you

# define here must be a valid DNS name for your host. If you don't understand

# this, ask your network administrator.



#ServerName new.host.name



# CacheNegotiatedDocs: By default, Apache sends Pragma: no-cache with each

# document that was negotiated on the basis of content. This asks proxy

# servers not to cache the document. Uncommenting the following line disables

# this behavior, and proxies will be allowed to cache the documents.



#CacheNegotiatedDocs



# Timeout: The number of seconds before receives and sends time out

#  n.b. the compiled default is 1200 (20 minutes !)



Timeout 400

# KeepAlive: The number of Keep-Alive persistent requests to accept

# per connection. Set to 0 to deactivate Keep-Alive support



KeepAlive 5



# KeepAliveTimeout: Number of seconds to wait for the next request



KeepAliveTimeout 15



# Server-pool size regulation.  Rather than making you guess how many

# server processes you need, Apache dynamically adapts to the load it

# sees --- that is, it tries to maintain enough server processes to

# handle the current load, plus a few spare servers to handle transient

# load spikes (e.g., multiple simultaneous requests from a single

# Netscape browser).



# It does this by periodically checking how many servers are waiting

# for a request.  If there are fewer than MinSpareServers, it creates

# a new spare.  If there are more than MaxSpareServers, some of the

# spares die off.  These values are probably OK for most sites ---



MinSpareServers 5

MaxSpareServers 10



# Number of servers to start --- should be a reasonable ballpark figure.



StartServers 5



# Limit on total number of servers running, i.e., limit on the number

# of clients who can simultaneously connect --- if this limit is ever

# reached, clients will be LOCKED OUT, so it should NOT BE SET TOO LOW.

# It is intended mainly as a brake to keep a runaway server from taking

# Unix with it as it spirals down...



MaxClients 150



# MaxRequestsPerChild: the number of requests each child process is

#  allowed to process before the child dies.

#  The child will exit so as to avoid problems after prolonged use when

#  Apache (and maybe the libraries it uses) leak.  On most systems, this

#  isn't really needed, but a few (such as Solaris) do have notable leaks

#  in the libraries.



MaxRequestsPerChild 30



# Proxy Server directives. Uncomment the following line to

# enable the proxy server:



#ProxyRequests On



# To enable the cache as well, edit and uncomment the following lines:



#CacheRoot /usr/local/etc/httpd/proxy

#CacheSize 5

#CacheGcInterval 4

#CacheMaxExpire 24

#CacheLastModifiedFactor 0.1

                                                                 continues

Listing 9.1. continued

#CacheDefaultExpire 1

#NoCache adomain.com anotherdomain.edu joes.garage.com



# Listen: Allows you to bind Apache to specific IP addresses and/or

# ports, in addition to the default. See also the VirtualHost command



#Listen 3000

#Listen 12.34.56.78:80



# VirtualHost: Allows the daemon to respond to requests for more than one

# server address, if your server machine is configured to accept IP packets

# for multiple addresses. This can be accomplished with the ifconfig

# alias flag, or through kernel patches like VIF.



# Any httpd.conf or srm.conf directive may go into a VirtualHost command.

# See also the BindAddress entry.



#<VirtualHost host.foo.com>

#ServerAdmin webmaster@host.foo.com

#DocumentRoot /www/docs/host.foo.com

#ServerName host.foo.com

#ErrorLog logs/host.foo.com-error_log

#TransferLog logs/host.foo.com-access_log

#</VirtualHost>

Listing 9.2 shows the resource configuration file.

Listing 9.2. conf/srm.conf.

# With this document, you define the name space that users see of your http

# server.  This file also defines server settings which affect how requests are

# serviced, and how results should be formatted.



# See the tutorials at http://www.apache.org/ for

# more information.



# Originally by Rob McCool; Adapted for Apache



# DocumentRoot: The directory out of which you will serve your

# documents. By default, all requests are taken from this directory, but

# symbolic links and aliases may be used to point to other locations.



DocumentRoot /home/httpd/html



# UserDir: The name of the directory which is appended onto a user's home

# directory if a ~user request is received.



UserDir public_html



# DirectoryIndex: Name of the file or files to use as a pre-written HTML

# directory index.  Separate multiple entries with spaces.



DirectoryIndex index.html

# FancyIndexing is whether you want fancy directory indexing or standard



FancyIndexing on



# AddIcon tells the server which icon to show for different files or filename

# extensions



AddIconByEncoding (CMP,/icons/compressed.gif) x-compress x-gzip



AddIconByType (TXT,/icons/text.gif) text/*

AddIconByType (IMG,/icons/image2.gif) image/*

AddIconByType (SND,/icons/sound2.gif) audio/*

AddIconByType (VID,/icons/movie.gif) video/*



AddIcon /icons/binary.gif .bin .exe

AddIcon /icons/binhex.gif .hqx

AddIcon /icons/tar.gif .tar

AddIcon /icons/world2.gif .wrl .wrl.gz .vrml .vrm .iv

AddIcon /icons/compressed.gif .Z .z .tgz .gz .zip

AddIcon /icons/a.gif .ps .ai .eps

AddIcon /icons/layout.gif .html .shtml .htm .pdf

AddIcon /icons/text.gif .txt

AddIcon /icons/c.gif .c

AddIcon /icons/p.gif .pl .py

AddIcon /icons/f.gif .for

AddIcon /icons/dvi.gif .dvi

AddIcon /icons/uuencoded.gif .uu

AddIcon /icons/script.gif .conf .sh .shar .csh .ksh .tcl

AddIcon /icons/tex.gif .tex

AddIcon /icons/bomb.gif core



AddIcon /icons/back.gif ..

AddIcon /icons/hand.right.gif README

AddIcon /icons/folder.gif ^^DIRECTORY^^

AddIcon /icons/blank.gif ^^BLANKICON^^



# DefaultIcon is which icon to show for files which do not have an icon

# explicitly set.



DefaultIcon /icons/unknown.gif



# AddDescription allows you to place a short description after a file in

# server-generated indexes.

# Format: AddDescription "description" filename



# ReadmeName is the name of the README file the server will look for by

# default. Format: ReadmeName name

#

# The server will first look for name.html, include it if found, and it will

# then look for name and include it as plaintext if found.

#

# HeaderName is the name of a file which should be prepended to

# directory indexes.



ReadmeName README

HeaderName HEADER

                                                                  continues