Bug 709693

Summary: obsolete info in MRG/M UG
Product: Red Hat Enterprise MRG Reporter: Petr Matousek <pematous>
Component: Messaging_Programming_ReferenceAssignee: Joshua Wulf <jwulf>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: unspecified Docs Contact:
Priority: high    
Version: DevelopmentCC: chetan, dryan, iboverma, lbrindle, lcarlon
Target Milestone: 2.2   
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:12 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Attachments:
Description Flags
actual command outputs none

Description Petr Matousek 2011-06-01 12:25:41 UTC
Description of problem:

1.) Chapter 3. Queues - Configuring queue options:

paragraph 1: "qpid-config queues" output is not up2date

paragraph 2: The possible options of qpid-config utility for adding queues are not up2date

(The actual command output and available options can be found in attachment)

2.) 8.4. The qpid-route utility

The syntax of qpid-route utility is not up2date.

Table 8.1. qpid-route options - missing following options:
--client-sasl-mechanism
-e, --del-empty-link

(The actual command output and available options can be found in attachment)

All of the example commands in section 8.4 shall be checked for correctness, because of the syntax change in qpid route utility.
ie:
- qpid-route flush localhost:10001
+ qpid-route route flush localhost:10001

3.)
Chapter 3. Queues - Last value queues (LVQ NO BROWSE paragraph)
There is a mistyped character:
- ..In this case browsed messaged..
+ ..In this case browsed messages..

4.) Chapter 3. Queues - Last value queues
This is not necessary but for better understanding of the LVQ functionality I suggest to have some example of LVQ functionality, ie:
# qpid-config add queue lvq-q --order=lvq
# qpid-config add queue lvqnb-q --order=lvq-no-browse
 
# ./spout -P qpid.LVQ_key=a --content "a1" lvq-q
# ./spout -P qpid.LVQ_key=b --content "b1" lvq-q
# ./spout -P qpid.LVQ_key=a --content "a2" lvq-q
 
# ./spout -P qpid.LVQ_key=a --content "a1" lvqnb-q
# ./spout -P qpid.LVQ_key=b --content "b1" lvqnb-q
# ./spout -P qpid.LVQ_key=a --content "a2" lvqnb-q
 
# ./drain -c 0 "lvq-q;{mode:browse}"
Message(properties={qpid.LVQ_key:a, spout-id:0256063c-4e8b-443c-ac88-f7ed5bac104b:0, x-amqp-0-10.routing-key:lvq-q}, content='a2')
Message(properties={qpid.LVQ_key:b, spout-id:aeb18428-e4ef-4da2-8acf-f7985420c8da:0, x-amqp-0-10.routing-key:lvq-q}, content='b1')
# ./drain -c 0 "lvqnb-q;{mode:browse}"
Message(properties={qpid.LVQ_key:a, spout-id:0607923b-7e9d-4f5c-aa67-85803ca47f2e:0, x-amqp-0-10.routing-key:lvqnb-q}, content='a2')
Message(properties={qpid.LVQ_key:b, spout-id:7657241f-936b-428f-97f7-aafaee509df7:0, x-amqp-0-10.routing-key:lvqnb-q}, content='b1')
 
# ./spout -P qpid.LVQ_key=a --content "a3" lvq-q
# ./spout -P qpid.LVQ_key=a --content "a3" lvqnb-q
 
# ./drain -c 0 lvq-q
Message(properties={qpid.LVQ_key:a, spout-id:0256063c-4e8b-443c-ac88-f7ed5bac104b:0, x-amqp-0-10.routing-key:lvq-q}, content='a2')
Message(properties={qpid.LVQ_key:b, spout-id:aeb18428-e4ef-4da2-8acf-f7985420c8da:0, x-amqp-0-10.routing-key:lvq-q}, content='b1')
Message(properties={qpid.LVQ_key:a, spout-id:f6c9fb34-b43b-4a82-80f7-4c2189cb5765:0, x-amqp-0-10.routing-key:lvq-q}, content='a3')
# ./drain -c 0 lvqnb-q
Message(properties={qpid.LVQ_key:a, spout-id:07446145-3b9a-4734-90e8-664df16015e8:0, x-amqp-0-10.routing-key:lvqnb-q}, content='a3')
Message(properties={qpid.LVQ_key:b, spout-id:7657241f-936b-428f-97f7-aafaee509df7:0, x-amqp-0-10.routing-key:lvqnb-q}, content='b1')

Version-Release number of selected component (if applicable):
Red Hat Enterprise MRG 2.0 - Messaging User Guide
Revision 0.1-7

How reproducible:
n/a

Steps to Reproduce:
n/a
  
Actual results:
Obsolete informations in MRG/M UG

Expected results:
MRG/M UG is up2date

Additional info:

Comment 1 Petr Matousek 2011-06-01 12:33:53 UTC
Created attachment 502243 [details]
actual command outputs

Comment 2 Alison Young 2011-06-01 22:45:57 UTC
Book already finalised for MRG 2.0, to be scheduled for 2.1.

Comment 3 Joshua Wulf 2012-07-14 19:56:20 UTC
The LVQ example is superseded by https://bugzilla.redhat.com/show_bug.cgi?id=632000#c11, as the LVQ functionality has been changed.

Comment 6 Cheryn Tan 2012-09-20 02:53:36 UTC
Released for MRG 2.2