System information

83
CONFIGURING AND ADMINISTERING COLDFUSION 9
Using Multiple Server Instances
Last updated 2/21/2012
File location considerations
ColdFusion lets you store CFM pages either under the external web server root or under the ColdFusion web
application root. The discussions here assume that you store your CFM pages under the ColdFusion web application
root and specify a context root for your application. However, in ColdFusion MX 6.1 documentation, the assumption
that you stored CFM pages under the web server root.
If you use the web server connector to access pages under the ColdFusion web application root and your ColdFusion
web application has an empty context root (this is the default), the connector does not automatically serve static
content, such as HTML pages and image files. If so, define web server mappings so that it can serve files from the
ColdFusion web application root.
For more information on serving CFM pages from the web server root, see “Web Server Management” on page 59
Defining additional server instances
The multiserver configuration is a customized installation of JRun. JRun supports multiple server instances (also called
JRun servers) running on the same computer. Each server instance runs in a separate JVM, which executes all
ColdFusion pages for that instance.
Use the Instance Manager area of the ColdFusion Administrator to define and manage server instances. The Instance
Manager only runs in the cfusion JRun server that is created as part of a multiserver configuration installation.
Note: When you create a server instance using the Instance Manager, if you previously modified the cfusion (Enterprise
Manager) instance, the log files for the new instance point to the default cfusion instance. Before you modify the cfusion
instance, ensure that you want to share the modification among all new instances.
When you create a server instance with the Instance Manager, by default it deploys a copy of the cfusion server
ColdFusion enterprise application, including data sources, mappings, and settings. Alternatively, you can create a
server instance and specify the location of an EAR or WAR file (created by the J2EE Archive page), which the Instance
Manager uses as the basis for your new ColdFusion server instance.
Note: If you are running JRun 4, you can also create a server in the JRun Management Console (JMC) and deploy the
ColdFusion application using JRun deployment functionality.
Define a server instance
1 Ensure that you installed ColdFusion using the multiserver configuration.
2 Open the ColdFusion Administrator for the cfusion server in a browser
(http://hostname:8300/CFIDE/administrator).
3 Select Enterprise Manager > Instance Manager.
4 Click Add New Instance.
5 Specify the following in the Add New ColdFusion Server area:
• Server name
• (Optional) Directory that contains the server instance. The ColdFusion Administrator fills in the default
automatically (jrun_root/servers/servername).
• (Optional) Create from EAR/WAR. If you use the J2EE Packaging feature to create a J2EE archive file with your
application files (including CFM, CFC, and CFR files) and data sources, use this field to specify the EAR or WAR
filename and create a server instance with your application deployed automatically.