Answer

Overview

This documents is a guide to making ClearDDTS run in Native FastCGI mode (Option 3 of the webconfigure command) with the Apache 1.3.x web server. Please note that other web servers and Apache in DSO mode are not covered here. If the Native FastCGI module is already built into your Apache installation, please skip to the next section on Configuring the Apache web server for Native FastCGI.

Rebuilding the Apache web server to use the FastCGI module

The FastCGI module is not bundled by default with the Apache web server. Please follow the steps below to recompile the Apache web server with the FastCGI module:

1. Obtain a copy of the source code for Apache 1.3.x at http://www.apache.org . We will be using Apache version 1.3.27 as an example here.
   
   
2. Obtain a copy of the FastCGI module (mod_fastcgi) source code at http://www.fastcgi.com
   
   
3. Uncompress and untar the Apache source code and read the documentation for Apache. E.g.
   
% gunzip apache_1.3.27.tar.gz
% tar xvf apache_1.3.27.tar

   
   ... will untar to ./apache_1.3.27/
   
   
4. Uncompress and untar the mod_fastcgi source code, then read the documentation for mod_fastcgi.
   
% gunzip mod_fastcgi-2.2.12.tar.gz
% tar xvf mod_fastcgi-2.2.12.tar

   
   ... will untar to ./mod_fastcgi-2.2.12/
   
   
5. Relocate the mod_fastcgi module source tree into the Apache source tree to facilitate building. (This is optional if you are familiar with 'configur[e]'ing and 'mak[e]'ing builds). E.g.:
   
mv mod_fastcgi-2.2.12 apache_1.3.27/src/modules/fastcgi

   
   
6. Configure and build Apache with the following options:
   
--prefix={apache_home} --activate-module={path/to/fastcgi/}libfastcgi.a

   
   E.g. If you want apache to install in /opt/http_server and you followed step 5 above,
   
% sh
$ ./configure --prefix=/opt/http_server --activate-module=src/modules/fastcgi/libfastcgi.a --server-uid=www
--server-gid=www
$ make
$ su root
Password:
# make install

   
   
   Note: You have to make sure that a C compiler and the 'make' utility is in your $PATH environment variable when running the above commands.
   
   
7. By now, you should have successfully built and installed a copy of the Apache web server with the FastCGI module statically linked to the httpd binary. The command $APACHEHOME/bin/httpd -l would return all modules built into the httpd binary and you should see mod_fastcgi as one of them.
   
   
   Configuring the Apache web server for Native FastCGI
   
   
   Modify the Apache configuration file, $APACHEHOME/conf/httpd.conf as follows.
   
   Note that only the relevant section of the Apache configuration file, $APACHEHOME/conf/httpd.conf is listed below. Please refer to the mod_fastcgi documentation at http://www.fastcgi.com/mod_fastcgi/docs/mod_fastcgi.html for more info.
   
<IfModule mod_alias.c>

Alias /wt/ "/opt/ddts/wt/"
Alias /ddts/ "/opt/ddts/www/"
Alias /all-bin/ "/opt/ddts/allbinaries/"

FastCgiIpcDir /tmp
# Starts off and maintains 3 processes of wt_perl/ddts_main
FastCgiServer /opt/ddts/www/ddts_main -processes 3 -idle-timeout 120

<Directory "/opt/ddts/www">
AllowOverride None
SetHandler fastcgi-script
Options FollowSymLinks
</Directory>

<Directory "/opt/ddts/wt">
AllowOverride None
Options FollowSymLinks
</Directory>

# Other configurations go here

</IfModule>

   
   The next steps require you to make changes to the ClearDDTS installation. Please refer to Technote 1132292 for more information.