Skip to content

Manual Configuration Examples

Below are examples of configuring your application server / jvm arguments for the supported server types.

Adobe ColdFusion Server

Warning

ColdFusion 9, 10 and 11 on Windows will interpret backslashes \ as a character escapement mechanism. You should either use a double backslash \ or forward slash / in your JVM config file.

  1. Navigate to the following directory; 1.
    1. ColdFusion9: {ColdFusion-Home}/runtime/bin
    2. ColdFusion 10/11/2016/2018: {ColdFusion-Home}/cfusion/bin
  2. Locate and open the jvm.config file with a text editor of your preference.
  3. Add the FusionReactor Java Agent and possibly the FusionReactor Production Debugger at the end of the line after "# Arguments to VM". Please make sure that all the Java Arguments are on the same line.
  4. Save the changes made.
# Arguments to VMx
java.args=-server -Xms256m -Xmx512m -XX:MaxPermSize=192m -Xbatch -Dcoldfusion.home={application.home} -Djava.awt.headless=true -Dcoldfusion.rootDir={application.home} -Djava.security.policy={application.home}/lib/coldfusion.policy -Djava.security.auth.policy={application.home}/lib/neo-jaas.policy -Dcoldfusion.classPath={application.home}/lib/updates,{application.home}/lib,{application.home}/lib/axis2,{application.home}/gateway/lib/,{application.home}/wwwroot/WEB-INF/cfform/jars,{application.home}/wwwroot/WEB-INF/flex/jars,{application.home}/lib/oosdk/lib,{application.home}/lib/oosdk/classes -Dcoldfusion.libPath={application.home}/lib -Dorg.apache.coyote.USE-CUSTOM-STATUS-MSG-IN-HEADER=true -javaagent:C:\FusionReactor\instance\cfusion.CF2018\fusionreactor.jar=name=cfusion.CF2018,address=8088 -agentpath:C:\FusionReactor\instance\cfusion.CF2018\frjvmti_x64.dll

Adobe ColdFusion Solr

  1. Navigate to the following directory: {ColdFusion-Home}\solr.
  2. Locate and open the solr.lax with a text editor of your preference.
  3. Add the FusionReactor Java Agent and possibly the FusionReactor Production Debugger at the end of the line beginning with "lax.nl.java.option.additional=". Please make sure that all the Java Arguments are on the same line.
  4. Save the changes made.
...
lax.nl.java.option.additional=-server -Xmx256m -XX:+AggressiveOpts -XX:+ScavengeBeforeFullGC -XX:-UseParallelGC -DSTOP.PORT=8079 -DSTOP.KEY=cfstop -Dsolr.solr.home=multicore -javaagent:C:\FusionReactor\instance\cf9-solr\fusionreactor.jar=name=cf9-solr,address=8088 -agentpath:C:\FusionReactor\instance\cf9-solr\frjvmti_x64.dll
  1. Navigate to the following directory: {ColdFusion-Home}/solr/.
  2. Locate and open the cfsolr file with a text editor of your preference.
  3. Add the FusionReactor Java Agent and possibly the FusionReactor Production Debugger at the end of the line after "# JVM Args". Please make sure that all the Java Arguments are on the same line.
  4. Save the changes made.
...
# JVM Args
JVMARGS="-XX:+AggressiveOpts -XX:+ScavengeBeforeFullGC -XX:-UseParallelGC -Xmx256m -Dsolr.solr.home=multicore -DSTOP.PORT=8079 -DSTOP.KEY=cfsolrstop -javaagent:/opt/fusionreactor/instance/cf9-solr/fusionreactor.jar=name=cf9-solr,address=8088 -agentpath:/opt/fusionreactor/instance/cf9-solr/libfrjvmti_x64.so"
...

Adobe ColdFusion Multi

  1. Navigate to the following directory: {ColdFusion-Multi-Home}/bin/.
  2. Locate and open the jvm.config file with a text editor of your preference.
  3. Add the FusionReactor Java Agent and possibly the FusionReactor Production Debugger at the end of the line after "# Arguments to VMx". Please make sure that all the Java Arguments are on the same line.
  4. Save the changes made.
...
 # Arguments to VMx
java.args=-server -Xms256m -Xmx512m -XX:MaxPermSize=192m -Xbatch -Dcoldfusion.home={application.home} -Djava.awt.headless=true -Dcoldfusion.rootDir={application.home} -Djava.security.policy={application.home}/lib/coldfusion.policy -Djava.security.auth.policy={application.home}/lib/neo-jaas.policy -Dcoldfusion.classPath={application.home}/lib/updates,{application.home}/lib,{application.home}/lib/axis2,{application.home}/gateway/lib/,{application.home}/wwwroot/WEB-INF/cfform/jars,{application.home}/wwwroot/WEB-INF/flex/jars,{application.home}/lib/oosdk/lib,{application.home}/lib/oosdk/classes -Dcoldfusion.libPath={application.home}/lib -Dorg.apache.coyote.USE-CUSTOM-STATUS-MSG-IN-HEADER=true -javaagent:/opt/fusionreactor/instance/coldfusion9-multi/fusionreactor.jar=address=8088 -agentpath:/opt/fusionreactor/instance/coldfusion9-multi/libfrjvmti_x64.so

Lucee

  1. Navigate to the following directory: {Lucee-Home}\tomcat\bin.
  2. Locate and run the Luceew.exe program.
  3. Within the program, on the "Java" tab, add the FusionReactor Java Agent and possibly the FusionReactor Production Debugger for your server to the bottom of the list in the "Java Options:" field.
  4. Click the Apply button.
  5. Click the OK button.
-Dcatalina.home=...
-Dcatalina.base=...
-Djava.endorsed.dirs=...
-Djava.io.tmpdir=...
-Djava.util.logging.manager=...
-Djava.util.logging.config.file=...
-javaagent:C:\FusionReactor\instance\lucee4\fusionreactor.jar=name=lucee4,address=8088
-agentpath:C:\FusionReactor\instance\lucee4\frjvmti_x64.dll
  1. Navigate to the following directory: {Lucee-Home}/bin/.
  2. Locate and open the setenv.sh file with a text editor of your preference.
  3. Add the FusionReactor Java Agent and possibly the FusionReactor Production Debugger inside the setenv.sh file
  4. Save the changes made.
...
# FusionReactor JVM start options. Please do not edit these options.
FR_OPTS="-javaagent:/opt/fusionreactor/instance/lucee4/fusionreactor.jar=name=lucee4,address=8088 -agentpath:/opt/fusionreactor/instance/lucee4/libfrjvmti_x64.so"
export JAVA_OPTS="$JAVA_OPTS $FR_OPTS"
# End of FusionReactor opts

Tomcat

  1. Navigate to the following directory: {Apache-Tomcat-Home}\bin.
  2. Run the TomcatXw.exe program. (Where X is the version number of your tomcat installation).
  3. Access the Java tab and add the FusionReactor Java Agent and possibly the FusionReactor Production Debugger for your server to the bottom of the list in the "Java Options:" field.
  4. Click the Apply button.
  5. Click the OK button.
-Dcatalina.home=...
-Dcatalina.base=...
-Djava.endorsed.dirs=...
-Djava.io.tmpdir=...
-Djava.util.logging.manager=...
-Djava.util.logging.config.file=...
-javaagent:C:\FusionReactor\instance\tomcat8\fusionreactor.jar=address=8088
-agentpath:C:\FusionReactor\instance\tomcat8\frjvmti_x64.dll
  1. Navigate to the following directory: {Apache-Tomcat-Home}/bin/.
  2. Locate the setenv.sh file OR if the file does not exist you can go ahead and create the file.
  3. Open the file with a text editor of you preference.
  4. Add the FusionReactor Java Agent and possibly the FusionReactor Production Debugger values in the setenv.sh file.
  5. Save the changes made.
...
# FusionReactor JVM start options. Please do not edit these options.
FR_OPTS="-javaagent:/opt/fusionreactor/instance/tomcat8/fusionreactor.jar=address=8088 -agentpath:/opt/fusionreactor/instance/tomcat8/libfrjvmti_x64.so"
export JAVA_OPTS="$JAVA_OPTS $FR_OPTS"
# End of FusionReactor opts

Standalone jar

  1. Add the FusionReactor JVM arguments to your run command for the jar

Example:

    java -javaagent:/opt/fusionreactor/instance/myInstance/fusionreactor.jar=name=myInstance,address=8088 -agentpath:/opt/fusionreactor/instance/myInstance/libfrjvmti_x64.so -jar app.jar

IDE

  1. Edit or create a run command for your application
  2. In your run configuration, append the FusionReactor JVM arguments to your runtime / VM arguments

For example:

Jboss / WildFly

  1. Navigate to the following directory: {JBoss/Wildfly-Home}/bin/.
  2. Locate and open the standalone.conf file with a text editor of your preference.
  3. Add the FusionReactor Java Agent and possibly the FusionReactor Production Debugger in the standalone.conf file and preferably at the bottom.
  4. Save the changes made.
...
JAVA_OPTS="$JAVA_OPTS -javaagent:C:\FusionReactor\instance\jboss7s\fusionreactor.jar=name=jboss7s,address=8088  -agentpath:C:\FusionReactor\instance\jboss7s\frjvmti_x64.dll"

Jetty

  1. Navigate to the following directory: {Jetty-Home}/bin/.
  2. Locate and open the start.ini file with a text editor of your preference.
  3. Add the FusionReactor Java Agent in the start.ini file at the bottom, preferably below the "--exec". In case the "--exec" is not in your start.ini file, add it to the bottom of the file and afterwards add the FusionReactor Java Agent below it.
  4. Save the changes made.
...

--exec
-javaagent:/opt/fusionreactor/instance/jetty7/fusionreactor.jar=address=8088 -agentpath:/opt/fusionreactor/instance/jetty7/libfrjvmti_x64.so

Glassfish / Payara

  1. Navigate to the following directory: {Glassfish-Home}\glassfish\domains\domain1\config.
  2. Locate and open the domain.xml file with a text editor of your preference.
  3. Add the FusionReactor Java Agent and possibly the FusionReactor Production Debugger inside the "". Please make sure that all the Java Arguments are on the same line.
  4. Save the changes made.
...
<java-config debug-options="-Xdebug -Xrunjdwp:transport=dt-socket,server=y,suspend=n,address=9009" system-classptah="" classpath-suffix="">
...
<jvm-options>...</jvm-options>
<jvm-options>...</jvm-options>
<jvm-options>-javaagent:C:\FusionReactor\instance\domain1.GF4.1.1\fusionreactor.jar=name=domain1.GFf.1.1,address=8088</jvm-options>
<jvm-options>-agentpath:C:\FusionReactor\instance\domain1.GF4.1.1\frjvmti_x64.dll</jvm-options>
<jvm-options>...</jvm-options>
<jvm-options>...</jvm-options>
...
</java-config>
...