User Guide
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
www.macromedia.com/go/cfmx7_j2eecert.
For more information, see “Deployment” on page 40 and “Configuration” on page 42.
Deployment
The instructions at www.macromedia.com/go/cfmx7_j2eecert 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://
hostname:portnumber/contextroot/pagename.cfm.
To deploy ColdFusion MX 7 as an enterprise application on JRun 4:
1.
Run the installation wizard for your platform, as described in “Installing an EAR file or WAR
files” on page 34. 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 “Updating from ColdFusion MX or ColdFusion MX 6.1
for J2EE” on page 38.
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
java_home/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).