Defining Additional Server Instances - MACROMEDIA COLFUSION MX 7 - CONFIGURING AND ADMINISTERING COLDFUSION MX Manual

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.
You use the Instance Manager area of the ColdFusion MX 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.
When you create a server instance with the Instance Manager, by default it deploys a copy of the
cfusion server's ColdFusion enterprise application, including data sources, mappings, and
settings. Alternatively, you can create a new 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.
To define a server instance:
Ensure that you have installed ColdFusion MX 7 using the multiserver configuration.
1.
Open the ColdFusion MX Administrator for the cfusion server in a browser
2.
(http://hostname:8300/CFIDE/administrator).
Select Enterprise Manager > Instance Manager.
3.
Click Add New Instance.
4.
Specify the following in the Add New ColdFusion Server area:
5.
Server name
(Optional) Directory that contains the server instance. The ColdFusion MX 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's 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.
(Optional, Windows only) Specify whether to create a Windows service for the server
instance and whether to define the Windows service with an auto restart recovery option.
Click Submit.
6.
The ColdFusion MX Administrator creates a server instance with ColdFusion MX deployed in
it and starts the server instance. The ColdFusion MX application that it deploys is based on the
application archive file specified in the Create from EAR/WAR field or on the cfusion server
instance (if you don't specify an EAR or WAR file).
Creating a JRun server instance and deploying the ColdFusion MX application can take a few
minutes.
Click Return to Instance Manager.
7.
You can also start and stop the server instance using the JMC, the JRun Launcher, or the
command line (
jrun_root/bin jrun -start|-stop servername
).

Defining additional server instances

93