[frs-229] When Using Mac OS X 10.6 (“Snow Leopard”), FusionReactor Can’t Load Native Library


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.


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.

Issue Details

Type: Technote
Issue Number: FRS-229
Components: Metrics
Resolution: Fixed
Last Updated: 28/Sep/09 9:45 AM
Affects Version:
Fixed Version: 3.5
Related Issues:

Comments are closed.