Bug 709693 - obsolete info in MRG/M UG
Summary: obsolete info in MRG/M UG
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise MRG
Classification: Red Hat
Component: Messaging_Programming_Reference
Version: Development
Hardware: Unspecified
OS: Unspecified
high
unspecified
Target Milestone: 2.2
: ---
Assignee: Joshua Wulf
QA Contact: ecs-bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2011-06-01 12:25 UTC by Petr Matousek
Modified: 2014-10-19 22:58 UTC (History)
5 users (show)

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


Attachments (Terms of Use)
actual command outputs (8.71 KB, text/plain)
2011-06-01 12:33 UTC, Petr Matousek
no flags Details

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


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