[QPID-3220] Specifying connection url option failover='singlebroker' causes the wrong failover policy to be used

• Type: Bug
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 0.5, 0.6, 0.7, 0.8, 0.9, 0.10
• Fix Version/s: 0.11
• Component/s: JMS AMQP 0-x
• Assignee: Robbie Gemmell
• Reporter: Keith Wall
• Created: 20/Apr/11 14:11
• Updated: 14/Mar/17 20:07
• Resolved: 16/May/11 19:44

Description

If the user specifies the option failover='singlebroker' in the connection URL, a coding error in FailoverPolicy.java means that the client actually elects to use FailoverRoundRobinServers policy rather than FailoverSingleServer.

For example, the following URL will cause the client to use the round-robin policy.

amqp://guest:guest@clientid/test?brokerlist='tcp://localhost:5672?retries='50'&connectdelay='5000''&failover='singlebroker'

Furthermore, as the logic FailoverRoundRobinServers.getNextBrokerDetails means that if the roundrobin policy is used with a brokerlist containing one broker, connectdelay is never applied, this defect also means that if a user passes failover='singlebroker' with a broker list containing one entry, connectdelay is ignored. This can give the appearance that server reconnection is broken as the client can spin through thousands of retries before then broker has chance to restart.

To workaround this issue, the user can omit the failover option from the URL and let the defaulting within FailoverPolicy class choose FailoverSingleServer if the brokerlist contains one entry, or FailoverRoundRobinServers if the list contains more than one.

Client will default to singlebroker policy:

amqp://guest:guest@clientid/test?brokerlist='tcp://localhost:5672'

Client will default to roundrobin policy:

amqp://guest:guest@clientid/test?brokerlist='tcp://localhost:5672;tcp://localhost:5672'