If your workstation runs ColdFusion but does not run an external web
server, you can still develop and test ColdFusion applications locally
through the built-in web server. All web servers listen on
a TCP/IP port, which you can specify in the URL. By default, web
servers listen for HTTP requests on port 80 (for example, http://www.adobe.com
and http://www.adobe.com:80 are the same). Similarly, port 443 is
the default port for https requests.
By default in the server
configuration, the built-in web server listens on port 8500. For
example, to access the ColdFusion Administrator through the built-in web
server, specify http://servername:8500/CFIDE/administrator/index.cfm.
In the multiserver configuration, the default port for the built-in
web server is 8300.
Note: URLs are case sensitive
on UNIX operating systems.
If you enable the built-in web
server during the installation process and the port is already in
use, the installer automatically finds the next-highest available
port and configures the built-in web server to use that port. To
determine the port number used by the built-in web server, open
the cf_root/runtime/servers/coldfusion/SERVER-INF/jrun.xml
file in a text editor and examine the port attribute
of the WebService service. In the multiserver configuration, the
path is jrun_root/servers/cfusion/SERVER-INF/jrun.xml.
Note: When you install ColdFusion Enterprise Edition
using the multiserver configuration, the installation wizard always
configures the built-in web server, even if you select an external
web server.
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.
The default web root when using
the built-in web server is cf_root/wwwroot (server configuration)
or jrun_root/servers/cfusion/cfusion-ear/cfusion-war (multiserver
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/wwwroot/WEB-INF/jrun-web.xml
file (jrun_root/servers/cfusion/cfusion-ear/cfusion-war/WEB-INF/jrun-web.xml
in the multiserver configuration), as the following example shows:
<virtual-mapping>
<resource-path>/*</resource-path>
<system-path>C:/myApps/wwwroot</system-path>
</virtual-mapping>
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.