Bug 711788 - Missing description of using "cluster-durable queues"
Summary: Missing description of using "cluster-durable queues"
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise MRG
Classification: Red Hat
Component: Messaging_Programming_Reference
Version: 2.0
Hardware: Unspecified
OS: Unspecified
unspecified
medium
Target Milestone: 2.2
: ---
Assignee: Joshua Wulf
QA Contact: ecs-bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2011-06-08 13:44 UTC by Petra Svobodová
Modified: 2014-10-19 22:59 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2012-09-20 03:13:15 UTC
Target Upstream Version:


Attachments (Terms of Use)

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


Note You need to log in before you can comment on or make changes to this bug.