Macromedia colfusion mx 7 Manual

40

Chapter 4:  Installing the J2EE Configuration

For basic deployment information, see your J2EE application server documentation. 
ColdFusion MX 7 deployment instructions differ for each J2EE application server. For up-to-
date information on deploying ColdFusion MX 7 on a variety of J2EE application servers, see 

For more information, see 

 and 

.

Deployment

The instructions at 

 provide detailed, application-

server-specific ColdFusion MX 7 deployment instructions. Depending on your application 
server, the instructions describe deployment of an EAR file or WAR files in either a compressed 
archive or an expanded directory structure. When you deploy ColdFusion MX 7 on an existing 
version of JRun 4, you must expand the EAR file or WAR files manually before deployment. 

The following procedures describe EAR and WAR deployment on an existing version of JRun 4.

Tip: The instructions for expanding the cfusion.ear file also apply when deploying ColdFusion MX 7 
on BEA WebLogic.

Expanding and deploying an EAR file on JRun 4

Before you deploy ColdFusion MX 7 as an enterprise application on an existing JRun server, you 
must expand the EAR and the WAR files that it contains. 

Note: If you are already using an application with an empty context root, you must use a context root 
other than / for the cfusion-ear file. If you specified / when you installed ColdFusion MX 7, you can 
change it by opening the cfusion-ear/META-INF/application.xml file in a text editor and modifying the 
context-root element. After you deploy the cfusion-ear file, you access ColdFusion pages by 
specifying http://

.cfm.

To deploy ColdFusion MX 7 as an enterprise application on JRun 4:

1.

Run the installation wizard for your platform, as described in 

. Select the EAR option. When you get to the deployment step, return to these 

instructions.

If you are updating an existing deployment of ColdFusion MX or ColdFusion MX 6.1 for 
J2EE, you must undeploy ColdFusion MX or ColdFusion MX 6.1 for J2EE before you deploy 
ColdFusion MX 7, as described in 

.

2.

Expand the EAR file by performing the following steps:

a

Open a console window, navigate to the directory that contains the EAR file, and make a 
new directory named cfusion-ear:

    md cfusion-ear (mkdir cfusion-ear on UNIX)

b

Change to the cfusion-ear directory and expand the cfusion.ear file with the 

jar

 command:

    cd cfusion-ear
    

/bin/jar -xvf ../cfusion.ear

This expands the cfusion.ear file into cfusion.war and rds.war (rds.war is not included if you 
specified a context root of / when you ran the installation wizard).