| Summary: | Connection reconnect-url needs to be document | ||
|---|---|---|---|
| Product: | Red Hat Enterprise MRG | Reporter: | William Henry <whenry> |
| Component: | Messaging_Programming_Reference | Assignee: | Joshua Wulf <jwulf> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | Frantisek Reznicek <freznice> |
| Severity: | high | Docs Contact: | |
| Priority: | high | ||
| Version: | 1.3 | CC: | esammons, freznice, jskeoch, lcarlon |
| Target Milestone: | 2.2.3 | ||
| Target Release: | --- | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Bug Fix | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2012-11-19 04:27:17 UTC | Type: | --- |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
Added to Messaging Programming Guide in 10.4 "Connection Option Reference" [Topic 8044] and to the example in 10.3 "Setting Connection Options" [Topic 8036] Added reconnect-urls to table here: http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2/html-single/Messaging_Programming_Reference/index.html#Connection_Options_Reference And to example here: http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2/html-single/Messaging_Programming_Reference/index.html#Setting_Connection_Options_in_C_and_Python Relevant issue tracked as bug 871410. 1] All references to 'reconnect-url' should be replaced to 'reconnect_urls'
Especially in 11.4. Connection Options Reference/Table 11.2. Connection Options
2] Qpid c++ client unified reconnect url parameter to 'reconnect_urls'
All references to 'reconnect-urls' should be 'reconnect_urls'
Current (2.2+) qpid client support both versions.
3] 11.2. Connection Options/11.3. Setting Connection Options/.NET/C# has typo
Connection connection= new Connection("localhost:5672", "{reconnect: true, reconnect-urls:'amqp:,tcp:127.0.0.1:5674', reconnect:true, heartbeat: 1}");
which should be (I believe)
Connection connection= new Connection("localhost:5672", "{reconnect: true, reconnect-urls:'amqp:tcp:127.0.0.1:5674', reconnect:true, heartbeat: 1}");
4] 11.4. Connection Options Reference/Table 11.2. Connection Options
Type of 'reconnect-url' -> 'reconnect_urls' should be
'string or list of strings representing broker URL list' or similar
-> ASSIGNED
Changed reconnect_url to reconnect_urls: http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2/html-single/Messaging_Programming_Reference/index.html#Connection_Options_Reference Requested changes are incorporated (incl. comment 4). -> VERIFIED MRG Messaging 2.2.3 docs have been released as of 14 November 2012, the docs are now available on https://access.redhat.com/knowledge/docs/Red_Hat_Enterprise_MRG/ |
Description of problem: There is no documentation for the reconnect-url for class Connection. Also note that upstream Qpid has some documentation but it's for JMS and doesn't work for C++. So don't use that as the basis for the documentation for MRG C++. It should be noted that Python an Ruby will use the same syntax for all these options. Some examples would be useful too. e.g. a reconnect-url with reconnect: true and heartbeat:1. The full URL would be a nice example. I'll post what I got to work: "{reconnect-urls:'amqp:tcp:127.0.0.1:5674', reconnect:true, heartbeat: 1}" this should work too if the 5672 is the primary: "{reconnect-urls:'amqp:tcp:127.0.0.1:5672,tcp:127.0.0.1:5674', reconnect:true, heartbeat: 1}" I'll retry it - not sure it did work. Version-Release number of selected component (if applicable): How reproducible: Steps to Reproduce: 1. 2. 3. Actual results: Expected results: Additional info: