IBM Support

Mustgather: Setup for diagnosing a Java application crash problem on Linux

Technote (troubleshooting)


Problem(Abstract)

If your Java application crashes on a Linux operating system, there are a number of diagnostic data files that are useful for diagnosing the problem. This mustgather document describes about the required settings to be in place in order to generate those diagnostic data files.

Resolving the problem

In order to collect the diagnostic data files required for diagnosing the crash problems, check that the following specific settings are configured before running your application:
1. Enable javacore generation
2. Enable core dump generation
3. Enable snap trace generation
4. Install the gdb tool.

Please note that all the javacore, core dump and snap trace generation can be enabled using the below single Xdump option:
-Xdump:java+system+snap:events=gpf+abort

For more details about enabling these settings, please see the related information links.

An easier way to collect these mustgathers is to use the IBM® Monitoring and Diagnostic Tools for Java - Diagnostics Collector.

Using the IBM Monitoring and Diagnostic Tools for Java - Diagnostics Collector

Information about installing and configuring the Diagnostics Collector is provided at:
https://www-01.ibm.com/support/knowledgecenter/SSYKE2_7.0.0/com.ibm.java.lnx.70.doc/diag/tools/diag_collector.html

Ideally, install the IBM Diagnostics Collector at the same time as your Java application is installed and setup. The reason is to collect first failure data immediately from the application run. The IBM Diagnostics Collector produces an archive containing all the information required for Java first pass analysis.

NOTE: From Java 8 releases, the diagnostic collector utility tool is removed. Instead, IBM® Support Assistant Data Collector can be used.

Related information

Core dump
Javacore
Diagnostics Collector
IBM® Support Assistant Data Collector

Document information

More support for: Runtimes for Java Technology
Crash

Software version: 5.0, 6.0, 6.1, 7.0, 7.1, 8.0

Operating system(s): Linux

Software edition: J2SE

Reference #: 1222461

Modified date: 16 November 2016