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

Introduction


The documentation provides a step-by-step guide of the process of installing the Debug native library in order to use the Production Debug functionality in FusionReactor.   If you use the FusionReactor Installer the native libraries will be installed automatically, however if you are manually installing FusionReactor, for example in a AWS deployment, you need to deploy the additional lib file and configure it.

If you haven't installed FusionReactor manually,  please follow the link below before you start installing the native library for the Production Debugger feature.

Note that the Production Debugger library must be installed when using a FusionReactor edition that supports use of the Production Debugger: the FusionReactor Trial, Ultimate, and Developer Editions.

Deploying


Please note that the Production Debugger does NOT support 32-bit operating systems or 32-bit versions of java running on 64-bit operating systems.

If you don't have a copy of the native library, please access the FusionReactor website here and click the option "Step 2: Download the Required Debug Libraries".

If you have a FusionReactor Portal account, navigate to the Downloads area and get the Debug Native Libraries file. The FusionReactor Portal can be found here.

When you download the Debug Native Libraries make sure you unzip the folder. The screenshot below present the all the debug libraries.

 LibraryOperating System
libfrjvmti_x64.soLinux 64-bit
libfrjvmti_x64.dylibMacOS 64-bit
frjvmti_x64.dllWindows 64-bit
  1. Copy the appropriate Debug library for your environment.
  2. Access the following directory; {FusionReactor Directory}/instance/{instance name}/.
  3. Paste the debug library in the directory mentioned in step 2.

Apache Tomcat 8 - Windows Example

For this example, I have already download and unzip "Debug Native Libraries" file. The next step is to access the following directory C:\FusionReactor\instance\tomcat8\ and paste the "frjvmti_x64.dll" file.

Apache Tomcat 8 - Linux Example

For this example, I have already download and unzip "Debug Native Libraries" file. The next step is to access the following directory /opt/fusionreactor/instance/tomcat8/ and paste the "libfrjvmti_x64.so" file.

Configuration


Please follow the steps below in order to add the agent path needed for the Production Debugger in the JVM arguments file.

  1. Stop the application server.
  2. Access the JVM arguments file.
  3. Open the JVM arguments file with a text editor of your preference and add the Production Debug library path.
    1. Standard JVM argument paths

      Linux Example: "-agentpath:/{DIRECTORY-PATH}/fusionreactor/instance/{INSTANCE-NAME}/libfrjvmti_x64.so"
      Windows Example: "-agentpath:{DIRECTORY-PATH}\FusionReactor\instance\{INSTANCE-NAME}\frjvmti_x64.dll"
    2. ApacheTomcat 8 Example - JVM argument paths

      Linux Example: "-agentpath:/opt/fusionreactor/instance/tomcat8/libfrjvmti_x64.so"
      Windows Example: "-agentpath:C:\FusionReactor\instance\tomcat8\frjvmti_x64.dll"
  4. Save the changes.
  5. Start the application server.

You need to add the native library into your java arguments the same way that the {FusionReactor Java Agent} is configured. You must add the -agentpath argument which points to the correct library for your operating system. e.g.  You must have both the -agentpath and -javaagent configured for Debug to work. For more information, please check out the following link, Manually install FusionReactor.

Compatibility


Java allows only ONE debugger at a time to be used. If you use JDWP (Java Debug Wire Protocol) you need to disable it to use FusionReactor Production Debugger. Having 2 configured will result in a warning from FusionReactor Production Debugger saying it cannot acquire the capabilities to debug the java server.

Please remove lines like this from the java arguments:

-Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8000

OR

-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=12345

JDWP may be written to the config by the server if you are running ColdFusion and have the Line Debugger enabled. This can be disabled at Debugging & Logging > Debugger Settings > Allow Line Debugging in the ColdFusion Admin Panel.

  • No labels