User guide

44
INSTALLING COLDFUSION 9
Installing the J2EE Configuration
Last updated 1/20/2012
9 Copy or move the TEMP_LOCATION\cfusion.ear folder into the JBOSS_DEPLOY_DIR folder
The resulting directory structure should appear as follows:
JBoss 4.2.0 or JBoss 5.01
server
default
deploy
cfusion.ear
cfusion.war
META-INF
rds.war
10 (Windows) Edit the JBOSS_HOME\bin\run.bat file by doing the following:
a If not present, add the JVM (-Xmx512m) parameter to JAVA_OPTS.
b Ensure that the permanent generation heap size is set by adding -XX:MaxPermSize=128m to JAVA_OPTS.
Without this parameter, the JVM can generate a java.lang.OutOfMemoryError error. For more information, see
(http://wiki.jboss.org/wiki/Wiki.jsp?page=PermanentGeneration).
c Ensure that the jars available in WEB-INF/flex/jars are in the classpath.
d Save the run.bat file.
e Start the server by running the JBOSS_HOME\bin\run.bat file.
Note: If you use Apache Derby database, add the following in run.bat: JAVA_OPTS=%JAVA_OPTS% -
Djboss.platform.mbeanserver. This is to ensure that Apache Derby do not start a JMX management server that
might conflict with JBoss.
11 (Linux) Edit the JBOSS_HOME/bin/run.conf file by doing the following:
a In JAVA_OPTS, change -Xmx128m. to -Xmx512m.
b Add -XX:MaxPermSize=128m to JAVA_OPTS.
c Save the run.conf file.
d Start the server by running the JBOSS_HOME/bin/run.sh file.
To enable features with operating system-specific binaries, configure ColdFusion. This step is required to
support the following features that use binaries that are specific to your operating system:
• CFX tags written in C++
• Microsoft Access driver with Unicode support (Windows only)
Use the following procedure for your operating system to configure the search paths to find the required
binary files. These files are located in the CF_WEBAPP_ROOT\WEB-INF\cfusion\lib directory.
Note: If you use Apache Derby database, add the following in run.bat: JAVA_OPTS="$JAVA_OPTS -
Djboss.platform.mbeanserver". This is to ensure that Apache Derby do not start a JMX management server
that might conflict with JBoss.
Configure operating system-specific binary support for Windows
1 Ensure that JBoss Server is stopped.
2 Edit JBOSS_HOME\bin\run.bat by adding the following:
set CF_LIB_PATH=JBOSS_DEPLOY_DIR\cfusion.ear\cfusion.war\WEB-INF\cfusion\lib
set PATH=%PATH%;%CF_LIB_PATH%