Archive › Documentation › Failover Transport Reference
Archived pageFailover 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 Name | Default Value | Description |
|---|---|---|
| initialReconnectDelay | 10 | How long to wait before the first reconnect attempt |
| maxReconnectDelay | 30000 | The maximum amount of time we ever wait between reconnect attempts |
| useExponentialBackOff | true | Should an exponential backoff be used btween reconnect attempts |
| backOffMultiplier | 2 | The exponent used in the exponential backoff attempts |
| maxReconnectAttempts | 0 | If not 0, then this is the maximum number of reconnect attempts before an error is sent back to the client |
| random | true | use a random algorithm to choose the the URI to use for reconnect from the list provided |
Example URI
failover:(tcp://localhost:61616,tcp://remotehost:61616)?initialReconnectDelay=100