The Discovery Transport

The Discovery transport works just like the Failover transport, except that it uses a discovery agent to locate the list of uri to connect to. The Discovery transport is also used by the Fanout transport for discovering brokers to send a fanout message to.

Configuration Syntax

discovery:(discoveryAgentURI)?transportOptions
or
discovery:discoveryAgentURI

Note that to be able to use Discovery to find brokers, the brokers need to have the multicast discovery agent enabled on the broker.

To configure discovery in a Broker you should use the Xml Configuration. Here is an example of using discovery. Its basically something like the following (see the discoveryUri)

<broker name="foo">
  <transportConnectors>
    <transportConnector uri="tcp://localhost:0" discoveryUri="multicast://default"/>
  </transportConnectors>

  ...
</broker>
Transport Options
Option NameDefault ValueDescription
reconnectDelay10How long to wait for discovery
initialReconnectDelay10How long to wait before the first reconnect attempt to a discovered url
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
groupdefault an identifier for the group to partition multi cast traffic among collaborating peers; the group forms part of the shared identity of a discovery datagram (since 5.2)
Example URI
discovery:(multicast://default)?initialReconnectDelay=100
Applying parameters to discovered transports
From 5.4, transport parameters in the URI will also be applied to discovered transports if they are prefixed with discovered.; For example, adding the discovered.connectionTimeout parameter to the URI will apply the parameter to every discovered TCP transport, even though this parameter is not a Discovery transport option.
© 2004-2011 The Apache Software Foundation.
Apache ActiveMQ, ActiveMQ, Apache, the Apache feather logo, and the Apache ActiveMQ project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
Graphic Design By Hiram