Bug 534450 (RHQ-1244)

Summary:	should we enable heap-dump-on-error in both agent and server?
Product:	[Other] RHQ Project	Reporter:	John Mazzitelli <mazz>
Component:	Documentation	Assignee:	RHQ Project Maintainer <rhq-maint>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Mike Foley <mfoley>
Severity:	medium	Docs Contact:
Priority:	low
Version:	unspecified	CC:	cwelton, jshaughn
Target Milestone:	---	Keywords:	FutureFeature
Target Release:	---
Hardware:	All
OS:	All
URL:	http://jira.rhq-project.org/browse/RHQ-1244
Whiteboard:
Fixed In Version:		Doc Type:	Enhancement
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2014-05-02 20:38:46 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description John Mazzitelli 2008-12-10 15:40:00 UTC

Should we start the server and agent with the following VM parameters:

-XX:+HeapDumpOnOutOfMemoryError writes heap dump on OutOfMemoryError (recommended)
-XX:+HeapDumpOnCtrlBreak writes heap dump together with thread dump on CTRL+BREAK 

See: http://wiki.eclipse.org/index.php/MemoryAnalyzer

These are only valid for SUN HotSpot VMs, but since it covers the majority of people's VMs, it might be useful to have this turned on by default in our launcher scripts/configuration.

Comment 1 Red Hat Bugzilla 2009-11-10 20:28:56 UTC

This bug was previously known as http://jira.rhq-project.org/browse/RHQ-1244

Comment 2 Corey Welton 2010-08-06 13:08:17 UTC

Per triage, we are going to doc this for now, provide information on how to enable if necessary.  Deon, please talk with developer to determine the best place to put this, and how to word it.

Comment 3 Deon Ballard 2010-08-06 13:42:19 UTC

I'm changing the component to Documentation for the moment, so it shows up in my queue and I don't forget about it.

Comment 4 Joseph Marques 2010-08-09 04:29:06 UTC

Here is the reference we can include in our documentation
http://www.oracle.com/technetwork/java/javase/tech/vmoptions-jsp-140102.html#DebuggingOptions

We would suggest to people, if they are seeing the server crash due to 
OutOfMemoryError issues, to restart with the following VM options:

-XX:-HeapDumpOnOutOfMemoryError

If the user wants the heap dump file to be dropped in a particular location, 
they can additionally specify:

-XX:HeapDumpPath=./java_pid<pid>.hprof