User guide

INSTALLING COLDFUSION 9

Installing the Server Configuration

Last updated 1/20/2012

Using the built-in web server

ColdFusion has its own web server that you can use to develop ColdFusion applications, without depending on an

external web server, such as Internet Information Server (IIS), Apache, or Sun Java System Web Server. Adobe does

not recommend using the built-in web server in a production environment. However, it is more than suitable for

development, allowing you to create virtual directories and set the default document (for example, default.cfm or

index.cfm).

During the ColdFusion installation, choose a web server. If you select the built-in web server, your web root directory

is located in the cf_root/wwwroot directory. By default, the web server runs on port 8500. This means that to display a

page in your application, append :8500 to the host name or IP address in the URL; for example,

http://localhost:8500/YourApp1/index.cfm. (If the page still does not appear, ensure that the document is located in

the built-in web server’s web root directory; for example, C:\ColdFusion9\wwwroot\YourApp1\index.cfm.)

Note: If you install the server configuration of ColdFusion with the built-in server and port 8500 is in use, for example by

ColdFusion MX, ColdFusion MX 6.1, or ColdFusion MX 7, the installer starts with port 8501 and looks at up to 100 ports

to find one that is not being used by an application that is running. ColdFusion uses that port and displays a message to

indicate which port it selected.

If you select an external web server, the built-in web server is deactivated.

Switching the port for the built-in web server

You can change the port on which the built-in web server runs.

Change the port for the built-in web server

1 Back up the jrun.xml file.

This file is in the cf_root\runtime\servers\coldfusion\SERVER-INF directory in Windows, and in the

cf_root/runtime/servers/coldfusion/SERVER-INF directory in UNIX.

2 Open the original jrun.xml file for editing.

3 Change the port number specified in the WebService port attribute (near the bottom of the file):

runtime Programs and supporting files for the ColdFusion runtime.

In Windows, the files for the bundled JRE are in runtime\jre.

runtime/jre Files for the Java Runtime Environment (JRE) that is bundled with ColdFusion.

uninstall Files to uninstall ColdFusion.

verity Verity collections, configurations, and services directories.

solr Solr configurations and Jetty.

wwwroot Default web root directory for the built-in web server. When running on other web servers, this directory contains only

the WEB-INF directory; do not remove this directory.

Directory Description