User Guide

Configuring web servers 55

To configure the Apache web server for ColdFusion MX 7 on UNIX:

Enter the following command on a single line:

wsconfig -server servername -ws Apache -dir <apache config directory> -

coldfusion -v

Note: You must enter the previous command as a single (long) line.

The wsconfig file is in cf_root/runtime/bin (server configuration) or jrun_root/bin (multiserver

configuration)

The following is a sample command:

/opt/cfusionmx7/runtime/bin/wsconfig -server coldfusion -ws Apache -dir

/etc/httpd/conf -coldfusion -v

Note: For unique configurations (such as the preconfigured 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

directory. In addition, copy your application’s pages from cf_root/wwwroot to your web server

root directory. In the multiserver configuration, these files are under the

jrun_root/servers/cfusion/cfusion-ear/cfusion-war directory.

To verify your Apache configuration:

Verify that one of the following files was created:

■ cf_root/runtime/lib/wsconfig/number/mod_jrun.so (Apache 1.3.x)

■ cf_root/runtime/lib/wsconfig/number/mod_jrun20.so (Apache 2.x)

In the multiserver configuration, this file is located under jrun_root/lib/wsconfig.

Open the Apache configuration file, httpd.conf, in your Apache conf directory. By default it is

/etc/httpd/conf/httpd.conf.

Verify that the following code is added to this file:

# JRun Settings

LoadModule jrun_module "/opt/CFusionMX7/runtime/lib/wsconfig/1/mod_jrun.so"

JRunConfig Verbose false

JRunConfig Apialloc false

JRunConfig Ssl false

JRunConfig Serverstore "/opt/CFusionMX7/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>