Broker URI

The Broker URI allows you to run a configured broker using a single URI for all the configuration.

Syntax

The URI is assumed to be a composite uri with multiple uris that are used to bind the connectors of the broker.

broker:(transportURI,network:networkURI)/brokerName?brokerOptions

If a composite URI use the network: scheme, then the rest of the URI is bound as a network connector.

Broker Options

Option Name

Default Value

Description

useJmx

true

Should the broker be exposed to JMX?

persistent

true

Should the broker use persistent storage

populateJMSXUserID

false

Should the broker populate the JMSXUserID property of messages to indicate the authenticated sender username who sent the message

useShutdownHook

true

should the broker install a shutdown hook so that it can properly shut itself down on a JVM kill

brokerName

localhost

The name of the broker

deleteAllMessagesOnStartup

false

Should all the messages in the persistent store be deleted on broker startup

enableStatistics

true

Should statistics gathering be enabled

Example URI

The following example starts up a broker accepting connections on port 61616, and establishes a network connection to remotehost:61616 and disables persistence.

broker:(tcp://localhost:61616,network:static:tcp://remotehost:61616)?persistent=false&useJmx=true

You can use the Broker URI on other transports

Icon

If you are using another transport - such as the VM Transport Reference then you can refer to the above broker URI properties inside that URL. e.g. using the URL

vm://localhost?broker.persistent=false

© 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