Bug 1249942

Summary:	[docs] Heartbeats for AMQP 1.0 Qpid Messaging API
Product:	Red Hat Enterprise MRG	Reporter:	Michal Toth <mtoth>
Component:	Messaging_Programming_Reference	Assignee:	Scott Mumford <smumford>
Status:	CLOSED ERRATA	QA Contact:	Michal Toth <mtoth>
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	3.2
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2015-10-08 13:11:03 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	1151446

Description Michal Toth 2015-08-04 08:21:45 UTC

Documentation BZ about heartbeat support for AMQP 1.0 Qpid Messaging API.

Original discussion can be found in bugzilla #1151446
Jared's last comment:

(In reply to Ken Giusti from comment #16)
> In summary - the documentation for connection heartbeats is not correct.  We
> should drop the recommendation to set heartbeats to 1/2 the tcp retransmit
> interval.  Applications should be free to determine how long a link remains
> unresponsive - not TCP.
> 
> The semantics column should simply say something like this:
> 
> Requests that heartbeats be sent every N seconds. If two successive
> heartbeats are missed the connection is considered lost and will fail or
> start the reconnect process if configured to do so.

This recommendation is now included in the docs. Thanks for providing this clarifying text, Ken.

http://docbuilder.usersys.redhat.com/19948/#Connection_Options_Reference

Comment 1 Michal Toth 2015-08-04 08:44:27 UTC

Documentation seems ok apart from this minor error:

"Table 20.2. Broker List URL Options" you have there option "heartbeat" which should be "idle_timeout" as this table is for JMS client. 

You have it correctly written at the end of "16.5. Failover Behavior in Java JMS Clients" part, witch example.

Moving "back" to assigned from previous state on_qa (moved by Jared), before creating this documentation bugzilla.
Thank you

Comment 3 Scott Mumford 2015-09-03 00:46:11 UTC

Taking ownership of MRG-M bugs

Comment 6 Michal Toth 2015-09-14 06:09:22 UTC

I have verified the proposed change. Looks good.
Thank you

Comment 8 errata-xmlrpc 2015-10-08 13:11:03 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://rhn.redhat.com/errata/RHEA-2015-1879.html