Bug 711788

Summary:	Missing description of using "cluster-durable queues"
Product:	Red Hat Enterprise MRG	Reporter:	Petra Svobodová <psvobodo>
Component:	Messaging_Programming_Reference	Assignee:	Joshua Wulf <jwulf>
Status:	CLOSED CURRENTRELEASE	QA Contact:	ecs-bugs
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	2.0	CC:	chetan, dryan, iboverma, jwulf, lcarlon, lzhaldyb
Target Milestone:	2.2	Keywords:	Documentation
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2012-09-20 03:13:15 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:

Description Petra Svobodová 2011-06-08 13:44:54 UTC

Description of problem:
There is no description of function and declaration the "cluster-durable queues" in the Messaging User Guide. Declaration and behaviour of the queues are not intuitive; so it important to explain this topic in the documentation.


Version-Release number of selected component (if applicable):
2.0


How reproducible:
n/a


Steps to Reproduce:
1. Try to find description of the "cluster-durable queues" in the Messaging User Guide.

  
Actual results:
The description of the "cluster-durable queues" missing in the Messaging User Guide


Expected results:
The "cluster-durable queues" should be described in the Messaging User Guide.

Additional info:
Please follow the link

http://apache-qpid-users.2158936.n2.nabble.com/Qpid-cluster-durable-queues-td5988904.html

Comment 1 Joshua Wulf 2011-09-02 03:16:11 UTC

Currently Durable queues are described 

in Chapter 3 - http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2.0/html/Messaging_User_Guide/chap-Messaging_User_Guide-Queues.html:
"Durable queues

Queues can be defined as durable. A durable queue is stored in memory, and can survive a restart of the broker. However, messages on the queue must also be declared as persistent for them to be recovered..
There are other options that can be used with durable queues to control the sizing and tuning of the journal used to record queue state on disk. For more information, see Chapter 6, Persistence."

Again, in Chapter 6 - http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2.0/html/Messaging_User_Guide/chap-Messaging_User_Guide-Persistence.html#sect-Messaging_User_Guide-Persistence-Persistent_Messages_Durable_Queues_and_Guaranteed_Delivery: 
" A durable is saved on disk when its server shuts down or fails, and then reestablished when the server re-starts."

Chapter 6 describes creation of a durable queue in C++, but not using qpid-config.

We can add the qpid-config creation command.

Comment 4 Joshua Wulf 2012-07-15 09:43:38 UTC

Cluster Durable Queue description:

http://deathstar1.usersys.redhat.com:8080/TopicIndex/Books/editor/preview.html?skyneturl=http://skynet.usersys.redhat.com:8080/TopicIndex&topicid=6977

Cluster Durable Queue creation using qpid-config:

http://deathstar1.usersys.redhat.com:8080/TopicIndex/Books/editor/preview.html?skyneturl=http://skynet.usersys.redhat.com:8080/TopicIndex&topicid=6978

Also in the updated table of qpid-config options.

Publish to stage coming shortly.

Comment 7 Cheryn Tan 2012-09-20 02:53:47 UTC

Released for MRG 2.2