Configuring Web Servers On Unix - MACROMEDIA COLDFUSION MX 61 - INSTALLING AND USING COLDFUSION MX Using Manual

Configuring web servers on UNIX

This section explains how to configure the following web servers on UNIX:
•
Configuring Apache web server on UNIX
•
Configuring Netscape or iPlanet web server on UNIX
Configuring Apache web server on UNIX
This section describes how to configure the Apache web server for ColdFusion MX on UNIX,
and how to verify your configuration.
Note: When running the Web Server Configuration Tool on the JRun J2EE configuration,
wsconfig.jar is located in jrun_root/lib. You can also use the scripts in cf_root/bin/connectors,
modifying them, as appropriate for your environment.
To configure the Apache web server for ColdFusion MX on UNIX:
Enter the following command on a single line:
1
java_root/bin/java -jar cf_root/runtime/lib/wsconfig.jar -ws Apache
-dir <apache config directory> -map .cfm,.cfc,.cfml -coldfusion -v
Note: You must enter the previous command as a single (long) line.
The following is a sample command:
/opt/coldfusionmx/jre/bin/java -jar
/opt/coldfusionmx/runtime/lib/wsconfig.jar -ws Apache
-dir /etc/httpd/conf -map .cfm,.cfc,.cfml,.jsp,.jws -coldfusion -v
Note: For unique configurations (such as the pre-configured Apache web servers from Redhat or
Sun), add the -bin and -script parameters, as described in Configuring and Administering
ColdFusion MX.
Copy the CFIDE and cfdocs directories from cf_root/wwwroot to your web server root
2
directory. In addition, copy your application's CFM pages from cf_root/wwwroot to your web
server root directory.
To verify your Apache configuration:
Verify that one of the following files was created:
1
cf_root/runtime/lib/wsconfig/number/mod_jrun.so (Apache 1.3.x)
or
cf_root/runtime/lib/wsconfig/number/mod_jrun20.so (Apache 2.x)
Open the Apache configuration file, httpd.conf, in your Apache conf directory. By default it is
2
/etc/httpd/conf/httpd.conf.
Verify that the following code is added to this file:
# JRun Settings
LoadModule jrun_module
"/opt/coldfusionmx/runtime/lib/wsconfig/1/mod_jrun.so"
<IfModule mod_jrun.c>
JRunConfig Verbose false
JRunConfig Apialloc false
JRunConfig Ssl false
JRunConfig Serverstore "/opt/coldfusionmx/runtime/lib/wsconfig/1/
jrunserver.store"
JRunConfig Bootstrap 127.0.0.1:51000
#JRunConfig Errorurl <URL for errors>
JRunConfig jrun-handler .jsp .jws .cfm .cfml .cfc
</IfModule>
58 Chapter 4: Configuring Your System