Added: incubator/activemq/site/Failover+Transport+Reference URL: http://svn.apache.org/viewcvs/incubator/activemq/site/Failover%2BTransport%2BReference?rev=374430&view=auto ============================================================================== --- incubator/activemq/site/Failover+Transport+Reference (added) +++ incubator/activemq/site/Failover+Transport+Reference Thu Feb 2 08:31:10 2006 @@ -0,0 +1,271 @@ + + + + + + + + ActiveMQ - Failover Transport Reference + + + + + + + + + + + + + + + +
+ + + + + + +
+

Overview

+ +

Community

+ +

Using ActiveMQ

+ +

Features

+ +

Connectivitiy

+ +

Utilities

+ +

External Tools

+ +

Related Projects

+ +

Support

+ +

Developers

+ +

Tools we use

+ +

Feeds

+ + + + + + + + + +
+
+
+ Site +
+ + + News +
+
+ +
+ + + + + +
+ Failover Transport Reference + + +
+
+ + +
+
+

The Failover Transport

+

The Failover transport layers reconnect logic on top of any of the other transports. This is what used to be the Reliable transport in ActiveMQ 3. It's configuration syntax allows you to specify any number of composite uris. The Failover transport randomly chooses one of the composite URI and attempts to establish a connection to it. If it does not succeed or if it subsequently fails, a new connection is established to one of the other uris in the list.

+

Configuration Syntax

+

failover:(uri1,...,uriN)?transportOptions
or
failover:uri1,...,uriN

+
Transport Options
+

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Option NameDefault ValueDescription
initialReconnectDelay10How long to wait before the first reconnect attempt
maxReconnectDelay30000The maximum amount of time we ever wait between reconnect attempts
useExponentialBackOfftrueShould an exponential backoff be used btween reconnect attempts
backOffMultiplier2The exponent used in the exponential backoff attempts
maxReconnectAttempts0If not 0, then this is the maximum number of reconnect attempts before an error is sent back to the client
+

+
Example URI
+

+

+
failover:(tcp://localhost:61616,tcp://remotehost:61616)?initialReconnectDelay=100
+
+
+

+
+
+ +   +