ColdFusion (4.5.1 and 5): Server crashes when using JDK 1.3 on Solaris or Linux

Macromedia ColdFusion Server versions 4.5.1 and 5 will crash for customers running JDK 1.3 on Solaris and Linux platforms. ColdFusion customers use JDK to run ColdFusion custom tags (CFX tags) in Java, or the ColdFusion cfobject tag for Java objects. This article describes a workaround for this issue.

Customers experiencing this issue may find the following error message in their server.log:

# HotSpot Virtual Machine Error, Internal Error
# Please report this error at
# http://java.sun.com/cgi-bin/bugreport.cgi
"Fatal","TID=11","01/18/01","09:56:03",
"Caught a fatal signal (11)

Solution

For JDK version 1.3 to work with ColdFusion Server on Solaris or Linux, use the following steps:

For Linux:

1. Add JAVA_HOME to the start script under CFHOME.
   
   The start script is typically located at: /opt/coldfusion/bin under default installations. On Red Hat Linux, if you use the RPM, install JDK in the default location; the JAVA_HOME would be located at:
   
   

   # Set during install
   CFHOME=/opt/coldfusion
   ODBCINI=$CFHOME/odbc/odbc.iniJAVA_HOME=/usr/java/jdk1.3 

   Note: RPM is the native way to install, remove, manage programs on Red Hat Linux systems via the Redhat Package Manager. It will find potential conflicts, prior versions, and so forth. By default, it installs a product according to its default location, specified by the product, which in the case of JDK is located at /usr/java/.
   
   On Red Hat Linux, if you install from the tar.gz file, you can choose the path location. Installing from a tar.gz file unpacks the program wherever the archive is located at the time of execution. For instance, if you chose: /usr/java/jdk1.3/jre/lib/i386/hotspot/libjvm.so as the JDK path location, you would define your JAVA_HOME as JAVA_HOME=/usr/java/jdk1.3.
2. Based on your JAVA_HOME, configure the LD_LIBRARY_PATH within the start script noted in Step 1.
   
   For instance, if your JAVA_HOME is /opt/j2re1_3_0, your LD_LIBRARY_PATH is:
   
   LD_LIBRARY_PATH=$CFHOME/lib:$JAVA_HOME/jre/lib/i386/hotspot:
$JAVA_HOME/jre/lib/i386/native_threads:$JAVA_HOME/jre/lib/i386/
   
   (Although the above snippet appears on two lines, it should be entered as one line.)
3. Go to the ColdFusion Administrator page. Click the Java tab and add/modify the following settings:
   • Java Virtual Machine Path: Specify the path to the libjvm.so (this location varies depending on where you installed the JDK).
   • Add System Option: java.lang.Compiler=NONE
   • Add Implementation Option:-XX:+AllowUserSignalHandlers
4. Stop and restart the ColdFusion processes.

For Solaris:

1. Add JAVA_HOME to the start script under CFHOME.
   
   The start script is typically located at: /opt/coldfusion/bin under default installs. If the JDK was installed with the default settings, the JAVA_HOME would be located at:
   
   

   # Set during install
   CFHOME=/opt/coldfusion
   ODBCINI=$CFHOME/odbc/odbc.iniJAVA_HOME=/opt/j2re1_3_0 

2. Based on your JAVA_HOME, configure the LD_LIBRARY_PATH within the start script noted in Step 1.
   
   For instance, if your JAVA_HOME is /opt/j2re1_3_0, your LD_LIBRARY_PATH is:
   LD_LIBRARY_PATH=$CFHOME/lib:$JAVA_HOME/jre/lib/sparc/hotspot:
$JAVA_HOME/jre/lib/sparc/native_threads:$JAVA_HOME/jre/lib/sparc/
   
   (Although the above snippet appears on two lines, it should be entered as one line.)
   
   In summary, you must add the following entries to the LD_LIBRARY_PATH variable in the start script:
   
   $JAVA_HOME/lib/sparc
$JAVA_HOME/lib/sparc/native_threads
$JAVA_HOME/lib/sparc/hotspot
3. Go to the ColdFusion Administrator. Click the Java tab and add/modify the following settings:
   • The Initial Heap Size setting for the "JVM and Java Settings" must be set at minimum to 4096Kb. The default setting is 1024Kb. With the default setting, the server crashes or becomes unresponsive. Increase this setting.
   • Java Virtual Machine Path: Specify the path to the libjvm.so (this location varies depending on where you installed the JDK). In most cases, the libjvm.so file is located at: $JAVA_HOME/jre/lib/sparc/client/.
   • Add System Option: java.lang.Compiler=NONE.
   • Add Implementation Option: -XX:+AllowUserSignalHandlers.
4. Stop and restart ColdFusion processes.
   
   Note: Ensure that when defining the location of your libjvm.so file in the ColdFusion Administrator to specify the version of the libjvm.so in the /sparc/client directory.

SOURCE:

	http://www.adobe.com/go/tn_17878