User Guide
46 Chapter 3: Installing the J2EE Configuration
Depending on your operating system, you might have to add the following to the java.args
JVM argument:
• COM (Windows only) Add the following arguments:
-DJINTEGRA_NATIVE_MODE -DJINTEGRA_PREFETCH_ENUMS
• CORBA (optional) Copy vbjorb.jar to WEB-INF/cfusion/lib and define the following
argument:
-Xbootclasspath/a:"cf_root/WEB-INF/cfusion/lib/vbjorb.jar"
• Charting Define the following argument (or ensure that WEB-INF/cfusion/lib is in the
JVM's classpath):
-Xbootclasspath/a:$cf_root/WEB-INF/cfusion/lib/webchartsJava2D.jar
Note: For JDK 1.4.1 and later versions, specify com.gp.java2d.ExHeadlessGraphicsEnvironment
instead of com.gp.java2d.ExGraphicsEnvironment.
• Charting (UNIX only) Define the following argument:
-Djava.awt.graphicsenv=com.gp.java2d.ExGraphicsEnvironment"
Note: For JDK 1.4.1 and later versions, specify com.gp.java2d.ExHeadlessGraphicsEnvironment
instead of com.gp.java2d.ExGraphicsEnvironment.
• Security In addition to enabling sandbox security in the ColdFusion MX Administrator, the
application server must be running a security manager (
java.lang.SecurityManager) and
you must define the following JVM arguments:
-Djava.security.manager
-Djava.security.policy="
cf_root/WEB-INF/cfusion/lib/coldfusion.policy"
-Djava.security.auth.policy="
cf_root/WEB-INF/cfusion/lib/neo_jaas.policy"
Additionally certain application servers require that you disable server-specific policy-file
permissions in order to enable the ColdFusion security manager. For more information, see the
application-server-specific instructions at www.macromedia.com/go/cfmxj2ee-cert.
If the version of tools.jar in your application server’s JRE is different from the version of tools.jar
in WEB-INF/cfusion/lib, you should rename or delete WEB-INF/cfusion/lib/tools.jar to ensure
that your application server’s tools.jar file is used.
ColdFusion MX J2EE configuration directory structure
The following table describes the directories under the cf_root web application directory when
using the J2EE configuration:
Directory Description
cfdocs Documentation for ColdFusion MX.
CFIDE Files for the ColdFusion MX Administrator.
META-INF Information about the application (might not contain substantial
information).
WEB-INF/cfclasses Compiled ColdFusion templates in your ColdFusion applications.
WEB-INF/cfc-skeletons Support for ColdFusion components that are exported as web
services.
WEB-INF/cftags Templates for ColdFusion MX.