User guide

INSTALLING COLDFUSION 9

Installing the J2EE Configuration

Last updated 1/20/2012

2 (Windows only) If you installed the SequelLink ODBC Agent, stop the ODBC services before you start the

installation wizard.

3 Copy application files to a backup directory.

4 Save settings by copying the files cf_webapp_root/WEB-INF/cfusion/lib/neo-*.xml to a backup directory.

5 Before you deploy ColdFusion 9, undeploy the previous ColdFusion application using your application-server-

specific undeploy functionality.

6 Deploy ColdFusion 9 as described in “Deploying ColdFusion 9 on JRun 4” on page 26, “Deploying ColdFusion 9

on IBM WebSphere” on page 29, “Deploying ColdFusion 9 on BEA WebLogic” on page 36, “Deploying ColdFusion

9 on Oracle Application Server 10g” on page 40, or “Deploying ColdFusion 9 on JBoss Application Server” on

page 43.

7 Create a directory named cfXsettings (in which X is the earlier version of ColdFusion) in the cf_webapp_root/WEB-

INF/cfusion/lib directory.

8 Copy the backed up settings files to the ColdFusion 9 cfusion/lib/cfXsettings directory.

9 Edit the ColdFusion 9 cfusion/lib/adminconfig.xml file by setting the value of the runmigrationwizard and the

migratecfX (in which X is the earlier version of ColdFusion) switch to true.

10 Restart the ColdFusion 9 application.

11 Browse to ColdFusion Administrator to run the migration wizard.

Note: The migration wizard supports only the migration of settings from ColdFusion 7 and ColdFusion 8.

ColdFusion J2EE deployment and configuration

The J2EE specification allows application servers to handle compressed and expanded deployments in a server-

dependent manner; each application server has its own deployment and configuration mechanism, as the following

table shows:

For basic deployment information, see your J2EE application server documentation. ColdFusion deployment

instructions differ for each J2EE application server. For more information, see deployment instructions for the specific

application server.

J2EE directory structure

The following table describes the directories under the cf_webapp_root web application directory when you use the

J2EE configuration:

Application server Deployment mechanism Expanded or compressed deployment

JRun 4 Auto deploy to server root or deploy using the JRun

Administrative Console

Expanded

IBM WebSphere IBM WebSphere Administrative Console Compressed

BEA WebLogic Weblogic Administration Console/Auto deploy to

server domains

Expanded

Oracle Application Server 10g OracleAS Enterprise Manager Console Compressed

JBOSS Application Server Auto deploy to server root Expanded