Skip to content

Quickstart

Step 1 - Register for your free trial

Register for your 14 day free trial of FusionReactor Cloud

Step 2 - Download

Once registered and you can login to your new account.

You can get your license key from the FusionReactor Cloud > Accounts page (accessible from top right menu)

  1. Before you start

    Create a directory for FusionReactor to reside. FusionReactor will use this directory to persist its configuration and unpack some of its dependencies. You need a unique directory for each usage of FusionReactor. I.e INSTANCE_NAME should reflect your server type (tomcat8) or application.

    mkdir C:\FusionReactor\instance\INSTANCE_NAME
    cd C:\FusionReactor\instance\INSTANCE_NAME
    
    mkdir -p /opt/fusionreactor/instance/INSTANCE_NAME
    cd /opt/fusionreactor/instance/INSTANCE_NAME
    
    mkdir -p /opt/fusionreactor/instance/INSTANCE_NAME
    cd /opt/fusionreactor/instance/INSTANCE_NAME
    
    mkdir -p /opt/fusionreactor/instance/INSTANCE_NAME
    cd /opt/fusionreactor/instance/INSTANCE_NAME
    

    Remote Filesystems

    We do not recommend using a remote filesystem for your FusionReactor installation, these can affect performance and can cause configuration file corruption when the connection is lost.

  2. Download

    Go into that directory and download the latest FusionReactor JAR and the debugger native library.

    curl https://intergral-dl.s3-us-west-1.amazonaws.com/FR/Latest/fusionreactor.jar -o fusionreactor.jar
    curl https://intergral-dl.s3-us-west-1.amazonaws.com/FR/Latest/frjvmti_x64.dll -o frjvmti_x64.dll
    
    curl https://intergral-dl.s3-us-west-1.amazonaws.com/FR/Latest/fusionreactor.jar -o fusionreactor.jar
    curl https://intergral-dl.s3-us-west-1.amazonaws.com/FR/Latest/libfrjvmti_x64.so -o libfrjvmti_x64.so
    
    curl https://intergral-dl.s3-us-west-1.amazonaws.com/FR/Latest/fusionreactor.jar -o fusionreactor.jar
    curl https://intergral-dl.s3-us-west-1.amazonaws.com/FR/Latest/libfrjvmti_x64.dylib -o libfrjvmti_x64.dylib
    
    curl https://intergral-dl.s3-us-west-1.amazonaws.com/FR/Latest/fusionreactor.jar -o fusionreactor.jar
    curl https://intergral-dl.s3-us-west-1.amazonaws.com/FR/Latest/libfrjvmti_aarch64.so -o libfrjvmti_aarch64.so
    

    Debugger Native Library

    The debugger native library is needed for the Debugger, Event Snapshot and Memory Profiler features to work which are available in the Ultimate, Developer Editions or using a Trial license. The native library does not support 32-bit operating systems or 32-bit versions of Java running on 64-bit operating systems.

Step 3 - Configuration

To install FusionReactor you need to configure the fusionreactor.jar and optionally the native debug library.

  1. Configure the agents

    You need to add the following java arguments to your run scripts:

    -javaagent:C:/FusionReactor/instance/INSTANCE_NAME/fusionreactor.jar=address=8088
    -agentpath:C:/FusionReactor/instance/INSTANCE_NAME/frjvmti_x64.dll
    
    -javaagent:/opt/fusionreactor/instance/INSTANCE_NAME/fusionreactor.jar=address=8088
    -agentpath:/opt/fusionreactor/instance/INSTANCE_NAME/libfrjvmti_x64.so
    
    -javaagent:/opt/fusionreactor/instance/INSTANCE_NAME/fusionreactor.jar=address=8088
    -agentpath:/opt/fusionreactor/instance/INSTANCE_NAME/libfrjvmti_x64.dylib
    
    -javaagent:/opt/fusionreactor/instance/INSTANCE_NAME/fusionreactor.jar=address=8088
    -agentpath:/opt/fusionreactor/instance/INSTANCE_NAME/libfrjvmti_aarch64.so
    

    Native Library

    You only need to add the native library into your java arguments if you have Ultimate, Developer Editions or using a Trial license.

    Port Number

    1. The address port, 8088, must be different for each instance that you have on the same host.
    2. If you are using a container environment you can expose the port to access the FusionReactor UI.
  2. Configure Admin Password

    To automatically configure the password for the FusionReactor admin users access to the locally FusionReactor UI, you need to add the following java arguments

    -Dfradminpassword=ADMIN_PASSWORD
    

    Note

    • If you do not set this java argument then you will have to set the admin password when you want to use the FusionReactor UI (normally http://localhost:8088)
  3. Configure License Key

    To configure the license key of your FusionReactor instance you can add the following Java System Property.

    -Dfrlicense=CLOUD-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX
    

    Note

    • If you do not set this java argument then you will have to enter it into the About page of the FusionReactor UI (normally http://localhost:8088) and press Apply to license the instance before the FusionReactor UI can be used.
  4. Configure Cloud Group (optional)

    To configure the automatic grouping of your FusionReactor instances you can set the following Java System Property

    -Dfr.cloud.group=Application1
    
  5. Start your application server or java process.

  6. Access the instance locally via http://localhost:8088 and set the admin password and license key (if not preset via the System Properties)

Start monitoring

Within a few minutes your server should appear online and start to push data to FusionReactor Cloud. Be sure to check out the following guides:

Updating an existing FusionReactor instance.

  1. Simply stop your application server or java process.

  2. Download and replace the jar and native libraries.

  3. Start your application server or java process.

Uninstall FusionReactor

  1. Edit your application server configuration file or java process startup script and remove the -D and -javaagent and -agentpath arguments

  2. Restart your application server or Java process.