# ==================================================================
# Gossamer Forum - Advanced web community
#
#   Website  : http://gossamer-threads.com/
#   Support  : http://gossamer-threads.com/scripts/support/
#   CVS Info :                     
#   Revision : $Id: README.mod_perl,v 1.3 2002/04/11 02:16:44 jagerman Exp $
#
# Copyright (c) 2002 Gossamer Threads Inc.  All Rights Reserved.
# Redistribution in part or in whole strictly prohibited. Please
# see LICENSE file for full details.
# ==================================================================

Gossamer Forum works best under mod_perl. mod_perl is open source software that
integrates perl inside of Apache. You can find out more details about mod_perl
at:

    http://perl.apache.org/guide/

Running mod_perl typically requires your own dedicated server. Gossamer Threads
can provide you with pre-configured Gossamer Forum installations running under
mod_perl. If you are interested in this, please send us an email at
hosting@gossamer-threads.com.

To setup Gossamer Forum using mod_perl, you need to:

1. First, install Gossamer Forum as described in the README.

2. Now, add the following section to your httpd.conf file:

    <Location /url/to/gforum>
        SetHandler perl-script
        PerlHandler Apache::Registry
	PerlSendHeader On
	Options +ExecCGI
    </Location>

You need to change '/url/to/gforum' to the URL where the user cgi script is
located. The URL should start with a / and be set from your document root, but
does not contain your domain name. For example, if your scripts were at:

    http://gossamer-threads.com/perl/gforum/gforum.cgi

You would put: <Location /perl/gforum> in your httpd.conf file.

3. Most mod_perl installations have a startup file for loading perl scripts you
are using when httpd is started. You need to add the following to your startup
file:

    use lib '/full/path/to/admin';
    require GForum::mod_perl;

where '/full/path/to/admin' is a full system path to your admin directory.

If you don't have a startup file, you should create one by adding to
your httpd.conf file:

    PerlRequire /path/to/startup.pl

and adding the above lines into startup.pl.

Congratulations, you are now done! When you restart mod_perl you should see:

    Preloading Gossamer Forum modules into mod_perl:
             . . . . . . . . . . .
    All modules loaded ok!
    Compiling all functions ... All modules compiled and loaded ok!

That means everything has been pre-loaded and you are ready to go!

If you have any questions or problems, please visit our support section at:

    http://gossamer-threads.com/support/

Gossamer Threads Inc.