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 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.