User Guide

20 Administering ColdFusion Server
Configuring the Apache Web Server
ColdFusion has been tested with Apache version 1.2.x and 1.3. To obtain Apache free of
charge, go to the Apache Web site at
http://www.apache.org.
You can build the ColdFusion module into your Apache Web server binary. This
method is efficient because the server does not have to start a new process for every
ColdFusion request. This section describes:
• “Adding the ColdFusion module to Apache 1.2.x” on page 20
• “Adding the ColdFusion module to Apache 1.3.x” on page 21
Note If necessary, consult the Apache ReadMe file for additional information
(README.Apache)
Adding the ColdFusion module to Apache 1.2.x
The ColdFusion module can be found in the installation directory (usually /opt) under
the
coldfusion/webserver/apache directory.
The following procedure assumes that your Apache Web server is installed in
/usr/local/etc/httpd and you installed ColdFusion in /opt.
To add the ColdFusion module:
1. Copy the module (mod_coldfusion.a) to your Apache source directory.
cp /opt/coldfusion/webserver/apache/mod_coldfusion.a \
/usr/local/etc/httpd/src/mod_coldfusion.a
2. Edit the /usr/local/etc/httpd/src/Configuration file to contain the following
line:
Module coldfusion_module mod_coldfusion.a
3. If you are using the Sun C compiler, edit the EXTRA_LIBS= line to include the C++
library:
EXTRA_LIBS=-lC
If you are using the gcc compiler, you should add the absolute path of the C++
library to this line. You should include the version number of the library and use
the highest one available.
For example:
EXTRA_LIBS=/usr/lib/libC.run.so.1
4. Run the Configure script to regenerate the configuration.
./Configure
5. Run make to build a new Apache httpd executable.
6. Install the new httpd executable in your installation directory and restart httpd.
You should now be able to access the ColdFusion Administrator with the following
URL:
http://localhost/CFIDE/administrator/index.cfm