$Id: README.APACHE,v 1.5 2002/12/14 09:53:55 reuteler Exp $
webplay, reuteler@visi.com

== Introduction
== Sample webplay Apache Config

== Introduction

what follows is a basic sample configuration for webplay under apache.
it assumes that your layout follows the defaults in Configure.pl which 
are:

  docsurl: /webplay
  iconurl: /webplay/icons
   cgiurl: /webplay/cgi-bin
plscgiurl: /webplay/cgi-pls

  docsdir: /home/webplay/html
  icondir: /home/webplay/icons
   cgidir: /home/webplay/cgi-bin
plscgidir: /home/webplay/cgi-pls

and it also fulfills the requirements for md5 authentication.  this means
authentication will be turned and you will need a password.  if you need
to create the password file:

(assuming as later that the passwd file is /home/webplay/etc/passwd)

% su
$ htpasswd -c /home/webplay/etc/passwd reuteler
New password:
Re-type new password:
Adding password for user reuteler
$ htpasswd /home/webplay/etc/passwd guest
New password:
Re-type new password:
Adding password for user guest
$
...etc.

if you prefer that authentication not be used make all sections appear as the
definition for /home/webplay/cgi-pls (the second one), turn off md5_auth
in Configure.pl, rebuild and reinstall.  read also README.AUTH for more info
on md5 authentication.

at any rate, everyone needs to modify httpd.conf (usually located in either
/var/www/conf/httpd.conf or /etc/httpd/conf/httpd.conf).  drop what follows
after your other <Directory> definitions.  when you're done issue an

$ apachectl restart

== Sample webplay Apache Config

#
# webplay
# 
ScriptAlias /webplay/cgi-bin/ "/home/webplay/cgi-bin/"
ScriptAlias /webplay/cgi-pls/ "/home/webplay/cgi-pls/"
Alias       /webplay/icons/   "/home/webplay/icons/"
Alias       /webplay/         "/home/webplay/html/"

<Directory "/home/webplay/cgi-bin">
    Options None
    AllowOverride None
    AuthType Basic
    AuthUserFile "/home/webplay/etc/passwd"
    AuthName "webplay"
    Require valid-user
</Directory>

<Directory "/home/webplay/cgi-pls">
    Options None
    AllowOverride None
    Order allow,deny
    Allow from all
</Directory>

<Directory "/home/webplay/icons">
    Options None
    AllowOverride None
    AuthType Basic
    AuthUserFile /home/webplay/etc/passwd
    AuthName "webplay"
    Require valid-user
</Directory>

<Directory "/home/webplay/html">
    Options None
    AllowOverride None
    AuthType Basic
    AuthUserFile /home/webplay/etc/passwd
    AuthName "webplay"
    Require valid-user
</Directory>