User Guide

Advanced configurations 67
3 Restart Apache to ensure that the virtual hosts are defined correctly. You store CFM files for
each virtual host in the directory specified by the DocumentRoot directive.
4 Test each virtual host to ensure that HTML pages are served correctly.
5 Run the Web Server Configuration Tool, as follows:
■ GUI Specify Apache for the Web Server, specify the directory containing the httpd.conf
file, and select the Configure web server for ColdFusion MX applications option.
■ Command line Specify -ws apache and the directory containing the httpd.conf file, as
shown in the following example:
java_home/bin/java -jar wsconfig.jar -ws apache -dir
"c:\program files\apache group\apache2\conf" -map
.cfm,.cfc,.cfml,.jsp,.jws -coldfusion -v
For additional Unix command-line examples, see “Using the command-line interface”
on page 60.
6 The JavaScript validation used by the cfform tag references the CFIDE/scripts/cfform.js file.
However in a multi-homed environment, each virtual website may not contain this directory
and file. Either copy this file and store it in your virtual website’s web root in a CFIDE/scripts
directory or modify all
cfform tags to use the scriptsrc attribute to specify the location of the
cfform.js file.
7 Ensure that Cache Web Server Paths is disabled in the Caching page of the ColdFusion MX
Administrator (in the J2EE configuration on JRun, set the
cacheRealPath attribute to false for
the ProxyService in the jrun.xml file).
8 Test each virtual host to ensure that CFM pages are served correctly.
Sun ONE Web Server (iPlanet)
When using Sun ONE Web Server version 6, you use the Server Administrator to create virtual
servers and run the Web Server Configuration Tool. You store CFM pages under the web root of
each virtual website.
Note: For earlier versions of iPlanet and Netscape Enterprise Server (NES), you must create
separate server instances for each site and run the Web Server Configuration Tool once for each site.
To connect multiple virtual hosts on a web server to a single ColdFusion server:
1 Using the Sun ONE Web Server Administrator, create virtual web servers for use by
ColdFusion MX. For more information, see your Sun ONE Web Server documentation.
2 Configure DNS for each virtual website, as described in your web server documentation.
3 Test each virtual server to ensure that HTML pages are served correctly.
4 Run the Web Server Configuration Tool, as follows:
■ GUI Specify Netscape Enterprise Server/iPlanet for the Web Server, specify the directory
containing the obj.conf and magnus.conf files, and select the Configure web server for
ColdFusion MX applications option.
■ Command line Specify -ws iplanet and the directory containing the obj.conf file, as
shown in the following example:
/opt/coldfusionmx/runtime/jre/bin/java -jar /opt/coldfusionmx/runtime/lib/
wsconfig.jar -ws iplanet -dir [path to config] -map
.cfm,.cfc,.cfml,.jsp,.jws -coldfusion -v