Bug 678461 - Connection reconnect-url needs to be document
Summary: Connection reconnect-url needs to be document
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise MRG
Classification: Red Hat
Component: Messaging_Programming_Reference
Version: 1.3
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: 2.2.3
: ---
Assignee: Joshua Wulf
QA Contact: Frantisek Reznicek
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2011-02-18 02:28 UTC by William Henry
Modified: 2015-11-16 01:13 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2012-11-19 04:27:17 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description William Henry 2011-02-18 02:28:39 UTC
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:

Comment 1 Joshua Wulf 2012-10-16 10:07:54 UTC
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]

Comment 3 Frantisek Reznicek 2012-10-30 12:04:31 UTC
Relevant issue tracked as bug 871410.

Comment 4 Frantisek Reznicek 2012-10-30 12:15:16 UTC
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

Comment 6 Frantisek Reznicek 2012-11-06 10:51:54 UTC
Requested changes are incorporated (incl. comment 4).

-> VERIFIED

Comment 7 Cheryn Tan 2012-11-19 04:27:17 UTC
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/


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