Red Hat Bugzilla – Bug 859555
(ACL Doc tracker) Documentation does not reflect very recent C++ Broker ACL configuration change
Last modified: 2014-10-19 19:01:26 EDT
Description of problem:
Several changes to C++ Broker ACL came late in the release cycle. Organized descriptions of the changes are now available upstream.
Version-Release number of selected component (if applicable):
Steps to Reproduce:
Messaging Installation and Configuration Guide section 7.3 Authorization has been rewritten in (DocBook format) Security.xml
Do you have an upstream URL that I can take a look at?
Please see http://qpid.apache.org/books/0.18/AMQP-Messaging-Broker-CPP-Book/html/chap-Messaging_User_Guide-Security.html#sect-Messaging_User_Guide-Security-Authorization
* Section "220.127.116.11. Specifying ACL Connection Limits" describes connection limits, only it uses the wrong names. The names in the Red Hat doc are correct.
* Various other parts of ACL in the upstream doc do not apply to MRG-2.2 but they will apply to MRG-2.3.
I completely missed the description of ACL connection limits. On re-reading the guide for this post I found "7.1.3. Configure SASL with ACL" where the ACL command line switches for specifying connection limits are described. This text is what I thought was missing when I created this BZ.
The guide would be improved if the connection limit text was removed from 7.1.3 and added to a new section such as "7.3.7 Specifying ACL Quotas". In MRG-2.2 there are only the connection limit quotas but in MRG-2.3 a queue quota will be added.
Since this bug is very general, I transforming it into ACL Documentation tracker. It should also serve to track doc checking for the documentation as whole.
I cannot close this tracker, because in the documentation exists a "TODO" section:
8.3.10. Routing Key Wildcard Examples
If time permits in the MRG 2.3 Development cycle, we'll put the Routing Key Wildcard examples from https://bugzilla.redhat.com/show_bug.cgi?id=853828#c5 here.
This have to be resolved before closing ACL Documentation tracker.
there are two options, postpone adding examples and remove section about adding exmaples, OR if you have time, please add the examples.
Cloned to https://bugzilla.redhat.com/show_bug.cgi?id=909982 for 2.4 release cycle.
Docs published on https://access.redhat.com/knowledge/docs/Red_Hat_Enterprise_MRG/