User Guide

Chapter 1: Installing and Configuring ColdFusion 21
Adding the ColdFusion module to Apache 1.3.x
You can find the ColdFusion module in the installation directory (usually /opt) under
the
coldfusion/webserver/apache directory. The pre-built module shipped with
ColdFusion 4.5 is built with Apache 1.3.6. This module will not work with earlier
versions of Apache 1.3.x, and it may not work with later versions if the Apache Group
changes the MODULE_MAGIC_NUMBER_MAJOR (src src/include/ap_mmn.h in the
Apache source).
Note The module has been tested with Apache 1.3.9.
If you have a C compiler (gcc or SUN cc) available, you can build a version of
mod_coldfusion.so which should work with any versionof Apache 1.3.
To configure and add the ColdFusion module:
In order for the Apache httpd to load the ColdFusion module at startup time, you must
have configured the
mod_so module. This module is not built into Apache by default. If
necessary, consult the Apache documentation for details (README.DSO).
Configure this module into the Apache build by running the following command:
$ ./configure --enable-module=so <other apache options>
$ make
$ make install
If you are using gcc to compile Apache, you should include the following environment
variables for configure:
$ env LIBS=/usr/lib/libC.so.5 CFLAGS=-fPIC \
./configure --enable-module=so <other apache options>
Once you have mod_so configured in to your Apache binary, the simplest way to
configure the ColdFusion module is to use the apxs program that is included in the
Apache distribution. It is installed by default in <apachedir>/apache/bin. This is a
perl script, so you must have perl installed on your system. Perl is freely available at
http://www.perl.com.
To use the apxs program:
1. Ensure that perl is available in /usr/local/bin/perl.
Also, make sure a C compiler is in your PATH.
2. Add the
apache/bin directory to your path:
csh:
set path=($path /usr/ccs/bin /usr/local/apache/bin)
sh/ksh:
PATH=$PATH:/usr/ccs/bin:/usr/local/apache/bin
export PATH
3. Change to the apache/src directory in the ColdFusion installation.
cd /opt/coldfusion/webserver/apache/src