Page tree
Skip to end of metadata
Go to start of metadata

For other installation types, see:

IBM WebSphere Liberty Profile 9.0

Introduction


This section will guide users through the process of manually installing FusionReactor based on their environment and also based on the application server they are using. The examples below are the  "-agentpath" argument which is related to the native library used for the Production Debugger. More information about the Production Debugger can be found in the following link, Production Debugger.

Servers


Apache Tomcat (7 / 8 / 9)

Windows

  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.

Example

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
-agentpath:C:\FusionReactor\instance\tomcat8\frjvmti_x64.dll

Linux

  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.

Example

Linux setenv.sh
...
# 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

ColdFusion (9 / 10 / 11 / 2016 / 2018)

 

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. Navigate to the following directory;
    1. ColdFusion9:
      1. {ColdFusion_Home}/runtime/bin
    2. ColdFusion 10/11/2016/2018:
      1. {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.

Example

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 -agentpath:C:\FusionReactor\instance\cfusion.CF10.1.1\frjvmti_x64.dll

...

ColdFusion 9 Solr

Windows

  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.

Example

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

Linux

  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.

Example

  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 -agentpath:/opt/fusionreactor/instance/cf9-solr/libfrjvmti_x64.so"
...

ColdFusion (10 / 11) Solr

Windows

  1. Navigate to the following directory; {ColdFusion_Home}\cfusion\jetty\.
  2. Locate and open the jetty.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.

Example

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\cf10-solr\fusionreactor.jar=name=cf11-solr,address=8088 -agentpath:C:\FusionReactor\instance\cf10-solr\frjvmti_x64.dll
...

Linux

  1. Navigate to the following directory; {ColdFusion_Home}/cfusion/jetty/.
  2. Locate and open the cfjetty 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.

Example

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/cf10-solr/fusionreactor.jar=name=cf11-solr,address=8088  -agentpath:/opt/fusionreactor/instance/cf10-solr/libfrjvmti_x64.so"
...

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. 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.

Example

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:/opt/fusionreactor/instance/coldfusion9-multi/fusionreactor.jar=address=8088 -agentpath:/opt/fusionreactor/instance/coldfusion9-multi/libfrjvmti_x64.so

Glassfish 4

Windows

  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 "<java-config>". Please make sure that all the Java Arguments are on the same line.
  4. Save the changes made.

Example

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>-agentpath:C:\FusionReactor\instance\domain1.GF4.1.1\frjvmti_x64.dll</jvm-options>

<jvm-options>...</jvm-options>

<jvm-options>...</jvm-options>

...

</java-config>

...

Linux

  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 "<java-config>". Please make sure that all the Java Arguments are on the same line.
  4. Save the changes made.

Example

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>-agentpath:/opt/fusionreactor/instance/domain1.GF4.1.1/libfrjvmti_x64.so</jvm-options>
<jvm-options>...</jvm-options>
<jvm-options>...</jvm-options>
...

</java-config>

...

With some glassfish servers the default trust store can affect license activation. For more information, please check out the link below.

Lucee (4 / 5)

Windows

  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.

Example

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
-agentpath:C:\FusionReactor\instance\lucee4\frjvmti_x64.dll

Linux

  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.

Example

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 -agentpath:/opt/fusionreactor/instance/lucee4/libfrjvmti_x64.so"
export JAVA_OPTS="$JAVA_OPTS $FR_OPTS"
# End of FusionReactor opts

Railo 3

Windows

  1. Navigate to the following directory; {Railo_Home}\tomcat\bin\.
  2. Locate and run the Railow.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.

Example
 

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
-agentpath:C:\FusionReactor\instance\railo3\frjvmti_x64.dll

Linux

  1. Navigate to the following directory; {Railo_Home}/tomcat/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.

Example

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  -agentpath:/opt/fusionreactor/instance/railo3/libfrjvmti_x64.so"
export JAVA_OPTS="$JAVA_OPTS $FR_OPTS"
# End of FusionReactor opts

Railo 4

Windows

  1. Navigate to the following directory; {Railo_Home}\tomcat\bin\.
  2. Locate and run the Railow.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.

Example
 

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
-agentpath:C:\FusionReactor\instance\railo4\frjvmti_x64.dll

Linux

  1. Navigate to the following directory; {Railo_Home}/.
  2. Locate and open the start file with a text editor of your preference.
  3. Add the FusionReactor Java Agent and possibly the FusionReactor Production Debugger inside the start file.
  4. Save the changes made.

Example 

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 -agentpath:/opt/fusionreactor/instance/railo4/libfrjvmti_x64.so -jar start.jar

JBoss 7 Standalone & WildFly (8 / 9 / 10)

  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.

Example

Windows standalone.conf

...

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

Jetty (7 / 8 / 9)

  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.

Example

Linux start.ini
...


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

FusionAnalytics

  1. Navigate to the following directory; {FusionAnalytics_Home}/Server/bin/.
  2. Locate and open the "FusionAnalytics Server.vmoptions" with a text editor of your preference.
  3. Add the FusionReactor Java Agent and possibly the FusionReactor Production Debugger at the bottom of the file.
  4. Save the changes made.

Example

Windows  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\fusionanalytics\fusionreactor.jar=name=default.fa-server.1.1,address=8088

-agentpath:C:\FusionReactor\instance\fusionanalytics\frjvmti_x64.dll


  • No labels