[frs-199] 64bit FusionReactor Support (including ColdFusion 8 on 64 bit platforms)


Problem

When FusionReactor is installed onto a 64bit version of Java (used for example on ColdFusion 8 servers on 64bit machines) the native library will not load as the shipped version is 32bit and therefore incompatible.

The error on a Windows 64 bit server may be for example:

user FusionReactor Exception: C:JRun4binFusionReactor.dll: Can't load IA 32-bit .dll on a AMD 64-bit platform
java.lang.UnsatisfiedLinkError: C:JRun4binFusionReactor.dll: Can't load IA 32-bit .dll on a AMD 64-bit platform
 at java.lang.ClassLoader$NativeLibrary.load(Native Method) 

Resolution.

You can replace the 32bit version of the native library with the 64bit version by simply copying the new library over the original.

Operating System Download
Windows FusionReactor.dll
Linux libFusionReactor.so
Solaris libFusionReactor.sparc.so
OS X libFusionReactor.jnilib

How do I apply the hotfix?

  • Locate the original native library. Seach for the native library (eg. FusionReactor.dll) under the monitored server's installation folder (e.g. on a ColdFusion 8 server the CF installation folder may be C:ColdFusion8). Here are the locations of where the DLL is typically installed on some sample servers:
Installation Type Location
Standalone ColdFusion 6.1 <CFMX>runtimebin or <CFMX>lib (make sure that you only have the FusionReactor.dll in one of these locations)
Standalone ColdFusion 7 <CFMX>runtimebin or <CFMX>lib (make sure that you only have the FusionReactor.dll in one of these locations)
Standalone ColdFusion 8 <CFMX>runtimebin or <CFMX>lib (make sure that you only have the FusionReactor.dll in one of these locations)
Multi Server ColdFusion <JRUN>bin
JRun4 <JRUN4>bin
Tomcat 4,5,6 <TOMCAT>bin
JBoss 3,4,4.2,5 <JBOSS>bin
Jetty <JETTY>
Servlet Exec AS5,6 <SERVLETEXEC>bin
Railo Railix, Express <RAILO>
Railo Resin <RAILO>win32>
  • Stop the monitored server (e.g. ColdFusion, Tomcat, JBoss etc)
  • Backup the current native library file from it's current location (see above) to the desktop (in case of problems, this file can be restored).
  • Replace the current native library file with the hotfix native library file, overwriting the original.
  • Copy the hotfix native library file into the folder <FUSIONREACTOR>/etc/lib (e.g. C:FusionReactoretclib), overwriting the copy that is already there. (This file is used for new instances installed via the instance manager.)
  • Restart the monitored server (e.g. ColdFusion, Tomcat, JBoss etc)

Please note that the new library is for 64bit Java VM versions and NOT for 32bit Java VMs running on 64bit hardware/operating systems.

Issue Details

Type: Technote
Issue Number: FRS-199
Components: CPU + Memory
Environment:
Resolution: Fixed
Last Updated: 21/Jul/08 6:13 PM
Affects Version: 3.0
Fixed Version: 3.0
Server: ColdFusion 8
Platform:
Related Issues: