Skip to end of metadata
Go to start of metadata

Introduction


FusionReactor has automatic installers for all application servers listed as supported for version 6.0.0, Including Tomcat, Jetty, Railo, and ColdFusion. These servers can be automatically installed using Instance Manager, sparing you the trouble of manually installing. More details can be found on the FusionReactor Installer page.

If you would like to continue installing your servers manually, please see the specific server type below for instructions on possible configuration files to place your FusionReactor Java Agent into.

Apache Tomcat (7 / 8)


Windows

  1. Inside your <Apache_Tomcat_Home>/bin/ directory
  2. Run the TomcatXw.exe program. (Where X is the version number of your tomcat installation).
  3. Within the program, on the 'Java' tab, add the FusionReactor Java Agent for your server to the bottom of the list in the 'Java Options:' field.

    Windows Java Options

    -Dcatalina.home=...
    -Dcatalina.base=...
    -Djava.endorsed.dirs=...
    -Djava.io.tmpdir=...
    -Djava.util.logging.manager=...
    -Djava.util.logging.config.file=...
    <FusionReactor Java Agent>

  4. Hit 'Apply' then 'Ok'.
  5. An example model for what the Java Options field should look like:

    Windows Java Options

    -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

Linux

  1. Inside your <Apache_Tomcat_Home>/bin/ directory

  2. Edit the file setenv.sh, or if the file does not exist you can go ahead and create the file

  3. Add the FusionReactor Java Agent values in the setenv.sh file

    Linux setenv.sh

    ...
    # FusionReactor JVM start options. Please do not edit these options.
    FR_OPTS="<FusionReactor Java Agent>"
    export JAVA_OPTS="$JAVA_OPTS $FR_OPTS"
    # End of FusionReactor opts

  4. An example model setenv.sh:

    Linux setenv.sh

    ...
    # FusionReactor JVM start options.Please do not edit these options.
    FR_OPTS="-javaagent:/opt/fusionreactor/instance/Tomcat8/fusionreactor.jar=address=8088"
    export JAVA_OPTS="$JAVA_OPTS $FR_OPTS"
    # End of FusionReactor opts

ColdFusion (9 / 10 / 11 / 2016)


Windows & Linux

ColdFusion (9 / 10 / 11) on the Windows Operating System

If the Java Argument contains backward slashes (\) the server will interpret this as an attempt to escape the character that follows, meaning that the server will refuse to start.
These slashes should be escaped (\\) or reversed (/) in order for the server to work.
  1. Inside the directory:
    1. for ColdFusion 9:
      1. <ColdFusion_Home>/runtime/bin/ 
    2. for ColdFusion 10|11|2016:
      1. <ColdFusion_Home>/cfusion/bin/ 
  2. Edit the file jvm.config
  3. Place the FusionReactor Java Agent at the end of the line after '# Arguments to VMx'. Ensure all the Java Arguments are on the same line!

    Windows / Linux jvm.config

    ...

    # 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 <FusionReactor Java Agent>

    ...

  4. An example model jvm.config (Windows - using reversed slashes): 

    Windows / Linux jvm.config

    ...

    # 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.CF10.1.1/fusionreactor.jar=name=cfusion.CF10.1.1,address=8088

    ...

ColdFusion 9 Solr


Windows

  1. Inside the <ColdFusion_Home>/solr/ directory
  2. Edit the file solr.lax
  3. Place the FusionReactor Java Agent at the end of the line beginning with 'lax.nl.java.option.additional='. Ensure all the Java Arguments are on the same line!

    Windows solr.lax

    ...

    lax.nl.java.option.additional=-server -Xmx256m -XX:+AggressiveOpts -XX:+ScavengeBeforeFullGC -XX:-UseParallelGC -DSTOP.PORT=8079 -DSTOP.KEY=cfstop -Dsolr.solr.home=multicore FusionReactor Java Agent

    ...

  4. An example model solr.lax:

    Windows solr.lax

    ...

    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:\opt\FusionReactor\instance\cf9-solr\fusionreactor.jar=name=cf9-solr,address=8088

    ...

Linux

  1. Inside the <ColdFusion_Home>/solr/ directory
  2. Edit the file cfsolr.
  3. Place the FusionReactor Java Agent at the end of the line after '# JVM Args'. Ensure all the Java Arguments are on the same line!

    Linux cfsolr

    ...

    # JVM Args
    JVMARGS="-XX:+AggressiveOpts -XX:+ScavengeBeforeFullGC -XX:-UseParallelGC -Xmx256m -Dsolr.solr.home=multicore -DSTOP.PORT=8079 -DSTOP.KEY=cfsolrstop <FusionReactor Java Agent>"

    ...

  4. An example cfsolr:

    Linux cfsolr

    ...

    # 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"

    ...

ColdFusion (10 / 11) Solr


Windows

  1. Inside the <ColdFusion_Home>/cfusion/jetty/ directory
  2. Edit the file jetty.lax
  3. Place the FusionReactor Java Agent at the end of the line beginning with 'lax.nl.java.option.additional='. Ensure all the Java Arguments are on the same line!

    Windows jetty.lax

    ...

    lax.nl.java.option.additional=-server -Xmx256m -XX:+AggressiveOpts -XX:+ScavengeBeforeFullGC -XX:-UseParallelGC -DSTOP.PORT=8079 -DSTOP.KEY=cfstop -Dsolr.solr.home=multicore <FusionReactor Java Agent>

    ...

  4. An example model jetty.lax:

    Windows jetty.lax

    ...

    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\cf11-solr\fusionreactor.jar=name=cf11-solr,address=8088

    ...

Linux

  1. Inside the <ColdFusion_Home>/cfusion/jetty/ directory
  2. Edit the file cfjetty.
  3. Place the FusionReactor Java Agent at the end of the line after '# JVM Args'. Ensure all the Java Arguments are on the same line!

    Linux cfjetty

    ...

    # JVM Args
    JVMARGS="-XX:+AggressiveOpts -XX:+ScavengeBeforeFullGC -XX:-UseParallelGC -Xmx512m -Dsolr.solr.home=multicore -DSTOP.PORT=$STOPPORT -DSTOP.KEY=cfsolrstop <FusionReactor Java Agent>"

    ...

  4. An example cfjetty:

    Linux cfjetty

    ...

    # JVM Args
    JVMARGS="-XX:+AggressiveOpts -XX:+ScavengeBeforeFullGC -XX:-UseParallelGC -Xmx512m -Dsolr.solr.home=multicore -DSTOP.PORT=8079 -DSTOP.KEY=cfsolrstop -javaagent:/opt/fusionreactor/instance/cf11-solr/fusionreactor.jar=name=cf11-solr,address=8088"

    ...

ColdFusion 9 Multi


ColdFusion 9 Multi on the Windows Operating System

If the Java Argument contains backward slashes (\) the server will interpret this as an attempt to escape the character that follows, meaning that the server will refuse to start.
These slashes should be escaped (\\) or reversed (/) in order for the server to work.

Each instance must have its own jvm.config file, please see here for more information on how to do this.

  1. Inside <ColdFusion_Multi_Home>/bin/ directory
  2. Edit the new jvm.config file you created
  3. Place the FusionReactor Java Agent at the end of the line after "# Arguments to VMx". Ensure all the Java Arguments are on the same line!

    Windows / Linux Jvm.config

     # 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 FusionReactor Java Agent
  4. An example jvm.config (in Windows - using escaped slashes):

    Windows / Linux Jvm.config

     # 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.CF10.1.1\\fusionreactor.jar=name=cfusion.CF10.1.1,address=8088

Glassfish 4


Windows

  1. Inside the <Glassfish_Home>/glassfish/domains/domain1/config/ directory
  2. Edit the file domain.xml
  3. Place the FusionReactor Java Agent inside the <java-config> tags

    Windows domain.xml

    ...

    <jvm-options><FusionReactor Java Agent></jvm-options>

    ...

  4. An example model domain.xml:

    Windows domain.xml

    ...

    <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>...</jvm-options>
    <jvm-options>...</jvm-options>

    ...

    </java-config>

    ...

    With some glassfish servers the default trust store can affect license activation.  See the following link for more information:

Linux

  1. Inside the <Glassfish_Home>/glassfish/domains/domain1/config/ directory
  2. Edit the file domain.xml.
  3. Place the FusionReactor Java Agent inside the <java-config> tags

    Linux domain.xml

    ...

    <jvm-options><FusionReactor Java Agent></jvm-options>

    ...

  4. An example domain.xml:

    Linux domain.xml

    ...

    <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:/opt/fusionreactor/instance/domain1.GF4.1.1/fusionreactor.jar=name=domain1.GFf.1.1,address=8088</jvm-options>
    <jvm-options>...</jvm-options>
    <jvm-options>...</jvm-options>

    ...

    </java-config>

    ...

    With some glassfish servers the default trust store can affect license activation.  See the following link for more information:

Railo 3


Windows

  1. Inside your <Railo_Home>/tomcat/bin/ directory
  2. Run the Railow.exe program.
  3. Within the program, on the 'Java' tab, add the FusionReactor Java Agent for your server to the bottom of the list in the 'Java Options:' field.

    Windows Java Options

    -Dcatalina.home=...
    -Dcatalina.base=...
    -Djava.endorsed.dirs=...
    -Djava.io.tmpdir=...
    -Djava.util.logging.manager=...
    -Djava.util.logging.config.file=...
    <FusionReactor Java Agent>

  4. Hit 'Apply' then 'Ok'.
  5. An example model for what the Java Options field should look like:

    Windows Java Options:

    -Dcatalina.home=...
    -Dcatalina.base=...
    -Djava.endorsed.dirs=...
    -Djava.io.tmpdir=...
    -Djava.util.logging.manager=...
    -Djava.util.logging.config.file=...
    -javaagent:C:\FusionReactor\instance\railo3\fusionreactor.jar=name=railo3,address=8088

Linux

  1. Inside your <Railo_Home>/tomcat/bin/ directory

  2. Edit/Create the file setenv.sh

  3. Place the  FusionReactor Java Agent inside the setenv.sh file, at the bottom:

    Linux setenv.sh

    ... 

    # FusionReactor JVM start options. Please do not edit these options.
    FR_OPTS="<FusionReactor Java Agent>"

    export JAVA_OPTS="$JAVA_OPTS $FR_OPTS"
    # End of FusionReactor opts 

  4. An example model setenv.sh:

    Linux setenv.sh

    ... 

    # FusionReactor JVM start options. Please do not edit these options.
    FR_OPTS="-javaagent:/opt/fusionreactor/instance/railo3/fusionreactor.jar=name=railo3,address=8088"

    export JAVA_OPTS="$JAVA_OPTS $FR_OPTS"
    # End of FusionReactor opts 

Railo 4


Windows

  1. Inside your <Railo_Home>/tomcat/bin/ directory
  2. Run the Railow.exe program.
  3. Within the program, on the 'Java' tab, add the FusionReactor Java Agent for your server to the bottom of the list in the 'Java Options:' field.

    Windows Java Options

    -Dcatalina.home=...
    -Dcatalina.base=...
    -Djava.endorsed.dirs=...
    -Djava.io.tmpdir=...
    -Djava.util.logging.manager=...
    -Djava.util.logging.config.file=...
    <FusionReactor Java Agent>

  4. Hit 'Apply' then 'Ok'.
  5. An example model for what the Java Options field should look like:

    Windows Java Options

    -Dcatalina.home=...
    -Dcatalina.base=...
    -Djava.endorsed.dirs=...
    -Djava.io.tmpdir=...
    -Djava.util.logging.manager=...
    -Djava.util.logging.config.file=...
    -javaagent:C:\FusionReactor\instance\railo4\fusionreactor.jar=name=railo4,address=8088

Linux

  1. Inside your <Railo_Home>/ directory

  2. Edit the file start

  3. Place the FusionReactor Java Agent inside the start file, at the bottom:

    Linux start

    ... 

    jre/bin/java -Djetty.port=8888 -DSTOP.PORT=8887 -DSTOP.KEY=railo -Xms256M -Xmx1024M <FusionReactor Java Agent> -jar start.jar 

  4. An example model start:

    start

    ... 

    jre/bin/java -Djetty.port=8888 -DSTOP.PORT=8887 -DSTOP.KEY=railo -Xms256M -Xmx1024M -javaagent:/opt/fusionreactor/instance/railo4/fusionreactor.jar=name=railo4,address=8088 -jar start.jar

JBoss 7 Standalone & WildFly (8 / 9)


Windows & Linux

  1. Inside your <JBoss/Wildfly_Home>/bin/ directory
  2. Edit the file standalone.conf
  3. Place the FusionReactor Java Agent inside the standalone.conf file, at the bottom:

    Windows / Linux standalone.conf

    ... 

    JAVA_OPTS="$JAVA_OPTS <FusionReactor Java Agent>"

  4. An example model standalone.conf (in Windows - for JBoss 7 Standalone):

    Windows / Linux standalone.conf

    ... 

    JAVA_OPTS="$JAVA_OPTS -javaagent:C:\FusionReactor\instance\jboss7s\fusionreactor.jar=name=jboss7s,address=8088"

Jetty (7 / 8 / 9)


Windows & Linux

  1. Inside your <Jetty_Home>/ directory
  2. Edit the file start.ini
  3. Place the FusionReactor Java Agent inside the start.ini file, at the bottom, below "--exec":

    1. If "--exec" is not in your start.ini file, add it to the bottom, and then add the FusionReactor Java Agent below it, on the following line.

    Windows / Linux standalone.conf

  4. An example model start.ini (In Windows - for Jetty 7):

    Windows / Linux standalone.conf

    ... 

    --exec
    -javaagent:C:\FusionReactor\instance\jetty7\fusionreactor.jar=name=jetty7,address=8088

Lucee (4 / 5)


Windows

  1. Inside your <Lucee_Home>/tomcat/bin/ directory
  2. Run the Luceew.exe program.
  3. Within the program, on the 'Java' tab, add the FusionReactor Java Agent for your server to the bottom of the list in the 'Java Options:' field.

    Windows Java Options

    -Dcatalina.home=...
    -Dcatalina.base=...
    -Djava.endorsed.dirs=...
    -Djava.io.tmpdir=...
    -Djava.util.logging.manager=...
    -Djava.util.logging.config.file=...
    <FusionReactor Java Agent>

  4. Hit 'Apply' then 'Ok'.
  5. An example model for what the Java Options field should look like:

    Windows Java Options

    -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

Linux

  1. Inside your <Lucee_Home>/bin/ directory

  2. Edit the file setenv.sh, or if the file does not exist you can go ahead and create the file

  3. Place the  FusionReactor Java Agent inside the setenv.sh file, at the bottom:

    Linux setenv.sh

    ... 

    # FusionReactor JVM start options. Please do not edit these options.
    FR_OPTS="<FusionReactor Java Agent>"

    export JAVA_OPTS="$JAVA_OPTS $FR_OPTS"
    # End of FusionReactor opts 

  4. An example model setenv.sh:

    Linux setenv.sh

    ... 

    # FusionReactor JVM start options. Please do not edit these options.
    FR_OPTS="-javaagent:/opt/fusionreactor/instance/lucee4/fusionreactor.jar=name=lucee4,address=8088"

    export JAVA_OPTS="$JAVA_OPTS $FR_OPTS"
    # End of FusionReactor opts 

FusionAnalytics


  1. Inside your <FusionAnalytics_Home>/Server/bin/ directory
  2. Edit the file "FusionAnalytics Server.vmoptions"
  3. Place the FusionReactor Java Agent at the bottom of the file

    Windows / Linux FusionAnalytics Server.vmoptions

    -server
    -Xms128m
    -Xmx768m
    -XX:MaxPermSize=256m
    -Djava.awt.headless=true
    -Dcom.sun.management.jmxremote.port=3333
    -Dcom.sun.management.jmxremote.ssl=false
    -Dcom.sun.management.jmxremote.authenticate=false
    -Dfusionanalytics.datacollector.dirObserver.scanInterval=5000
    -Dfusionanalytics.lm.store=C:/FusionAnalytics/Server/data/falm/falm.store
    -Dgrails.scan.interval=3600000
    <FusionReactor Java Agent>

  4. An example model "FusionAnalytics Server.vmoptions":

    Windows / Linux FusionAnalytics Server.vmoptions

    -server
    -Xms128m
    -Xmx768m
    -XX:MaxPermSize=256m
    -Djava.awt.headless=true
    -Dcom.sun.management.jmxremote.port=3333
    -Dcom.sun.management.jmxremote.ssl=false
    -Dcom.sun.management.jmxremote.authenticate=false
    -Dfusionanalytics.datacollector.dirObserver.scanInterval=5000
    -Dfusionanalytics.lm.store=C:/FusionAnalytics/Server/data/falm/falm.store
    -Dgrails.scan.interval=3600000
    -javaagent:C:\FusionReactor\instance\default.fa-server.1.1\fusionreactor.jar=name=default.fa-server.1.1,address=8088

  • No labels