| Summary: | Wrong commands in Configuring Queue Replication section | ||
|---|---|---|---|
| Product: | Red Hat Enterprise MRG | Reporter: | Pavel Moravec <pmoravec> |
| Component: | Messaging_Installation_and_Configuration_Guide | Assignee: | Joshua Wulf <jwulf> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | Frantisek Reznicek <freznice> |
| Severity: | medium | Docs Contact: | |
| Priority: | unspecified | ||
| Version: | 2.1 | CC: | chetan, esammons, freznice, iboverma, jskeoch, lcarlon, lzhaldyb, noconnor |
| Target Milestone: | 2.3 | Keywords: | Documentation |
| Target Release: | --- | ||
| Hardware: | All | ||
| OS: | All | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Bug Fix | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2013-03-13 23:59:58 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
Pavel Moravec
2012-02-22 12:51:37 UTC
Red_Hat_Enterprise_MRG-Messaging_Installation_and_Configuration_Guide-2.2-web-en-US-0-4.el6eng.src.rpm http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2.2/html-single/Messaging_Installation_and_Configuration_Guide/index.html#Section-Configuring_Queue_Replication Insufficent information to attempt to validate this bug. The link provided in Comment#1 does not appear to be associated with the guide mentioned in comment#0. please provide more details as to what has been altered. I've hit the same bug as has been listed here. The Replication Queue chapter of the MRG Messaging User Guide is basically incomplete and useless. http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2/html/Messaging_User_Guide/chap-Messaging_User_Guide-Replicated_Queues.html A more accurate and detailed description on how to setup replicated queues is available in the QPID docs http://qpid.apache.org/books/trunk/AMQP-Messaging-Broker-CPP-Book/html/queue-state-replication.html Some modifications/additions are still necessary: 1] At paragraph beginning: - It is necessary to omit ', and' at the end of item - if backup broker has 'Start the backup broker,' source broker should have that as well - Backup broker should have installed replication listener plugin (replication_listerer.so) - Source broker should have replication exchange plugin installed (replication_exchange.so) 2] It is necessary to keep terminology replication queue / exchange - objects needed for allowing replication (to work) from source broker to backup broker. replicated queue[s] - queues which are replicated between source broker to backup broker. - Add above description and doublecheck that 'replicating' and 'replicated' words are used properly 3] There is necessary to add an example of replication at the end of paragraph as description is quite complicated. Take http://qpid.apache.org/books/trunk/AMQP-Messaging-Broker-CPP-Book/html/queue-state-replication.html 1.7.1.5 or https://cwiki.apache.org/qpid/queue-state-replication.html Example or at least link to it. -> ASSIGNED 4] On more issue on --generate-queue-events Description given in Table 4.1. Options for qpid-config add queue may be misleading. I propose to migrate from --generate-queue-events integer If set to 1, every enqueue will generate an event that can be processed by registered listeners (e.g. for replication). If set to 2, events will be generated for enqueues dequeues. to --generate-queue-events integer If set to 1, every enqueue will generate an event that can be processed by registered listeners (e.g. for replication). If set to 2, events will be generated for both enqueues and dequeues. Updated with changes: http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2/html-single/Messaging_Installation_and_Configuration_Guide/index.html#sect-Configuring_Queue_Replication Thanks for the updates. I'm still seeing following issues: re 1] Enable a replication plugin, Start the Source Broker, Specify a replication event queue when the broker starts, Create one or more replicating queues. should get to Enable a replication plugin Start the Source Broker Specify a replication event queue when the broker starts Create one or more replicating queues Ensure that the replication exchange plugin is configured Start the backup broker, Create a replication exchange, and Create a backup queue that corresponds to each replicated queue. should get to Ensure that the replication exchange plugin is configured Start the backup broker Create a replication exchange Create a backup queue that corresponds to each replicated queue I'm eventually fine with ',' and final '.', but it should be used consistently, moreover ', and' should not be there (still the case). ad 2], 3], 4] I'm fine with incorporated changes Another issues: 5] typo Queue replication is done by creating a message queue called a replication event queue or replication queueon the source broker should be Queue replication is done by creating a message queue called a replication event queue or replication queue on the source broker 6] Procedure 8.3 1.C (each parameter on dedicated line) replication-queue=my_repl_event_queue create-replication-queue=true should be replication-queue=my_repl_event_queue create-replication-queue=true 7] Example We should teach our customers to run qpidd as the service, so I propose to change first two steps to: a] qpidd --replication-queue replication-queue --create-replication-queue true --log-enable info+ should be changed to a1] add following lines to /etc/qpidd.conf replication-queue=replication-queue create-replication-queue=true log-enable=info+ a2] run the broker service qpidd start b] qpidd should be changed to service qpidd start -> ASSIGNED I approve the content, points 1] - 7] corrected. -> VERIFIED Docs published on https://access.redhat.com/knowledge/docs/Red_Hat_Enterprise_MRG/ |