INSTALL.Apache

Installing FastCGI Support and ScriptRunner for Apache

Prerequisites:

1. Pike 7.6 or higher

2. libfcgi from http://www.fastcgi.com

3. Public.Web.FCGI from http://www.siriushosting.com/pike/fastcgi.html

Installation:

1. Download mod_fastcgi for Apache from http://www.fastcgi.com.

2. Install mod_fastcgi. Instructions for doing this are included with 
  mod_fastcgi.

3. Add the ExecCGI option to the directory that contains scriptrunner:

<Directory ...>
Options ... ExecCGI
</Directory>

4. Add the mod_fastcgi configuration parameters:

 <IfModule mod_fastcgi.c>
     FastCgiIpcDir /tmp
     AddHandler fastcgi-script fcgi
 </IfModule>

5. Run the ScriptRunner configure script, optionally passing 
--prefix and --with-pike options.

6. Install the application by running "make install"

7. Create a symbolic link (if necessary) from the installed 
ScriptRunner.fcgi to a location within your webserver's document root (not 
necessary for all types of installation. Whether or not you need to do 
this will be determined by your FastCGI configuration.

8. You may want to use mod_rewrite to rewrite incoming requests 
or mod_actions to trigger ScriptRunner to process your pike scripts.

I use the following rewrite rules (more or less):

RewriteRule (.*.pike) /ScriptRunner.fcgi$1 [L]
RewriteRule (.*.psp) /ScriptRunner.fcgi$1 [L]


Note that there are many configuration options for mod_fastcgi, and these 
are only a suggestion (and perhaps not a good one at that!) Comments and 
suggestions are welcome.