Metadata Collections & QA

Fixes for Java crashes when running on Linux

If you experience memory filling up or frequent crashes when running the DLESE OAI server using Linux (known issue with Red Hat 9 and other recent versions of Linux), please read the information below about how to fix the issue.

Set the following environmental variable before starting up Tomcat. This can be put in the catalina.sh startup script for Tomcat.

export LD_ASSUME_KERNEL=2.2.5

In addition, you may also need to set the ulimit in the startup script to be:

ulimit -s 2048

For best operation, it is recommended that users install the IBM SDK with the OAI software. More information is provided from the Tomcat and Red Hat release notes below.

Tomcat release notes

Virtual machine crashes can be experienced when using certain combinations of kernel / glibc under Linux with Sun Hotspot 1.2 to 1.3. The crashes were reported to occur mostly on startup. Sun JDK 1.4 does not exhibit the problems, and neither does IBM JDK for Linux.

The problems can be fixed by reducing the default stack size. At bash shell, do "ulimit -s 2048"; use "limit stacksize 2048" for tcsh.

GLIBC 2.2 / Linux 2.4 users should also define an environment variable:
export LD_ASSUME_KERNEL=2.2.5

Additionally, Red Hat Linux 9.0 users should use the same setting, to avoid stability problems.

Red Hat release notes

The Red Had Linux 9 Release Notes has a section about this issue (do a find for 'LD_ASSUME_KERNEL' for the pertinent section): http://www.redhat.com/docs/manuals/linux/RHL-9-Manual/release-notes/x86/

Top

Last updated: 02-14-05