----------------------------------------------------------------------

  README for Apache/mod_perl configuration files

  Lyris Technologies, Inc.  12/22/99

----------------------------------------------------------------------


CONTENTS
  1. Introduction
  2. Main configuration files
  3. Template files
  4. Additional information on perl, Apache and mod_perl


1. Introduction
---------------

   This file describes gives a brief overview of the web server
   included with the Lyris installation.  This version of Lyris
   includes an Apache web server, preconfigured with mod_perl
   support.  Mod_perl greatly improves the speed of the Lyris web
   interface by allowing it to keep the web interface perl program
   pre-compiled, and in memory.  

   The Apache configuration shipped with Lyris should work without
   modificaiton.  For those who are curious, however, the purposes of
   the individual configuration files are described below.  Pointers
   to additional information on perl, Apache, and mod_perl are
   included at the end of this document.


2. Main configuration files
---------------------------

    httpd.conf        The main apache configuration file for use under
                      Windows NT.

    httpd.conf.unix   The main apache configuration file for use under unix.
  
    shared.conf       Shared configuration directives, used under both
                      Windows and unix

    mime.types        File that defines typical translations between
                      file name extensions and MIME content types

    local.conf        Configuration file with definitions specific to
                      your installation.  Most things are determined
                      automatically when the server initializes, so
                      this file generally includes only the definition
                      of your server's port.  This file is generated
                      automatically from "local.conf.tmpl" durring
                      installation. 


3. Template files
-----------------
    local.conf.tmpl           Template file for local configuration
                              directives.  

    httpd.conf.noperl.tmpl    Template configuration file without
                              mod_perl support.  Use this only if
                              mod_perl is not functioning properly on
                              your machine.
                            
                              WINDOWS USERS: copy this file to
                              "httpd.conf", and edit it to suit your
                              installation.  Be sure to save the
                              original "httpd.conf" file first!! 

                              UNIX USERS: copy this file to
                              "httpd.conf.noperl", and edit it to suit
                              your installation.
                            


4. Additional information on perl, Apache, and mod_perl
------------------------------------------------------

   Perl, Apache and mod_perl are free software, which we have included
   for the convenience of our customers.  As such, Lyris Technologies,
   Inc. cannot warranty or gaurantee the correct operation of these
   products.  Specific license and warantee information for Apache and
   perl is included in this directory in the files LICENSE.apache and
   LICENSE.perl, respectively.  Mod_perl is covered under the same
   license as Apache. 

   General information about using perl can be found at www.perl.org.
   Information about perl libraries and extension packages is at
   www.cpan.org.

   The main source of information on Apache is at www.apache.org.
   Specific information about Apache configuration file directives can
   be found at http://www.apache.org/docs/.

   Mod_perl information is available from perl.apache.org.

