vhost.httpd.conf

## httpd.conf -- Apache HTTP server configuration file

# ServerType is either inetd, or standalone.  Inetd mode is only supported on
# Unix platforms.
ServerType standalone

# ServerRoot: The top of the directory tree under which the server's
# configuration, error, and log files are kept.
# Do NOT add a slash at the end of the directory path.
ServerRoot "/usr/local/apache"

LockFile /usr/local/apache_logs/httpd.lock
PidFile /usr/local/apache_logs/httpd.pid

# ScoreBoardFile: File used to store internal server process information.
# Not all architectures require this.  But if yours does (you'll know because
# this file will be  created when you run Apache) then you *must* ensure that
# no two invocations of Apache share the same scoreboard file.
ScoreBoardFile /usr/local/apache_logs/httpd.scoreboard

# Listen: Allows you to bind Apache to specific IP addresses and/or
# ports, in addition to the default. See also the <VirtualHost>
# directive.
ResourceConfig /etc/apache.listen

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

# KeepAlive: Whether or not to allow persistent connections (more than
KeepAlive Off

# MaxKeepAliveRequests: The maximum number of requests to allow
MaxKeepAliveRequests 100

# KeepAliveTimeout: Number of seconds to wait for the next request from the
# same client on the same connection.
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.  The default values are probably OK for most sites.
MinSpareServers 20
MaxSpareServers 20
StartServers 20

# MaxClients depends on max SQL connection limit to MySQL server times number
# of web servers (3) so we figure this number is limited to 60 - 70, any more
# causes "Internal Server errors" to pop up. We found that the SQL server
# is even happier with MaxClients 45 (SQL server load drops down to 2.5)
MaxClients 40

# We were getting "Callback and exit" mod_perl/apache hangups in error_log 
# so we turned down MaxRequestPerChild to 100 or less, and apache hangs less
# often. Rob is investigtaing the mod_perl_traps.pod file for advice on
# how to alleviate this condition.
MaxRequestsPerChild 150

# BindAddress: You can support virtual hosts with this option. This directive
# 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> and Listen directives.
#BindAddress *

# ExtendedStatus controls whether Apache will generate "full" status
# information (ExtendedStatus On) or just basic information (ExtendedStatus
# Off) when the "server-status" handler is called. The default is Off.
ExtendedStatus On

# Port: The port to which the standalone server listens. For
# ports < 1023, you will need httpd to be run as root initially.
Port 80

User nobody
Group nobody


# Each directory to which Apache has access, can be configured with respect
# to which services and features are allowed and/or disabled in that
# directory (and its subdirectories). 
# First, we configure the "default" to be a very restrictive set of 
# permissions.  
<Directory />
    Options FollowSymLinks
    AllowOverride None
</Directory>


# DirectoryIndex: Name of the file or files to use as a pre-written HTML
# directory index.  Separate multiple entries with spaces.
DirectoryIndex index.shtml index.html

# AccessFileName: The name of the file to look for in each directory
# for access control information.
AccessFileName .htaccess

# The following lines prevent .htaccess files from being viewed by
# Web clients.  Since .htaccess files often contain authorization
# information, access is disallowed for security reasons.  Comment
# these lines out if you want Web visitors to see the contents of
# .htaccess files.  If you change the AccessFileName directive above,
# be sure to make the corresponding changes here.
<Files .htaccess>
    Order allow,deny
    Deny from all
</Files>


# UseCanonicalName:  (new for 1.3)  With this setting turned on, whenever
# Apache needs to construct a self-referencing URL (a URL that refers back
# to the server the response is coming from) it will use ServerName and
# Port to form a "canonical" name.  With this setting off, Apache will
# use the hostname:port that the client supplied, when possible.  This
# also affects SERVER_NAME and SERVER_PORT in CGI scripts.
UseCanonicalName On

# TypesConfig describes where the mime.types file (or equivalent) is
# to be found.
TypesConfig /usr/local/apache/conf/mime.types

# DefaultType is the default MIME type the server will use for a document
# if it cannot otherwise determine one, such as from filename extensions.
# If your server contains mostly text or HTML documents, "text/plain" is
# a good value.  If most of your content is binary, such as applications
# or images, you may want to use "application/octet-stream" instead to
# keep browsers from trying to display binary files as though they are
# text.
DefaultType text/plain

# The mod_mime_magic module allows the server to use various hints from the
# contents of the file itself to determine its type.  The MIMEMagicFile
# directive tells the module where the hint definitions are located.
# mod_mime_magic is not part of the default server (you have to add
# it yourself with a LoadModule [see the DSO paragraph in the 'Global
# Environment' section], or recompile the server and include mod_mime_magic
# as part of the configuration), so it's enclosed in an <IfModule> container.
# This means that the MIMEMagicFile directive will only be processed if the
# module is part of the server.
<IfModule mod_mime_magic.c>
    MIMEMagicFile /usr/local/apache/conf/magic
</IfModule>

# HostnameLookups: Log the names of clients or just their IP addresses
# e.g., www.apache.org (on) or 204.62.129.132 (off).
# The default is off because it'd be overall better for the net if people
# had to knowingly turn this feature on, since enabling it means that
# each client request will result in AT LEAST one lookup request to the
# nameserver.
HostnameLookups Off

# ErrorLog: The location of the error log file.
# If you do not specify an ErrorLog directive within a <VirtualHost>
# container, error messages relating to that virtual host will be
# logged here.  If you *do* define an error logfile for a <VirtualHost>
# container, that host's errors will be logged there and not here.
#
ErrorLog /usr/local/apache_logs/error_log

# The following directives define some format nicknames for use with
# a CustomLog directive (see below).
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
LogFormat "%h %l %u %t \"%r\" %>s %b" common
LogFormat "%{Referer}i -> %U" referer
LogFormat "%{User-agent}i" agent

# LogLevel: Control the number of messages logged to the error_log.
# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
#
LogLevel warn

# The location and format of the access logfile (Common Logfile Format).
# If you do not define any access logfiles within a <VirtualHost>
# container, they will be logged here.  Contrariwise, if you *do*
# define per-<VirtualHost> access logfiles, transactions will be
# logged therein and *not* in this file.
#
CustomLog /usr/local/apache_logs/access_log common

# Optionally add a line containing the server version and virtual host
# name to server-generated pages (error documents, FTP directory listings,
# mod_status and mod_info output etc., but not CGI generated documents).
# Set to "EMail" to also include a mailto: link to the ServerAdmin.
# Set to one of:  On | Off | EMail
ServerSignature On

# Aliases: Add here as many aliases as you need (with no limit). The format is 
# Alias fakename realname
#
# Note that if you include a trailing / on fakename then the server will
# require it to be present in the URL.  So "/icons" isn't aliased in this
# example, only "/icons/"..
#
Alias /icons/ "/usr/local/apache/icons/"

<Directory "/usr/local/apache/icons">
    Options Indexes MultiViews
    AllowOverride None
    Order allow,deny
    Allow from all
</Directory>


# FancyIndexing is whether you want fancy directory indexing or standard
IndexOptions FancyIndexing

# AddIcon* directives tell the server which icon to show for different
# files or filename extensions.  These are only displayed for
# FancyIndexed directories.
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

# ReadmeName is the name of the README file the server will look for by
# default, and append to directory listings.
#
# HeaderName is the name of a file which should be prepended to
# directory indexes. 
#
# The server will first look for name.html and include it if found.
# If name.html doesn't exist, the server will then look for name.txt
# and include it as plaintext if found.
#
ReadmeName README
HeaderName HEADER

# IndexIgnore is a set of filenames which directory indexing should ignore
# and not include in the listing.  Shell-style wildcarding is permitted.
IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t

# AddEncoding allows you to have certain browsers (Mosaic/X 2.1+) uncompress
# information on the fly. Note: Not all browsers support this.
# Despite the name similarity, the following Add* directives have nothing
# to do with the FancyIndexing customization directives above.
AddEncoding x-compress Z
AddEncoding x-gzip gz

# AddLanguage allows you to specify the language of a document. You can
# then use content negotiation to give a browser a file in a language
# it can understand.  Note that the suffix does not have to be the same
# as the language keyword --- those with documents in Polish (whose
# net-standard language code is pl) may wish to use "AddLanguage pl .po" 
# to avoid the ambiguity with the common suffix for perl scripts.
AddLanguage en .en
AddLanguage fr .fr
AddLanguage de .de
AddLanguage da .da
AddLanguage el .el
AddLanguage it .it

# LanguagePriority allows you to give precedence to some languages
# in case of a tie during content negotiation.
# Just list the languages in decreasing order of preference.
LanguagePriority en fr de

# To use server-parsed HTML files
AddType text/html .shtml
AddHandler server-parsed .shtml

AddType text/html .inc
AddHandler server-parsed .inc
AddHandler perl-script .pl


ErrorDocument 404 /404.pl

# The following directives modify normal HTTP response behavior.
# The first directive disables keepalive for Netscape 2.x and browsers that
# spoof it. There are known problems with these browser implementations.
# The second directive is for Microsoft Internet Explorer 4.0b2
# which has a broken HTTP/1.1 implementation and does not properly
# support keepalive when it is used on 301 or 302 (redirect) responses.
#
BrowserMatch "Mozilla/2" nokeepalive
BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0

# The following directive disables HTTP/1.1 responses to browsers which
# are in violation of the HTTP/1.0 spec by not being able to grok a
# basic 1.1 response.
BrowserMatch "RealPlayer 4\.0" force-response-1.0
BrowserMatch "Java/1\.0" force-response-1.0
BrowserMatch "JDK/1\.0" force-response-1.0

# Allow server status reports, with the URL of http://servername/server-status
# Change the ".your_domain.com" to match your domain to enable.
<Location /server-status>
    SetHandler server-status
    Order deny,allow
    Deny from all
</Location>

# Allow remote server configuration reports, with the URL of
#  http://servername/server-info (requires that mod_info.c be loaded).
# Change the ".your_domain.com" to match your domain to enable.
<Location /server-info>
    SetHandler server-info
    Order deny,allow
    Deny from all
</Location>

#############################################
# MAIN SLASHCODE SPECIFIC STUFF STARTS HERE #
#############################################
# Check all the values below and edit them  #
# to suit your site                         #
#############################################

### Section 3: Virtual Hosts
# VirtualHost: If you want to maintain multiple domains/hostnames on your
# machine you can setup VirtualHost containers for them.
# Please see the documentation at <URL:http://www.apache.org/docs/vhosts/>
# for further details before you try to setup virtual hosts.
# You may use the command line option '-S' to verify your virtual host
# configuration.

# edit directory paths for each virtual host
<Directory /home/slash/public_html>
	Options FollowSymLinks ExecCGI Includes 
	AllowOverride None
	Order allow,deny
	Allow from all
</Directory>

# edit directory paths for each virtual host
<Directory /home/virtual1/public_html>
	Options FollowSymLinks ExecCGI Includes 
	AllowOverride None
	Order allow,deny
	Allow from all
</Directory>

# If you want to use name-based virtual hosts you need to define at
# least one IP address (and port number) for them.
NameVirtualHost 192.168.0.77 

<VirtualHost 192.168.0.77>

	# edit all of these values
	ServerAdmin admin@yoursite.com
	DocumentRoot /home/slash/public_html
	ServerName www.yoursite.com 
	ErrorLog /usr/local/apache_logs/slash-error_log
	CustomLog /usr/local/apache_logs/slash-access_log common

	# this is all the mod perl specific stuff that makes 
	# slash the root handler for the site
	PerlModule Apache::DBI
	PerlModule CGI
	PerlHandler Apache::Registry
	PerlSetupEnv On

	<Perl>
	# edit package name, so each virtual host has a unique one
	package Slash::Host::slash;

	BEGIN {
		$ENV{TZ} = 'GMT';  # just to be sure
	}

	# edit paths, and set your servername here as the hash key
	use lib '/home/slash';
	$Slash::home{'www.yoursite.com'} = '/home/slash';

	use Apache::SizeLimit;
	$Apache::SizeLimit::MAX_PROCESS_SIZE = 20000;

	use CGI;
	use DBI;
	use Date::Manip;

	sub rootHandler {
		my $r = shift;

		# make sure Date::Calc is initialised
		Date_Init();

		if ($ENV{HTTP_COOKIE} =~ /\b(?:user|session)\b/) {
			$r->internal_redirect("/index.pl");
		} else {
			require Slash;
			$r->internal_redirect("/index.shtml");
		}
	}

	1;

	</Perl>



	# edit package name to match one above
	<Location ~ "^/$">
		SetHandler "perl-script"
		PerlHandler Slash::Host::slash::rootHandler
	</Location>


	# Any Other Options
	LimitRequestBody 75000
	# PerlFreshRestart On

</VirtualHost>

<VirtualHost 192.168.0.77>

	# edit all of these values
	ServerAdmin virtual_admin@yoursite.com
	DocumentRoot /home/virtual1/public_html
	ServerName virtual1.yoursite.com 
	ServerAlias www.virtual1.yoursite.com
	ErrorLog /usr/local/apache_logs/virtual1-error_log
	CustomLog /usr/local/apache_logs/virtual1-access_log common

	# this is all the mod perl specific stuff that makes 
	# slash the root handler for the site
	PerlModule Apache::DBI
	PerlModule CGI
	PerlHandler Apache::Registry
	PerlSetupEnv On

	<Perl>
	# edit package name, so each virtual host has a unique one
	package Slash::Host::virtual1;

	BEGIN {
		$ENV{TZ} = 'GMT';  # just to be sure
	}

	# edit paths, and set your servername here as the hash key
	use lib '/home/virtual1';
	$Slash::home{'virtual1.yoursite.com'} = '/home/virtual1';

	use Apache::SizeLimit;
	$Apache::SizeLimit::MAX_PROCESS_SIZE = 20000;

	use CGI;
	use DBI;
	use Date::Manip;

	sub rootHandler {
		my $r = shift;

		# make sure Date::Calc is initialised
		Date_Init();

		if ($ENV{HTTP_COOKIE} =~ /\b(?:user|session)\b/) {
			$r->internal_redirect("/index.pl");
		} else {
			require Slash;
			$r->internal_redirect("/index.shtml");
		}
	}

	1;

	</Perl>



	# edit package name to match one above
	<Location ~ "^/$">
		SetHandler "perl-script"
		PerlHandler Slash::Host::virtual1::rootHandler
	</Location>


	# Any Other Options
	LimitRequestBody 75000
	# PerlFreshRestart On

</VirtualHost>