
96
CONFIGURING AND ADMINISTERING COLDFUSION 10
Web Server Management
L
ast
u
p
dated
7/9/2
01
2
Keep in mind the following when using the built-in web server:
•
Whenever possible, configure your external web server as part of the ColdFusion installation, except for the two
cases mentioned previously (coexistence with a previous ColdFusion version, and when the computer has no web
server). If you select the built-in web server by mistake, run the Web Server Configuration Tool manually to
configure your external web server after the installation. For information about the Web Server Configuration
Tool, see “
Web server configuration
” on page 98.
•
The default web root when using the built-in web server is
cf_root
/cfusion/wwwroot (server configuration). By
default, the ColdFusion Administrator (CFIDE directory) is under this web root.
•
If you want the built-in web server to serve pages from a different web root directory, define a virtual mapping in
the
cf_root
/cfusion/runtime/conf/server.xml file. Search for the string, “To add virtual directory.” Uncomment the
entry context path below. To add a virtual directory, add the aliases attribute as shown below:
<Context path="/" docBase="<absolute_path_to_CF_install_directory>\wwwroot"
WorkDir="<cf_home>\runtime\conf\Catalina\localhost\tmp"
aliases="/path1=<absolute_path_to_directory1>,/path2=<absolute_path_to_directory2>"></Context>
Important:
If you have CFML pages under your external web server’s root, ensure that ColdFusion is configured to serve
these pages through the external web server. If you did not configure ColdFusion to use an external web server, your
external web server serves ColdFusion Markup Language (CFML) source code for ColdFusion pages saved under its web
root.
Using an external web server
ColdFusion uses the Tomcat web server connector to forward requests from an external web server to the ColdFusion
runtime system.
When a request is made for a CFM page, the connector on the web server opens a network connection to the Tomcat
proxy service. The ColdFusion runtime system handles the request and sends its response back through the proxy
service and connector. The web server connector uses web-server-specific plug-in modules, as the following table
describes: