| <div class="wiki-content maincontent"><h3 id="Configureversion5Brokers-Overview">Overview</h3><p>There is an updates XML syntax for configuring message brokers - <a shape="rect" class="external-link" href="http://activemq.apache.org/schema/core/activemq-core-5.0-SNAPSHOT.xsd">see here</a></p><p>So we decided that using XML would make this configuration much easier. we use <a shape="rect" class="external-link" href="http://xbean.org/" rel="nofollow">XBean</a> to perform the XML configuration.</p><p>For details of the XML see the <a shape="rect" href="xml-reference.xml">Xml Reference</a></p><div class="confluence-information-macro confluence-information-macro-warning"><p class="title">Be careful with broker names and URIs</p><span class="aui-icon aui-icon-small aui-iconfont-error confluence-information-macro-icon"></span><div class="confluence-information-macro-body"><p>Make sure you do not use any strange characters in the names of brokers as they are converted to URIs which <a shape="rect" class="external-link" href="http://java.sun.com/j2se/1.4.2/docs/api/java/net/URI.html" rel="nofollow">do not allow things like underscores</a> in them etc.</p></div></div><h2 id="Configureversion5Brokers-Examples">Examples</h2><p>The default ActiveMQ configuration: <a shape="rect" class="external-link" href="http://svn.apache.org/repos/asf/activemq/trunk/assembly/src/release/conf/activemq.xml">current default config</a>.</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl"> |
| <script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[<beans |
| xmlns="http://www.springframework.org/schema/beans" |
| xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
| xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd |
| http://activemq.apache.org/schema/core http://activemq.apache.org/schema/core/activemq-core.xsd"> |
| <!-- Allows us to use system properties as variables in this configuration file --> |
| <bean class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"> |
| <property name="locations"> |
| <value>file:${activemq.conf}/credentials.properties</value> |
| </property> |
| </bean> |
| <!-- Allows accessing the server log --> |
| <bean id="logQuery" class="io.fabric8.insight.log.log4j.Log4jLogQuery" |
| lazy-init="false" scope="singleton" |
| init-method="start" destroy-method="stop"> |
| </bean> |
| <!-- |
| The <broker> element is used to configure the ActiveMQ broker. |
| --> |
| <broker xmlns="http://activemq.apache.org/schema/core" brokerName="localhost" dataDirectory="${activemq.data}"> |
| <destinationPolicy> |
| <policyMap> |
| <policyEntries> |
| <policyEntry topic=">" > |
| <!-- The constantPendingMessageLimitStrategy is used to prevent |
| slow topic consumers to block producers and affect other consumers |
| by limiting the number of messages that are retained |
| For more information, see: |
| http://activemq.apache.org/slow-consumer-handling.html |
| --> |
| <pendingMessageLimitStrategy> |
| <constantPendingMessageLimitStrategy limit="1000"/> |
| </pendingMessageLimitStrategy> |
| </policyEntry> |
| </policyEntries> |
| </policyMap> |
| </destinationPolicy> |
| |
| <!-- |
| The managementContext is used to configure how ActiveMQ is exposed in |
| JMX. By default, ActiveMQ uses the MBean server that is started by |
| the JVM. For more information, see: |
| http://activemq.apache.org/jmx.html |
| --> |
| <managementContext> |
| <managementContext createConnector="false"/> |
| </managementContext> |
| <!-- |
| Configure message persistence for the broker. The default persistence |
| mechanism is the KahaDB store (identified by the kahaDB tag). |
| For more information, see: |
| http://activemq.apache.org/persistence.html |
| --> |
| <persistenceAdapter> |
| <kahaDB directory="${activemq.data}/kahadb"/> |
| </persistenceAdapter> |
| |
| <!-- |
| The systemUsage controls the maximum amount of space the broker will |
| use before disabling caching and/or slowing down producers. For more information, see: |
| http://activemq.apache.org/producer-flow-control.html |
| --> |
| <systemUsage> |
| <systemUsage> |
| <memoryUsage> |
| <memoryUsage percentOfJvmHeap="70" /> |
| </memoryUsage> |
| <storeUsage> |
| <storeUsage limit="100 gb"/> |
| </storeUsage> |
| <tempUsage> |
| <tempUsage limit="50 gb"/> |
| </tempUsage> |
| </systemUsage> |
| </systemUsage> |
| <!-- |
| The transport connectors expose ActiveMQ over a given protocol to |
| clients and other brokers. For more information, see: |
| http://activemq.apache.org/configuring-transports.html |
| --> |
| <transportConnectors> |
| <!-- DOS protection, limit concurrent connections to 1000 and frame size to 100MB --> |
| <transportConnector name="openwire" uri="tcp://0.0.0.0:61616?maximumConnections=1000&amp;wireFormat.maxFrameSize=104857600"/> |
| <transportConnector name="amqp" uri="amqp://0.0.0.0:5672?maximumConnections=1000&amp;wireFormat.maxFrameSize=104857600"/> |
| <transportConnector name="stomp" uri="stomp://0.0.0.0:61613?maximumConnections=1000&amp;wireFormat.maxFrameSize=104857600"/> |
| <transportConnector name="mqtt" uri="mqtt://0.0.0.0:1883?maximumConnections=1000&amp;wireFormat.maxFrameSize=104857600"/> |
| <transportConnector name="ws" uri="ws://0.0.0.0:61614?maximumConnections=1000&amp;wireFormat.maxFrameSize=104857600"/> |
| </transportConnectors> |
| <!-- destroy the spring context on shutdown to stop jetty --> |
| <shutdownHooks> |
| <bean xmlns="http://www.springframework.org/schema/beans" class="org.apache.activemq.hooks.SpringContextHook" /> |
| </shutdownHooks> |
| </broker> |
| <!-- |
| Enable web consoles, REST and Ajax APIs and demos |
| The web consoles requires by default login, you can disable this in the jetty.xml file |
| Take a look at ${ACTIVEMQ_HOME}/conf/jetty.xml for more details |
| --> |
| <import resource="jetty.xml"/> |
| </beans> |
| |
| ]]></script> |
| </div></div><p>From the binary distributionthere is an <em>activemq</em> script allowing you to run a Message Broker as a stand alone process from the command line easily providing the $ACTIVEMQ_HOME/bin directory is on your PATH.</p></div> |
| |