FusionReactor Technote - FRS-229

Symptoms

When you start up ColdFusion after installing FusionReactor on Mac OS X 10.6 ("Snow Leopard"), you see the following in the ColdFusion server log:

java.lang.UnsatisfiedLinkError: no FusionReactor-macos-x86_64 in java.library.path
	at java.lang.ClassLoader.loadLibrary(ClassLoader.java:1809)
	at java.lang.Runtime.loadLibrary0(Runtime.java:823)
	at java.lang.System.loadLibrary(System.java:1045)
	at com.intergral.fusionreactor.trace.NativeManager.c(NativeManager.java:144)

Cause and Analysis

The FusionReactor Native Library is supplied on a per-architecture basis for each machine architecture on which FusionReactor runs. It enables interaction with operating system features and metrics not normally available to Java.

In this case, the Mac OS X 64-bit variant (FusionReactor-macos-x86_64) could not be located, although it is shipped with FusionReactor 3.5.0. This issue may also occur when using a 32-bit JVM or operating system – the resolution is the same.

The issue occurs because JRun, when launched directly from Terminal, can't locate this library.

Workarounds

The following workarounds are available.

The issue does not occur when:

• ColdFusion is launched using the ColdFusion/bin/coldfusion start command
• ColdFusion is launched using the ColdFusionLauncher Mac OS X application

The issue occurs when:

• ColdFusion is launched using the jrun binary: /ColdFusion/runtime/bin/jrun start coldfusion from Terminal.
  • This can be solved by copying the appropriate .jnilib from the /FusionReactor/etc/lib fiolder to the root of ColdFusion (in this case /ColdFusion), and then starting ColdFusion from that folder:
    • cp /FusionReactor/etc/lib/libFusionReactor-macos-x86_64.jnilib /ColdFusion9
    • cd /ColdFusion9
    • ./runtime/bin/jrun start coldfusion
  • Replace /FusionReactor and /ColdFusion9 with your installed locations.