User guide

INSTALLING COLDFUSION 9

Installing the J2EE Configuration

Last updated 1/20/2012

Deploying ColdFusion 9 on JBoss Application Server

ColdFusion 9 supports JBoss with the following specifications:

• JBoss 4.2/5.0.1 (uses Tomcat 6.0.x Server Container)

• Sun JDK 1.5 and Sun JDK 1.6

• Host OS - Windows 2003 server SP1, Solaris 10, and RH Linux 4AS/5 AS

ColdFusion 9 has not been tested using JBoss under the following conditions:

1 JBoss using a servlet container other than Tomcat

2 Operating systems that are not in the previous list

Note: If you are already using an application with context root of /, use a context root other than / for the cfusion-ear file.

If you specified / when you installed ColdFusion, 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.

If you are updating an existing deployment of ColdFusion, undeploy it for J2EE before you deploy ColdFusion 9.

When you deploy ColdFusion on an existing version of JBoss, expand the EAR file or WAR files manually before

deployment.

This document uses the following conventions:

JBOSS_HOME Directory where JBoss is installed, for example, C:\jboss-4.0.5SP1 in Windows or /usr/local/jboss-

4.0.5.SP1 on UNIX

JBOSS_DEPLOY_DIR Application deployment directory in JBoss, for example, C:\jboss-

4.0.5SP1\server\default\deploy

CF_WEBAPP_ROOT Directory where ColdFusion is deployed, for example: C:\jboss-

4.0.5SP1\server\default\deploy\cfusion.ear\cfusion.war

TEMP_LOCATION Temporary location where you extract the cfusion.ear file.

Deploy ColdFusion on JBoss

1 To ensure that ColdFusion can deploy on JBoss 4.2/JBoss 5.01, perform the following steps instead of following the

standard instructions in the cf-j2ee-readme.txt file:

a Keep periods in the directory names, instead of renaming them with dashes, for example,

\deploy\cfusion.ear\cfusion.war.

b Do not make the updates to application.xml.

2 Set JAVA_HOME to the appropriate JDK.

3 Install ColdFusion by using the J2EE deployment option and selecting to create an EAR file (the default).

The installation program creates the cfusion.ear file in the install directory.

4 Extract the cfusion.ear file into a TEMP_LOCATION\cfusion.ear folder. This step creates cfusion.war and rds.war

files and a META-INF folder in the cfusion.ear folder.

5 In the cfusion.ear folder, extract the cfusion.war and rds.war files into folders named cfusion and rds, respectively.

6 Delete the compressed cfusion.war and rds.war files.

7 Rename the cfusion and rds folders to cfusion.war and rds.war, respectively.

8 Stop JBoss if it is running.