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 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'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.
Define a server instance
- Ensure that you installed ColdFusion using the multiserver configuration.
- Open the ColdFusion Administrator for the cfusion server in a browser (http://hostname:8300/CFIDE/administrator).
- Select Enterprise Manager > Instance Manager.
- Click Add New Instance.
- 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'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.
The ColdFusion Administrator creates a server instance with ColdFusion deployed in it and starts the server instance. The ColdFusion 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 application can take a few minutes.
- Click Return to Instance Manager.
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).
