Java/Lucee/CFML & databases

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

Step 1: Add FusionReactor to your image

a) Make the FusionReactor instance directory

Note

Ensure that you always use the latest version of FusionReactor.

Windows

mkdir -p C:\\FusionReactor\instance\{name}
curl -o C:\\FusionReactor\instance\{name}\fusionreactor.jar https://download.fusionreactor.io/FR/Latest/fusionreactor.jar
curl -o C:\\FusionReactor\instance\{name}\frjvmti_x64.dll https://download.fusionreactor.io/FR/Latest/frjvmti_x64.dll

Linux

mkdir -p /opt/fusionreactor/instance/{name}
curl -o /opt/fusionreactor/instance/{name}/fusionreactor.jar https://download.fusionreactor.io/FR/Latest/fusionreactor.jar
curl -o /opt/fusionreactor/instance/{name}/frjvmti_x64.dll https://download.fusionreactor.io/FR/Latest/frjvmti_x64.dll

MacOS

mkdir -p /Applications/fusionreactor/instance/{name}
curl -o /Applications/fusionreactor/instance/{name}/fusionreactor.jar https://download.fusionreactor.io/FR/Latest/fusionreactor.jar
curl -o /Applications/fusionreactor/instance/{name}/frjvmti_x64.dll https://download.fusionreactor.io/FR/Latest/frjvmti_x64.dll

b) 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

c) Add FusionReactor to the JVM arguments

Info

App servers use different methods to do this and we advise reading the Manual configuration examples

ENV JAVA_OPTS="-javaagent:/opt/fusionreactor/instance/{name}/fusionreactor.jar=name=tomcat,address=8088 -agentpath:/opt/fusionreactor/instance/{name}/libfrjvmti_x64.so"

d) Start your application server

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

Install FusionReactor on Java from FusionReactor APM on Vimeo.

Step 2: Install the Observability Agent

The Observability Agent provides you with the necessary tools and insights to effectively monitor, manage, and optimize your applications, leading to improved reliability, performance, and user experience. During the install you'll be prompted to configure databases and frameworks you wish to monitor.

Info

Latest release

How to install the observability Agent locally from FusionReactor APM on Vimeo.

Windows

To download and run the installer, open powershell admin terminal, navigate to your desired download folder and run:

Invoke-WebRequest -Uri "https://github.com/intergral/observability-agent/releases/latest/download/observability-agent-autoconf.ps1" -OutFile "observability-agent-autoconf.ps1"
.\observability-agent-autoconf.ps1

Info

The installer for Windows assumes you are installing Grafana Alloy in the default location on the C drive. This is required for the config file to be placed in the correct location for Grafana Alloy to read it.

Linux

To download and run the installer, in a terminal, run:

curl -O -L "https://github.com/intergral/observability-agent/releases/latest/download/observability-agent-autoconf.sh"
chmod a+x "observability-agent-autoconf.sh"
sudo /bin/bash observability-agent-autoconf.sh

Further options

Learn more

Further options are available when installing the Observability Agent.