Traverse: How to enable an automatic memory dump upon a java heap memory exception

Please note that in later revisions of Traverse, some Java based Traverse components may already be enabled for automatic memory dumps.

This table lists the configuration files to be modified for the various Traverse components, while the steps below describe the changes to be made specifically for the DGE component:

Traverse Component 

Configuration file  Dump file
CSE summary.lax oom_cse.hprof
DGE monitor.lax oom_dge.hprof
Web App webapp.lax


Message Handler msgsvr.lax



So to enable the generation of a heap memory dump for the DGE component on a Windows Traverse server:

  1. Save a copy of the file 'TRAVERSE_HOME\bin\monitor.lax' then find the following variable definition in this file, where 'TRAVERSE_HOME' is the Traverse installation location:<parameters omitted for clarity>

  2. Append the command options '-XX:+HeapDumpOnOutOfMemoryError' and '-XX:HeapDumpPath=../logs/oom_dge.hprof' to the end of the line to enable the creation of the memory dump in a file called 'oom_cse.hprof' under 'TRAVERSE_HOME\logs':<some parameters omitted> -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=../logs/oom_dge.hprof

  3. Restart the DGE component to load the additional parameters.

Consult the table above for the correct file to edit for one of the other Traverse components.


For a Linux server,

Traverse Component 

Configuration file  Dump file
CSE summary.init oom_cse.hprof
DGE monitor.init oom_dge.hprof
Web App webapp.init oom_web.hprof

Message Handler msgsvr.init oom_msg.hprof


Look for an entry similar to (for instance in the file <TRAVERSE_HOME>/etc/monitor.init)

JAVACMD="${JAVA_HOME}/bin/java -Xmx1024m -Djava.ext.dirs=${JAVALIB}"

Below such a line, add the following line:

JAVACMD="${JAVACMD} -XX:-UseSplitVerifier -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=../logs/oom_dge.hprof"

Save the file

Restart the component


Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request


Article is closed for comments.