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


The sections listed below will guide readers on how to MANUALLY install FusionReactor in order to monitor an application server. More information about the System Requirements and the Supported Application Servers can be found in the following link, System Requirements.

Please note that if you are installing the FusionReactor TRIAL with a MANUAL installation, you will need to get the FusionReactor JAR file, as well as the Production Debugger LIB file (for your specific environment). Both of these files are necessary if you are using FusionReactor ULTIMATE Edition. For more information on installing the Production Debugger, please check out the link, FusionReactor Production Debugger Installation.

In case you don't want to manually install FusionReactor, you can use the automated installer option which will spare you the trouble of manually installing FusionReactor. For more information, please check out the following link, FusionReactor Full Installer.

Video Tutorial

The video tutorial below is going to guide you through the manual installation process.

This video shows an example installing FusionReactor V5, however the process is exactly the same for the current version and you can follow this tutorial without running into issues. If you have any problems then do not hesitate to contact support.

Getting Started

Download FusionReactor

If you don't have a copy of the latest FusionReactor, please visit the FusionReactor website here and download the FusionReactor.Jar file and the Debug Native Libraries file.

Alternatively, if you have a FusionReactor Portal account, you can access your account, navigate to the Downloads area and get the latest FusionReactor.Jar and the Debug Native Libraries file. The FusionReactor Portal can be found here.

The "Debug Native Libraries" are useful because you will be able to use the Production Debugger feature of FusionReactor and that file contains the following debug libraries.

  LibraryOperating System
libfrjvmti_x64.soLinux 64-bit
libfrjvmti_x64.dylibMacOS 64-bit
frjvmti_x64.dllWindows 64-bit

Manually install the FusionReactor Java Agent and the Debug Native Library

Before we are going to manually install FusionReactor, its important to note the folder structure of; {DIRECTORY-PATH}/fusionreactor/instance/{INSTANCE-NAME}/ is adhered to.


It's recommended that you use the following directory paths.

  • Linux: {DIRECTORY-PATH}/fusionreactor/instance/{INSTANCE-NAME}
    • Apache Tomcat 8 Example - FusionReactor Java Agent: /opt/fusionreactor/instance/tomcat8/
  • Windows: {DIRECTORY-PATH}\fusionreactor\instance\{INSTANCE-NAME}
    • Apache Tomcat 8 Example - FusionReactor Java Agent: C:\FusionReactor\instance\tomcat8\
  1. Create a new directory with the name of the application server that you are using and under the /fusionreactor/instance/ directory.
  2. Copy and paste the fusionreactor.jar and the debug library file in the directory created in step 1.
  3. Stop the application server if it's running.
  4. Locate the JVM arguments file and add the FusionReactor Java Agent path and the Debug Native Library path.
    1. Standard JVM argument path

      Linux Example: "-javaagent:/{DIRECTORY-PATH}/fusionreactor/instance/{INSTANCE-NAME}/fusionreactor.jar=name={NAME},address={PORT} -agentpath:{DIRECTORY-PATH}/fusionreactor/instance/{INSTANCE-NAME}/"
      Windows Example: "-javaagent:{DIRECTORY-PATH}\FusionReactor\instance\{INSTANCE-NAME}\fusionreactor.jar=name={NAME},address={PORT} -agentpath:{DIRECTORY-PATH}\FusionReactor\instance\{INSTANCE-NAME}\frjvmti_x64.dll"
    2. Apache Tomcat 8 Example JVM argument path

      Linux Example: FR_OPTS="-javaagent:/opt/fusionreactor/instance/tomcat8/fusionreactor.jar=name=tomcat8,address=8088 -agentpath:/opt/fusionreactor/instance/tomcat8/"
      export JAVA_OPTS="$JAVA_OPTS $FR_OPTS"
      Windows Example: -javaagent:C:\FusionReactor\instance\tomcat8\fusionreactor.jar=name=tomcat8,address=8088 -agentpath:C:\FusionReactor\instance\tomcat8\frjvmti_x64.dll
  5. Save the changes.
  6. Start the application server. For Windows environments, this can be done by access the Windows Services, for Linux environments this can be done using the run commands for each server.
  7. Access FusionReactor via the browser and by typing http://localhost:{configured port}. An example of that is the following; http://localhost:8088.

Manual Installation/Application Server Examples

For more manual installation examples, please check out the following link, Manual Installation Application Server Examples.


If you are not able to access FusionReactor via the browser, below is a list of common issues that stop FusionReactor from starting.

  1. Make sure that a Firewall configuration/policy is not blocking the traffic on the configured port that FusionReactor is listening.
  2. If you are using IIS, please make sure that the IIS configuration is not blocking the traffic on the configured port that FusionReactor is listening.
  3. Make sure that the application server has started properly. For Windows environments, you can check if the service is running through the Windows Services and for Linux environments by typing something like "ps -ef | grep {The name of the service running}".
  4. Make sure that FusionReactor has enough privileges in order to read/write in the FusionReactor directory. More information about the secure environments can be found in the following link, Secured Environments.

FusionReactor 3.x and 4.x

If you previously used FusionReactor 3.x, 4.x, please follow the instructions listed in the technote below in order to install the latest FusionReactor version.

Un-wrap the JDBC datasources to improve performance and enable compatibility. More information can be found in the link below.

For ColdFusion users, please read the technote below.

See also

  • No labels