Skip to content

Manual installation of FusionReactor

Manually installing FusionReactor requires you to directly place the FusionReactor installation files and configure the JVM arguments on your application servers.

Note

Installing FusionReactor manually requires some knowledge of your application server configuration and can be completed in just a few minutes.

Tip

For scenarios where you have VMs or containers running in your environment, such as Hypervisor, Kubernetes, or Rocket, being able to script and install FusionReactor and automatically deploy the latest version of the application is ideal.

Installing FusionReactor

Step 1: Create a directory structure for FusionReactor

To begin installing FusionReactor onto your application server, first create a directory structure for FusionReactor files to be stored within. This directory will contain your logs, configurations and installation files.

Warning

Ensure the user running your application server server has read and write permissions to this directory, otherwise you may be unable to start the application server or save any information such as logs or configuration to disk.

The recommended FusionReactor directory structure is {FusionReactor root}/instance/{Instance Name}.

Tip

You could use a name unique to your server, but you would need to remember it. See below the recommended directory structure:

Platform Path
Windows C:\\FusionReactor\Instance\myInstance
Linux /opt/fusionreactor/instance/myInstance
MacOS /Applications/FusionReactor/instance/myInstance

Step 2: Download the FusionReactor installation files

The installation of FusionReactor requires a Java agent to run the core FusionReactor product when your application starts.

There is also a Debug library that can be optionally added for use of the Debugger and Event Snapshot features.

Download the fusionreactor.jar file and Debug library, here.

!Screenshot

Tip

We recommend installing this argument if you have a trial, ultimate or developer edition to access the full functionality of FusionReactor.

The debug library is a zip file containing the libraries for all supported platforms.

Library Platform
frjvmti_x64.dll Windows
libfrjvmti_x64.so Linux
libfrjvmti_x64.dylib MacOS

Step 3: Place the FusionReactor installation files into the directory structure

With your directory structure configured, place the fusionreactor.jar and debug lib into your newly created instance directory.

Tip

To make configuring the FusionReactor instance quicker, note down the exact path to these files for example: C:\FusionReactor\Instance\myInstance\fusionreactor.jar and C:\FusionReactor\Instance\myInstance\frjvmti_x64.dll.

Note

You only need to copy the debug library specific to your operating system.

Step 4: Stop your application server

JVM arguments for your application server are only read when the server/JRE (Java Runtime Environment) is started. We recommend stopping your application server before adding or modifying any of your JVM arguments.

Step 5: Add additional JVM arguments to your application server configuration

To run FusionReactor, you must add JVM arguments to initialize the FusionReactor installation files.

  • Add a Java agent path (-javaagent argument) pointing to the fusionreactor.jar file.

  • The Debug native library path (-agentpath argument) needs to be pointing to the debug library.

When entering the Java agent path, specify the address and name that the FusionReactor instance will use.

Tip

The name should describe the application server FusionReactor is installed on, for example cf2018 or tomcat9.

The address should be the port and possible IP address of the FusionReactor instance, for example:

  • address=8088 would bind FusionReactor to the address 0.0.0.0:8088 which is bound to all IP address

  • address=127.0.0.1:8088 would bind to 127.0.0.1:8088 which is only accessible on localhost

Below are some examples of adding FusionReactor to a java process that runs a jar file.

Example

Windows:

java -javaagent:C:\FusionReactor\Instance\myInstance\fusionreactor.jar=name=myInstance,address=8088 -agentpath:C:\FusionReactor\Instance\myInstance\frjvmti_x64.dll 

Example

Linux:

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

Example

MacOS:

java -javaagent:/Applications/FusionReactor/instance/myInstance/fusionreactor.jar=name=myInstance,address=8088 -agentpath:/Applications/FusionReactor/instance/myInstance/libfrjvmti_x64.dylib

In order to complete the installation of FusionReactor, you must restart your application server for the changes to the JVM arguments to take effect.

Step 6: Start your application server

With your JVM arguments now modified, FusionReactor should start within the Java process.

To confirm this, view your application logs looking for the FusionReactor block as below:

INFO Fusionreactor: --------------------------------------------------------------------------------------
INFO Fusionreactor: FusionReactor - Copyright (C) Intergral GmbH. All Rights Reserved
INFO Fusionreactor: Revision: {version} fusionreactor.xxxxx.xxxxx
INFO Fusionreactor: Date    :  {date}
INFO Fusionreactor: Java    :  {JRE Version}
INFO Fusionreactor: OS      :  {OS Information}
INFO Fusionreactor: --------------------------------------------------------------------------------------

Typically this log is viewed in your catalina.log or ColdFusion-out.log files, but is dependent on your logging configuration.

Uninstalling FusionReactor

Uninstalling FusionReactor requires removing both the Java agent path and Debug library path from your JVM arguments. Then remove the instance from the FusionReactor Directory.

To do this, follow the steps below:

Step 1: Stop your Application Server

JVM arguments for your Application Server are only read when the server / JRE (Java Runtime Environment) is started. For this reason we recommend that you stop your Application Server before adding or modifying any of your JVM arguments.

Step 2: Remove the JVM arguments for FusionReactor

In order to uninstall FusionReactor the following arguments must be removed:

  • -javaagent:{path}/fusionreactor.jar
  • -agentpath:{path}/{debug library}
  • Any argument beginning with ‘-Dfr’

Step 3: Start the Application Server

Once FusionReactor has been removed, restart the Application server.

Step 4: Remove the FusionReactor installation files (optional)

When FusionReactor is not running, the instance directory can now be removed from the local file system.

If you are using the default installation path, the paths to your instance will be:

Platform Path
Windows C:\\FusionReactor\Instance\myInstance
Linux /opt/fusionreactor/instance/myInstance
MacOS /Applications/FusionReactor/instance/myInstance

Tip

If you are uninstalling FusionReactor as it is not required at this time, skip this step to retain any log and configuration date when you reinstall FusionReactor.


Need more help?

Contact support in the chat bubble and let us know how we can assist.