44
Chapter 3: Installing the J2EE Configuration
To deploy ColdFusion MX 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 39
. 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 for J2EE, you must undeploy
ColdFusion MX for J2EE before deploying ColdFusion MX 6.1, as described in
“Updating
from ColdFusion MX for J2EE” on page 42
.
2
Expand the EAR file by performing the following steps:
a
Open a console windows, 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 cfusion.ear with the
jar
command:
cd cfusion-ear
java_home
/bin/jar -xvf ../cfusion.ear
This expands cfusion.ear into cfusion.war and rds.war (rds.war is not included if you
specified a context root of / when running the installation wizard).
c
In cfusion-ear, make a new directory named cfusion-war.
md cfusion-war (mkdir cfusion-war on UNIX)
d
Change to the cfusion-war directory and expand cfusion.war with the
jar
command:
cd cfusion-war
java_root
/bin/jar -xvf ../cfusion.war
This expands cfusion.war.
e
(If rds.war exists) Go up one level to cfusion-ear, make a new directory named rds-war.
cd ..
md rds-war (mkdir rds-war on UNIX)
f
(If rds.war exists) Change to the rds-war directory and expand rds.war with the
jar
command:
cd rds-war
java_root
/bin/jar -xvf ../rds.war
This expands rds.war.
g
Go up one level to cfusion-ear, and delete the cfusion.war and rds.war files:
cd ..
del cfusion.war (rm cfusion.war on UNIX)
del rds.war (rm rds.war on UNIX)
h
Open cfusion-ear/META-INF/application.xml in a text editor.
i
Change the
web-uri
element from cfusion.war to cfusion-war (or the name of the directory
that contains the expanded cfusion.war file). Change the
web-uri
element for rds.war to
rds-war. A directory name in the
web-uri
element cannot contain a dot.
j
Save the application.xml file.
3
Deploy ColdFusion MX by copying the cfusion-ear directory structure to the
jrun_root
/servers/
servername
directory. If auto-deploy is enabled, JRun 4 either deploys the
application immediately (if the JRun server is running) or when you start the JRun server.
4
Review the server log (
jrun_root
/logs/
servername
-event.log) to ensure that ColdFusion MX
deployed successfully.
Summary of Contents for COLDFUSION MX 61 - CONFIGURING AND ADMINISTERING COLDFUSION...
Page 1: ...Installing and Using ColdFusion MX...
Page 6: ...6 Introduction...
Page 30: ...30 Chapter 2 Installing the Server Configuration...
Page 48: ...48 Chapter 3 Installing the J2EE Configuration...
Page 70: ...70 Index...