Modified: websites/production/activemq/content/encrypted-passwords.html
==============================================================================
--- websites/production/activemq/content/encrypted-passwords.html (original)
+++ websites/production/activemq/content/encrypted-passwords.html Sat Jun 27
21:23:55 2015
@@ -32,15 +32,6 @@
</style>
<![endif]-->
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shCore.css'
rel='stylesheet' type='text/css' />
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shThemeEclipse.css'
rel='stylesheet' type='text/css' />
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shCore.js'
type='text/javascript'></script>
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shBrushJava.js'
type='text/javascript'></script>
-
- <script type="text/javascript">
- SyntaxHighlighter.defaults['toolbar'] = false;
- SyntaxHighlighter.all();
- </script>
<title>
Apache ActiveMQ ™ -- Encrypted passwords
@@ -82,22 +73,22 @@
<tr>
<td valign="top" width="100%">
<div class="wiki-content maincontent"><p>As of ActiveMQ 5.4.1 you can encrypt
your passwords and safely store them in configuration files. To encrypt the
password, you can use the newly added <code>encrypt</code> command
like:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[$ bin/activemq encrypt --password activemq
--input mypassword
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[$ bin/activemq encrypt --password activemq
--input mypassword
...
Encrypted text: eeWjNyX6FY8Fjp3E+F6qTytV11bZItDp]]></script>
</div></div><p>Where the password you want to encrypt is passed with the
<code>input</code> argument, while the <code>password</code> argument is a
secret used by the encryptor. In a similar fashion you can test-out your
passwords like:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[$ bin/activemq decrypt --password activemq
--input eeWjNyX6FY8Fjp3E+F6qTytV11bZItDp
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[$ bin/activemq decrypt --password activemq
--input eeWjNyX6FY8Fjp3E+F6qTytV11bZItDp
...
Decrypted text: mypassword]]></script>
</div></div><p><strong>Note:</strong> It is recommended that you use only
alphanumeric characters for the password. Special characters, such as
<code>$/^&</code>, are not supported.</p><p>The next step is to add the
password to the appropriate configuration file,
<code>$ACTIVEMQ_HOME/conf/credentials-enc.properties</code> by default.</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[activemq.username=system
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[activemq.username=system
activemq.password=ENC(mYRkg+4Q4hua1kvpCCI2hg==)
guest.password=ENC(Cf3Jf3tM+UrSOoaKU50od5CuBa8rxjoL)
...
jdbc.password=ENC(eeWjNyX6FY8Fjp3E+F6qTytV11bZItDp)
]]></script>
</div></div><p>Note that we used <code>ENC()</code> to wrap our encrypted
passwords. You can mix plain and encrypted passwords in your properties files,
so encrypted ones must be wrapped this way.</p><p>Finally, you need to instruct
your property loader to encrypt variables when it loads properties to the
memory. Instead of standard property loader we'll use the special one (see
<code>\$ACTIVEMQ_HOME/conf/activemq-security.xml</code>) to achieve
this.</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[<bean
id="environmentVariablesConfiguration"
class="org.jasypt.encryption.pbe.config.EnvironmentStringPBEConfig">
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[<bean
id="environmentVariablesConfiguration"
class="org.jasypt.encryption.pbe.config.EnvironmentStringPBEConfig">
<property name="algorithm" value="PBEWithMD5AndDES"
/>
<property name="passwordEnvName"
value="ACTIVEMQ_ENCRYPTION_PASSWORD" />
</bean>
@@ -111,12 +102,12 @@ jdbc.password=ENC(eeWjNyX6FY8Fjp3E+F6qTy
<property name="location"
value="file:${activemq.base}/conf/credentials-enc.properties"/>
</bean>]]></script>
</div></div><p>With this configuration ActiveMQ will try to load your
encryptor password from the <code>ACTIVEMQ_ENCRYPTION_PASSWORD</code>
environment variable and then use it to decrypt passwords from
<code>credential-enc.properties</code> file.</p><p>Alternative is to use a
simple variant and store encryptor password in the xml file, like this</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[<bean
id="configurationEncryptor"
class="org.jasypt.encryption.pbe.StandardPBEStringEncryptor">
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[<bean
id="configurationEncryptor"
class="org.jasypt.encryption.pbe.StandardPBEStringEncryptor">
<property name="algorithm"
value="PBEWithMD5AndDES"/>
<property name="password" value="activemq"/>
</bean>]]></script>
</div></div><p>but with that you'll lose the secrecy of the encryptor's
secret. You may also consult <a shape="rect" class="external-link"
href="http://www.jasypt.org/advancedconfiguration.html";
rel="nofollow">http://www.jasypt.org/advancedconfiguration.html</a> for more
ideas on how to configure Jasypt.</p><p>Finally, we can use properties like
we'd normally do</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[<simpleAuthenticationPlugin>
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[<simpleAuthenticationPlugin>
<users>
<authenticationUser username="system"
password="${activemq.password}"
groups="users,admins"/>
@@ -126,7 +117,7 @@ jdbc.password=ENC(eeWjNyX6FY8Fjp3E+F6qTy
</users>
</simpleAuthenticationPlugin>]]></script>
</div></div><p>or</p><div class="code panel pdl" style="border-width:
1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[<bean id="mysql-ds"
class="org.apache.commons.dbcp.BasicDataSource"
destroy-method="close">
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[<bean id="mysql-ds"
class="org.apache.commons.dbcp.BasicDataSource"
destroy-method="close">
<property name="driverClassName"
value="com.mysql.jdbc.Driver"/>
<property name="url"
value="jdbc:mysql://localhost/activemq?relaxAutoCommit=true"/>
<property name="username" value="activemq"/>
@@ -135,11 +126,11 @@ jdbc.password=ENC(eeWjNyX6FY8Fjp3E+F6qTy
<property name="poolPreparedStatements"
value="true"/>
</bean>]]></script>
</div></div><p>If you want to run the broker with this configuration, you need
to do the following:</p><ul><li><p>Set environment variable:</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[$ export
ACTIVEMQ_ENCRYPTION_PASSWORD=activemq]]></script>
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[$ export
ACTIVEMQ_ENCRYPTION_PASSWORD=activemq]]></script>
</div></div></li><li><p>Start the broker:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[$ bin/activemq start
xbean:conf/activemq-security.xml]]></script>
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[$ bin/activemq start
xbean:conf/activemq-security.xml]]></script>
</div></div></li><li><p>Unset the environment variable:</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[$ unset
ACTIVEMQ_ENCRYPTION_PASSWORD]]></script>
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[$ unset
ACTIVEMQ_ENCRYPTION_PASSWORD]]></script>
</div></div></li></ul><p>In this way your encryptor secret is never saved on
your system and your encrypted passwords are safely stored in the configuration
files.</p></div>
</td>
<td valign="top">
Modified:
websites/production/activemq/content/enterprise-integration-patterns.html
==============================================================================
--- websites/production/activemq/content/enterprise-integration-patterns.html
(original)
+++ websites/production/activemq/content/enterprise-integration-patterns.html
Sat Jun 27 21:23:55 2015
@@ -32,15 +32,6 @@
</style>
<![endif]-->
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shCore.css'
rel='stylesheet' type='text/css' />
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shThemeEclipse.css'
rel='stylesheet' type='text/css' />
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shCore.js'
type='text/javascript'></script>
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shBrushJava.js'
type='text/javascript'></script>
-
- <script type="text/javascript">
- SyntaxHighlighter.defaults['toolbar'] = false;
- SyntaxHighlighter.all();
- </script>
<title>
Apache ActiveMQ ™ -- Enterprise Integration Patterns
@@ -101,7 +92,7 @@
<p>For example if all your routes are in the package org.acme.cheese; such as
org.acme.cheese.whatnot.MyRouter then you could edit the XML to be...</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
<camelContext
xmlns="http://activemq.apache.org/camel/schema/spring">
<package>org.acme.cheese</package>
</camelContext>
@@ -113,7 +104,7 @@
<p>To use XML its even easier, as you can just embed whatever routing rules
inside the <camelContext> element using Camel's <a shape="rect"
class="external-link"
href="http://activemq.apache.org/camel/xml-configuration.html";>Spring XML
format</a>. Note that the XML is way more verbose than the <a shape="rect"
class="external-link" href="http://activemq.apache.org/camel/dsl.html";>Java
DSL</a> but it is a bit simpler to deploy. e.g. for a trivial route...</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
<camelContext
xmlns="http://activemq.apache.org/camel/schema/spring">
<route>
<from uri="activemq:com.acme.MyQueue"/>
Modified: websites/production/activemq/content/example-testing-scenario.html
==============================================================================
--- websites/production/activemq/content/example-testing-scenario.html
(original)
+++ websites/production/activemq/content/example-testing-scenario.html Sat Jun
27 21:23:55 2015
@@ -32,15 +32,6 @@
</style>
<![endif]-->
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shCore.css'
rel='stylesheet' type='text/css' />
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shThemeEclipse.css'
rel='stylesheet' type='text/css' />
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shCore.js'
type='text/javascript'></script>
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shBrushJava.js'
type='text/javascript'></script>
-
- <script type="text/javascript">
- SyntaxHighlighter.defaults['toolbar'] = false;
- SyntaxHighlighter.all();
- </script>
<title>
Apache ActiveMQ ™ -- Example Testing Scenario
@@ -107,7 +98,7 @@
<p>Ideally we might wanna run this as 3 maven commands as follows...</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
mvn activemq:broker
mvn activemq:perf-producer -Dmessage-count=5000 -Dqueue=true
-Ddestination=org.foo.bar -Durl=tcp://$hostA:61616
mvn activemq:perf-consumer -Dmessage-count=5000 -Dqueue=true
-Ddestination=org.foo.bar -Durl=tcp://$hostA:61616
@@ -133,7 +124,7 @@ mvn activemq:perf-consumer -Dmessage-cou
<p>e.g.</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
public class PerformanceTestSuite {
public void testSmallMessages() {
buildQueue.start("broker", "");
Modified: websites/production/activemq/content/examples.html
==============================================================================
--- websites/production/activemq/content/examples.html (original)
+++ websites/production/activemq/content/examples.html Sat Jun 27 21:23:55 2015
@@ -32,16 +32,6 @@
</style>
<![endif]-->
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shCore.css'
rel='stylesheet' type='text/css' />
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shThemeEclipse.css'
rel='stylesheet' type='text/css' />
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shCore.js'
type='text/javascript'></script>
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shBrushJava.js'
type='text/javascript'></script>
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shBrushPlain.js'
type='text/javascript'></script>
-
- <script type="text/javascript">
- SyntaxHighlighter.defaults['toolbar'] = false;
- SyntaxHighlighter.all();
- </script>
<title>
Apache ActiveMQ ™ -- Examples
@@ -83,36 +73,36 @@
<tr>
<td valign="top" width="100%">
<div class="wiki-content maincontent"><p>Since version<strong>
5.12.0</strong>, Apache ActiveMQ comes with the new tool that can be used to
produce and consume messages from the broker.</p><h2
id="Examples-Prerequisites"><span style="color:
rgb(34,34,34);">Prerequisites</span></h2><p><span style="color:
rgb(34,34,34);"> </span></p><p>Before running the examples you should
try <a shape="rect" href="run-broker.html">running a JMS
broker</a> on your machine. Follow the <a shape="rect"
href="installation.html">Installation</a> instructions to use a binary
distribution of ActiveMQ. To run the broker in a command shell,
type:</p><p><span style="color: rgb(34,34,34);"> </span></p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[bin/activemq console
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[bin/activemq console
]]></script>
</div></div><p><span style="color: rgb(34,34,34);"> </span></p><p>This
starts up ActiveMQ.</p><h2 id="Examples-Running">Running</h2><p>From the<a
shape="rect" href="unix-shell-script.html"> command line</a> you can
run</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[${ACTIVEMQ_HOME}/bin/activemq producer
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[${ACTIVEMQ_HOME}/bin/activemq producer
${ACTIVEMQ_HOME}/bin/activemq consumer]]></script>
</div></div><p> </p><p>If you have <code>activemq-all</code> jar
available you can achieve the same with</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[java -jar activemq-all-5.x.x.jar producer
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[java -jar activemq-all-5.x.x.jar producer
java -jar activemq-all-5.x.x.jar consumer]]></script>
</div></div><p>If you run inside <a shape="rect"
href="osgi-integration.html">Karaf</a>, you can run the commands as</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[activemq:producer
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[activemq:producer
activemq:consumer]]></script>
</div></div><p> </p><h2 id="Examples-Options">Options</h2><p>For all
options on the commands, run them with <code>--help</code> parameter. The
up to date, options for <a shape="rect" class="external-link"
href="https://github.com/apache/activemq/blob/master/activemq-console/src/main/resources/org/apache/activemq/console/command/producer.txt";
rel="nofollow">producer</a> and <a shape="rect" class="external-link"
href="https://github.com/apache/activemq/blob/master/activemq-console/src/main/resources/org/apache/activemq/console/command/consumer.txt";
rel="nofollow">consumer</a> can be found in the source.</p><h2
id="Examples-Examples">Examples</h2><p>Here are a couple of examples of more
advanced features.</p><p>To send a text message with custom text use</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[bin/activemq producer --message "My
message" --messageCount 1
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[bin/activemq producer --message "My
message" --messageCount 1
]]></script>
</div></div><p>To send byte message of custom length use</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[bin/activemq producer --messageSize 100
--messageCount 1
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[bin/activemq producer --messageSize 100
--messageCount 1
]]></script>
</div></div><p>To send a text message with content obtained from an
url</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[bin/activemq producer --payloadUrlÂ
http://activemq.apache.org/schema/core/activemq-core.xsd --messageCount
1]]></script>
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[bin/activemq producer --payloadUrlÂ
http://activemq.apache.org/schema/core/activemq-core.xsd --messageCount
1]]></script>
</div></div><p>To consume in transaction use</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[bin/activemq consumer --transacted true
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[bin/activemq consumer --transacted true
]]></script>
</div></div><p>To use client acknowledgment use</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[bin/activemq consumer --ackMode
CLIENT_ACKNOWLEDGE
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[bin/activemq consumer --ackMode
CLIENT_ACKNOWLEDGE
]]></script>
</div></div><p>To use durable topic subscribers use</p><div class="code panel
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[bin/activemq consumer --durable true
--clientId example --destination topic://TEST
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[bin/activemq consumer --durable true
--clientId example --destination topic://TEST
]]></script>
</div></div><h2 id="Examples-Oldexamples">Old examples</h2><p>In older
versions of ActiveMQ, the corresponding examples were located in
<code>examples/</code> or <code>examples/openwire/swissarmy/</code>
directories, where you can do the similar tasks with an ant script.</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[ant producer
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[ant producer
ant consumer]]></script>
</div></div><h2 id="Examples-Otherexamples">Other examples</h2><p>In
<code>examples/</code> directory (depending on the version) you can find more
examples of using the broker with variety of protocols (mqtt, amqp, ...) and
clients (Java, Ruby, JavaScript, ...), so it's the good place to start
learning. Also, <code>examples/conf/</code> directory contains a lot of
different configuration examples that you can use as a starting point for your
deployment.</p><h2 id="Examples-SeeAlso">See Also</h2><ul><li><a shape="rect"
href="web-samples.html">Web Samples</a></li><li><a shape="rect"
href="web-console.html">Web Console</a></li><li><a shape="rect"
href="jmx.html">JMX</a></li></ul></div>
</td>
Modified: websites/production/activemq/content/exclusive-consumer.html
==============================================================================
--- websites/production/activemq/content/exclusive-consumer.html (original)
+++ websites/production/activemq/content/exclusive-consumer.html Sat Jun 27
21:23:55 2015
@@ -32,15 +32,6 @@
</style>
<![endif]-->
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shCore.css'
rel='stylesheet' type='text/css' />
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shThemeEclipse.css'
rel='stylesheet' type='text/css' />
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shCore.js'
type='text/javascript'></script>
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shBrushJava.js'
type='text/javascript'></script>
-
- <script type="text/javascript">
- SyntaxHighlighter.defaults['toolbar'] = false;
- SyntaxHighlighter.all();
- </script>
<title>
Apache ActiveMQ ™ -- Exclusive Consumer
@@ -102,7 +93,7 @@
<p>An Exclusive Consumer is created using <a shape="rect"
href="destination-options.html">Destination Options</a> as follows:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
queue = new ActiveMQQueue("TEST.QUEUE?consumer.exclusive=true");
consumer = session.createConsumer(queue);
]]></script>
Modified: websites/production/activemq/content/failover-transport-reference.html
==============================================================================
--- websites/production/activemq/content/failover-transport-reference.html
(original)
+++ websites/production/activemq/content/failover-transport-reference.html Sat
Jun 27 21:23:55 2015
@@ -32,15 +32,6 @@
</style>
<![endif]-->
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shCore.css'
rel='stylesheet' type='text/css' />
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shThemeEclipse.css'
rel='stylesheet' type='text/css' />
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shCore.js'
type='text/javascript'></script>
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shBrushJava.js'
type='text/javascript'></script>
-
- <script type="text/javascript">
- SyntaxHighlighter.defaults['toolbar'] = false;
- SyntaxHighlighter.all();
- </script>
<title>
Apache ActiveMQ ™ -- Failover Transport Reference
@@ -94,7 +85,7 @@
<pre>failover:(tcp://primary:61616)?timeout=3000
</pre>
</div></div><p>will cause send to fail after 3 seconds if the connection isn't
established. The connection will not be killed, so you can try sending messages
later at some point using the same connection (presumably some of your brokers
will be available again). Timeouts on the failover transport are available
since 5.3 version.</p><h5
id="FailoverTransportReference-Transactions">Transactions</h5><p>The Failover
transport tracks transactions by default. The inflight transactions are
replayed on reconnection. For simple scenarios this works ok. However there is
an assumption for acknowledged (or consumer) transactions, that the previously
received messages will get relayed after a reconnect. This is not always true
when there are many connections and consumers, as redelivery order is not
guaranteed. It is possible to have stale outstanding acknowledgements that can
interfere with newly delivered messages, potentially leading to unacknowledged
messages.<br clear="none"> Starting in v
ersion 5.3.1, redelivery order is tracked and a transaction will fail to
commit (throw a TransactionRolledBackException) if outstanding messages are not
redelivered after failover. In addition, in doubt transaction will now result
in a rollback such that they can be replayed by the application. In doubt
transactions occur when failover happens with a commit message inflight. It is
not possible to know the exact point of failure. Did the transaction commit
message get delivered or was it just the commit reply that is lost? In this
case, it is necessary to rollback so that the application can get an indication
of the failure and deal with any potential problem.</p><h5
id="FailoverTransportReference-BrokersideOptionsforFailover">Broker side
Options for Failover</h5><p><span style="color: red;"><strong><em>This is new
in version 5.4:</em></strong></span></p><p>There are some options that are
available on a TransportConnector that is used by the broker that can be used
to update clients
automatically with information about new brokers to failover to. These
are:</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th
colspan="1" rowspan="1" class="confluenceTh"><p>Option Name</p></th><th
colspan="1" rowspan="1" class="confluenceTh"><p>Default Value</p></th><th
colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>updateClusterClients</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>false</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>if true, pass information to connected
clients about changes in the topology of the broker
cluster</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>rebalanceClusterClients</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>false</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>if true, connected clients will be asked to rebalance
across a cluster of brokers when a new broker joins th
e network of brokers (note: priorityBackup=true can
override)</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>updateClusterClientsOnRemove</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>false</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>if true, will update clients when a cluster is removed
from the network. Having this as separate option enables clients to be updated
when new brokers join, but not when brokers leave.</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>updateClusterFilter</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>null</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>comma separated list of regular expression
filters used to match broker names of brokers to designate as being part of the
failover cluster for the clients</p></td></tr></tbody></table></div><p>An
example as defined within the broker's XML configuration file:</p><div
class="code panel pdl" style="border-width:
1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[<broker>
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[<broker>
...
<transportConnectors>
<transportConnector name="openwire"
uri="tcp://0.0.0.0:61616" updateClusterClients="true"
updateClusterFilter=".*A.*,.*B.*" />
@@ -106,13 +97,13 @@
<pre>failover://tcp://primary:61616
</pre>
</div></div><p>If new brokers join, the client will automatically be updated
with the additional URI of that broker to connect to in the event of a network
or broker failure.</p><h6 id="FailoverTransportReference-MoreInformation">More
Information</h6><p>Also check out the following blog entry about using the
cluster client updates and rebalancing features titled <a shape="rect"
class="external-link"
href="http://bsnyderblog.blogspot.com/2010/10/new-features-in-activemq-54-automatic.html";
rel="nofollow">New Features in ActiveMQ 5.4: Automatic Cluster Update and
Rebalance</a>.</p><h5 id="FailoverTransportReference-PriorityBackup">Priority
Backup</h5><p>If your setup have brokers in both local and remote networks, you
probably want your clients connected to the local ones if those are available.
As of version 5.6, ActiveMQ supports priority backup feature, so you can have
your clients automatically reconnect to so called priority (or local) urls.
Consider the following url</p><div clas
s="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[failover:(tcp://local:61616,tcp://remote:61616)?randomize=false&priorityBackup=true]]></script>
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[failover:(tcp://local:61616,tcp://remote:61616)?randomize=false&priorityBackup=true]]></script>
</div></div><p>If this url is used for the client, the client will try to
connect and stay connected to the <code>local</code> broker. If local broker
fails, it will of course fail over to the remote one. But as
<code>priorityBackup</code> parameter is used, it will constantly try to
reconnect to the local broker. Once it can do so, the client will get back to
it without any need for manual intervention.</p><p>By default, only the first
url in the list is considered prioritized (local). In most cases this will
suffice, but in some cases you can have multiple "local" urls. You can
configure which urls are considered prioritized, by using
<code>priorityURIs</code> parameter, like</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[failover:(tcp://local1:61616,tcp://local2:61616,tcp://remote:61616)?randomize=false&priorityBackup=true&priorityURIs=tcp://local1:61616,tcp://local2:61616]]></script>
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[failover:(tcp://local1:61616,tcp://local2:61616,tcp://remote:61616)?randomize=false&priorityBackup=true&priorityURIs=tcp://local1:61616,tcp://local2:61616]]></script>
</div></div><p>In this case the client will prioritize either
<code>local1</code> or <code>local2</code> brokers and (re)connect to them if
they are available.</p><h5
id="FailoverTransportReference-PassingextraoptionstothenestedURLs.">Passing
extra options to the nested URLs.</h5><p><span style="color:
red;"><strong><em>This is new in version 5.9:</em></strong></span><br
clear="none"> You can now add options the nested URLs via options on the
failover URL. Previously, if you wanted to detect dead connections faster you
had to add the wireFormat.maxInactivityDuration=1000 option to all the nested
URLs in the failover list. For example:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[failover:(tcp://host01:61616?wireFormat.maxInactivityDuration=1000,tcp://host02:61616?wireFormat.maxInactivityDuration=1000,tcp://host03:61616?wireFormat.maxInactivityDuration=1000)]]></script>
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[failover:(tcp://host01:61616?wireFormat.maxInactivityDuration=1000,tcp://host02:61616?wireFormat.maxInactivityDuration=1000,tcp://host03:61616?wireFormat.maxInactivityDuration=1000)]]></script>
</div></div><p>As of ActiveMQ 5.9, you can now do the same thing using the
following URL:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[failover:(tcp://host01:61616,tcp://host02:61616,tcp://host03:61616)?nested.wireFormat.maxInactivityDuration=1000]]></script>
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[failover:(tcp://host01:61616,tcp://host02:61616,tcp://host03:61616)?nested.wireFormat.maxInactivityDuration=1000]]></script>
</div></div></div>
</td>
<td valign="top">
Modified: websites/production/activemq/content/fanout-transport-reference.html
==============================================================================
--- websites/production/activemq/content/fanout-transport-reference.html
(original)
+++ websites/production/activemq/content/fanout-transport-reference.html Sat
Jun 27 21:23:55 2015
@@ -32,15 +32,6 @@
</style>
<![endif]-->
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shCore.css'
rel='stylesheet' type='text/css' />
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shThemeEclipse.css'
rel='stylesheet' type='text/css' />
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shCore.js'
type='text/javascript'></script>
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shBrushJava.js'
type='text/javascript'></script>
-
- <script type="text/javascript">
- SyntaxHighlighter.defaults['toolbar'] = false;
- SyntaxHighlighter.all();
- </script>
<title>
Apache ActiveMQ ™ -- Fanout Transport Reference
@@ -101,32 +92,25 @@ or<br clear="none">
<p>By default, a client's fanout transport waits for connections to be
established to 2 brokers, or the number of static TCP URIs configured (if more
than 2). Until this number of connections is established, the client's call to
Connection.createSession() does not return. For example, a producer that uses
the fanout connector listed below will wait until 2 brokers are running, and
connections are established to those two brokers. </p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
fanout:(multicast://default)
]]></script>
</div></div>
<p>Another example would be a producer using the following fanout connector.
</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
fanout:(static:(tcp://localhost:61629,tcp://localhost:61639,tcp://localhost:61649))
]]></script>
</div></div>
<p>In this case, three broker connections are needed. However, this required
number of connections can be overridden by using the minAckCount transport
option. For example, this fanout connector allows the producer to run after
connecting to just one broker.</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
fanout:(multicast://default)?minAckCount=1
]]></script>
</div></div>
- <div class="aui-message problem shadowed information-macro">
- <p class="title">Warning</p>
- <span class="aui-icon icon-problem">Icon</span>
- <div class="message-content">
-
-<p>It is not recommended that you use the fanout URI for consumers. Also, if a
producer fans out across multiple brokers, who happen to be inter-connected,
then there is a very high likelihood that a consumer on one of those brokers
will get duplicate messages.</p>
- </div>
- </div>
-
+<div class="confluence-information-macro
confluence-information-macro-warning"><p class="title">Warning</p><span
class="aui-icon aui-icon-small aui-iconfont-error
confluence-information-macro-icon"></span><div
class="confluence-information-macro-body">
+<p>It is not recommended that you use the fanout URI for consumers. Also, if a
producer fans out across multiple brokers, who happen to be inter-connected,
then there is a very high likelihood that a consumer on one of those brokers
will get duplicate messages.</p></div></div>
<h5 id="FanoutTransportReference-ExampleURI">Example URI</h5>
@@ -136,14 +120,8 @@ fanout:(multicast://default)?minAckCount
</pre>
</div></div>
- <div class="aui-message hint shadowed information-macro">
- <p class="title">Applying parameters to discovered
transports</p>
- <span class="aui-icon icon-hint">Icon</span>
- <div class="message-content">
-
-<p>Because the Discovery transport is utilized for broker discovery, transport
parameters are applied to discovered brokers. See <a shape="rect"
href="discovery-transport-reference.html">Discovery Transport Reference</a>.</p>
- </div>
- </div></div>
+<div class="confluence-information-macro
confluence-information-macro-information"><p class="title">Applying parameters
to discovered transports</p><span class="aui-icon aui-icon-small
aui-iconfont-info confluence-information-macro-icon"></span><div
class="confluence-information-macro-body">
+<p>Because the Discovery transport is utilized for broker discovery, transport
parameters are applied to discovered brokers. See <a shape="rect"
href="discovery-transport-reference.html">Discovery Transport
Reference</a>.</p></div></div></div>
</td>
<td valign="top">
<div class="navigation">
Modified: websites/production/activemq/content/geronimo.html
==============================================================================
--- websites/production/activemq/content/geronimo.html (original)
+++ websites/production/activemq/content/geronimo.html Sat Jun 27 21:23:55 2015
@@ -32,15 +32,6 @@
</style>
<![endif]-->
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shCore.css'
rel='stylesheet' type='text/css' />
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shThemeEclipse.css'
rel='stylesheet' type='text/css' />
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shCore.js'
type='text/javascript'></script>
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shBrushJava.js'
type='text/javascript'></script>
-
- <script type="text/javascript">
- SyntaxHighlighter.defaults['toolbar'] = false;
- SyntaxHighlighter.all();
- </script>
<title>
Apache ActiveMQ ™ -- Geronimo
@@ -98,7 +89,7 @@ The following deployment descriptor can
ConnectionFactory: weatherTopic and weatherRequestsTopic</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<connector
xmlns="http://geronimo.apache.org/xml/ns/j2ee/connector"
version="1.5"
@@ -172,7 +163,7 @@ name="PhysicalName">weather
<p>Then deploy it using Geronimo's deploy tool :</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
D:\geronimo>java -jar bin\deployer.jar deploy
d:\projects\weather\src\resources\
geronimo-activemq.xml repository\activemq\rars\activemq-ra-3.1-SNAPSHOT.rar
Username: system
@@ -216,7 +207,7 @@ jms.weatherRequestsTopic=weatherRequests
<ul class="alternate"><li>Now, in your Spring description file, declare the
bean that will read<br clear="none">
the properties from the bootstrap.properties file
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
<bean id="placeholderConfig"
class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
<property
name="location"><value>classpath:/bootstrap.properties</value></property>
@@ -227,7 +218,7 @@ the properties from the bootstrap.proper
<ul class="alternate"><li>Create a JNDI template (A Spring-specific wrapper
around the JNDI InitialContext
<div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
<bean id="jndiTemplate"
class="org.springframework.jndi.JndiTemplate">
<property name="environment">
<props>
@@ -251,7 +242,7 @@ the properties from the bootstrap.proper
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
<bean id="internalJmsQueueConnectionFactory"
class="org.springframework.jndi.JndiObjectFactoryBean">
<property name="jndiTemplate">
@@ -272,7 +263,7 @@ it should match the name of the deployed
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
<bean id="weatherTopic"
class="org.springframework.jndi.JndiObjectFactoryBean"
singleton="true">
Modified: websites/production/activemq/content/getting-started.html
==============================================================================
--- websites/production/activemq/content/getting-started.html (original)
+++ websites/production/activemq/content/getting-started.html Sat Jun 27
21:23:55 2015
@@ -32,15 +32,6 @@
</style>
<![endif]-->
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shCore.css'
rel='stylesheet' type='text/css' />
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shThemeEclipse.css'
rel='stylesheet' type='text/css' />
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shCore.js'
type='text/javascript'></script>
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shBrushJava.js'
type='text/javascript'></script>
-
- <script type="text/javascript">
- SyntaxHighlighter.defaults['toolbar'] = false;
- SyntaxHighlighter.all();
- </script>
<title>
Apache ActiveMQ ™ -- Getting Started
@@ -81,41 +72,34 @@
<tbody>
<tr>
<td valign="top" width="100%">
-<div class="wiki-content maincontent"><h2
id="GettingStarted-Introduction">Introduction</h2><p>This document describes
how to install and configure ActiveMQ 4.x/5.x for both Unix and Windows'
platforms.</p><h2 id="GettingStarted-DocumentOrganization">Document
Organization</h2><p>The Getting Started Guide for ActiveMQ 4.x document
contains the following sections:</p><ul><li><a shape="rect"
href="#GettingStarted-Introduction">#Introduction</a></li><li><a shape="rect"
href="#GettingStarted-DocumentOrganization">#Document
Organization</a></li><li><a shape="rect"
href="#GettingStarted-Pre-InstallationRequirements">#Pre-Installation
Requirements</a></li><li><a shape="rect"
href="#GettingStarted-InstallationProcedureforWindows">#Installation Procedure
for Windows</a><ul><li><a shape="rect"
href="#GettingStarted-WindowsBinaryInstallation">#Windows Binary
Installation</a></li><li><a shape="rect"
href="#GettingStarted-WindowsSourceInstallation">#Windows Source
Installation</a></li><li><a shap
e="rect" href="#GettingStarted-WindowsDevelopers&#39;Release">#Windows
Developers' Release</a></li></ul></li><li><a shape="rect"
href="#GettingStarted-InstallationProcedureforUnix">#Installation Procedure for
Unix</a><ul><li><a shape="rect"
href="#GettingStarted-UnixBinaryInstallation">#Unix Binary
Installation</a></li><li><a shape="rect"
href="#GettingStarted-UsingHomebrewinstalleronOSX">#Using Homebrew installer on
OSX</a></li><li><a shape="rect"
href="#GettingStarted-UnixSourceInstallation">#Unix Source
Installation</a></li><li><a shape="rect"
href="#GettingStarted-UnixDevelopers&#39;Release">#Unix Developers'
Release</a></li></ul></li><li><a shape="rect"
href="#GettingStarted-StartingActiveMQ">#Starting ActiveMQ</a></li><li><a
shape="rect" href="#GettingStarted-TestingtheInstallation">#Testing the
Installation</a></li><li><a shape="rect"
href="#GettingStarted-MonitoringActiveMQ">#Monitoring ActiveMQ</a></li><li><a
shape="rect" href="#GettingStarted-StoppingActiveMQ">#Sto
pping ActiveMQ</a></li><li><a shape="rect"
href="#GettingStarted-ConfiguringActiveMQ">#Configuring
ActiveMQ</a></li></ul><h2
id="GettingStarted-Pre-InstallationRequirements">Pre-Installation
Requirements</h2><p><strong>Hardware:</strong></p><ul><li>~ 60 MB of free disk
space for the ActiveMQ 5.x binary distribution.<br clear="none">(you need
additional disk space for storing persistent messages to disk)</li><li>~ 300 MB
of free disk space for the ActiveMQ 5.x source or developer's
distributions.</li></ul><p><strong>Operating
Systems:</strong></p><ul><li>Windows: Windows XP SP2, Windows 2000, Windows
Vista, Windows 7.</li><li>Unix: Ubuntu Linux, Powerdog Linux, MacOS, AIX,
HP-UX, Solaris, or any Unix platform that supports
Java.</li></ul><p><strong>Environment:</strong></p><ul><li><a shape="rect"
class="external-link"
href="http://www.oracle.com/technetwork/java/javase/downloads/index.html";
rel="nofollow">Java Developer Kit (JDK)</a>  <strong>JDK 1.7</strong> (1.6
for version &l
t;=5.10.0)</li><li>The JAVA_HOME environment variable must be set to the
directory where the JDK is installed<br clear="none">(Unix: the binary "java"
have to be resolvable by the PATH variable, execute "which java" to
verify)</li><li><a shape="rect" class="external-link"
href="http://maven.apache.org/";>Maven</a> 3.0.0 build system<br
clear="none">(only for development purposes)</li><li><a shape="rect"
class="external-link"
href="http://cvs.apache.org/repository/geronimo-spec/jars/";>JARs</a> that will
be used must be added to the classpath.<br clear="none">(only for enhanced
configuration)</li></ul><h2
id="GettingStarted-InstallationProcedureforWindows">Installation Procedure for
Windows</h2><p>This section of the Getting Started Guide explains how to
install binary and source distributions of ActiveMQ on a Windows system.</p><h4
id="GettingStarted-WindowsBinaryInstallation">Windows Binary
Installation</h4><p>This procedure explains how to download and install the
binary distributio
n on a Windows system.</p><ol><li>Download the latest release<br
clear="none">(see <a shape="rect" href="download.html">Download</a> ->
"The latest stable release" -> "<span
class="external-link">apache-activemq-x.x.x-bin.zip</span>")</li><li>Extract
the files from the ZIP file into a directory of your choice.</li><li>Proceed to
the <a shape="rect" href="#GettingStarted-StartingActiveMQ">#Starting
ActiveMQ</a> section of this document.</li><li>Following start-up, go to the <a
shape="rect" href="#GettingStarted-TestingtheInstallation">#Testing the
Installation</a> section of this document.</li></ol><h4
id="GettingStarted-WindowsSourceInstallation">Windows Source
Installation</h4><p>This procedure explains how to download and install the
source distribution on a Windows system.</p><ol><li>Download the latest
release<br clear="none">(see <a shape="rect"
href="download.html">Download</a> -> "The latest stable release" ->
"<span class="external-link">apache-activemq
-x.x.x-source-release.zip</span>")</li><li>Extract ActiveMQ from the ZIP file
into a directory of your choice.</li><li><p><span
class="confluence-anchor-link"
id="GettingStarted-WindowsSourceInstallation"></span><br clear="none">The
recommended method of building ActiveMQ is the following:</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[REM add "-Dmaven.test.skip=true" if
tests are failing on your system (should not happen)
+<div class="wiki-content maincontent"><h2
id="GettingStarted-Introduction">Introduction</h2><p>This document describes
how to install and configure ActiveMQ 4.x/5.x for both Unix and Windows'
platforms.</p><h2 id="GettingStarted-DocumentOrganization">Document
Organization</h2><p>The Getting Started Guide for ActiveMQ 4.x document
contains the following sections:</p><ul><li><a shape="rect"
href="#GettingStarted-Introduction">#Introduction</a></li><li><a shape="rect"
href="#GettingStarted-DocumentOrganization">#Document
Organization</a></li><li><a shape="rect"
href="#GettingStarted-Pre-InstallationRequirements">#Pre-Installation
Requirements</a></li><li><a shape="rect"
href="#GettingStarted-InstallationProcedureforWindows">#Installation Procedure
for Windows</a><ul><li><a shape="rect"
href="#GettingStarted-WindowsBinaryInstallation">#Windows Binary
Installation</a></li><li><a shape="rect"
href="#GettingStarted-WindowsSourceInstallation">#Windows Source
Installation</a></li><li><a shap
e="rect" href="#GettingStarted-WindowsDevelopers'Release">#Windows Developers'
Release</a></li></ul></li><li><a shape="rect"
href="#GettingStarted-InstallationProcedureforUnix">#Installation Procedure for
Unix</a><ul><li><a shape="rect"
href="#GettingStarted-UnixBinaryInstallation">#Unix Binary
Installation</a></li><li><a shape="rect"
href="#GettingStarted-UsingHomebrewinstalleronOSX">#Using Homebrew installer on
OSX</a></li><li><a shape="rect"
href="#GettingStarted-UnixSourceInstallation">#Unix Source
Installation</a></li><li><a shape="rect"
href="#GettingStarted-UnixDevelopers'Release">#Unix Developers'
Release</a></li></ul></li><li><a shape="rect"
href="#GettingStarted-StartingActiveMQ">#Starting ActiveMQ</a></li><li><a
shape="rect" href="#GettingStarted-TestingtheInstallation">#Testing the
Installation</a></li><li><a shape="rect"
href="#GettingStarted-MonitoringActiveMQ">#Monitoring ActiveMQ</a></li><li><a
shape="rect" href="#GettingStarted-StoppingActiveMQ">#Stopping ActiveMQ</
a></li><li><a shape="rect"
href="#GettingStarted-ConfiguringActiveMQ">#Configuring
ActiveMQ</a></li></ul><h2
id="GettingStarted-Pre-InstallationRequirements">Pre-Installation
Requirements</h2><p><strong>Hardware:</strong></p><ul><li>~ 60 MB of free disk
space for the ActiveMQ 5.x binary distribution.<br clear="none">(you need
additional disk space for storing persistent messages to disk)</li><li>~ 300 MB
of free disk space for the ActiveMQ 5.x source or developer's
distributions.</li></ul><p><strong>Operating
Systems:</strong></p><ul><li>Windows: Windows XP SP2, Windows 2000, Windows
Vista, Windows 7.</li><li>Unix: Ubuntu Linux, Powerdog Linux, MacOS, AIX,
HP-UX, Solaris, or any Unix platform that supports
Java.</li></ul><p><strong>Environment:</strong></p><ul><li><a shape="rect"
class="external-link"
href="http://www.oracle.com/technetwork/java/javase/downloads/index.html";
rel="nofollow">Java Developer Kit (JDK)</a>  <strong>JDK 1.7</strong> (1.6
for version <=5.10.0)</li><
li>The JAVA_HOME environment variable must be set to the directory where the
JDK is installed<br clear="none">(Unix: the binary "java" have to be resolvable
by the PATH variable, execute "which java" to verify)</li><li><a shape="rect"
class="external-link" href="http://maven.apache.org/";>Maven</a> 3.0.0 build
system<br clear="none">(only for development purposes)</li><li><a shape="rect"
class="external-link"
href="http://cvs.apache.org/repository/geronimo-spec/jars/";>JARs</a> that will
be used must be added to the classpath.<br clear="none">(only for enhanced
configuration)</li></ul><h2
id="GettingStarted-InstallationProcedureforWindows">Installation Procedure for
Windows</h2><p>This section of the Getting Started Guide explains how to
install binary and source distributions of ActiveMQ on a Windows system.</p><h4
id="GettingStarted-WindowsBinaryInstallation">Windows Binary
Installation</h4><p>This procedure explains how to download and install the
binary distribution on a Windows s
ystem.</p><ol><li>Download the latest release<br clear="none">(see <a
shape="rect" href="download.html">Download</a> -> "The latest stable
release" -> "<span
class="external-link">apache-activemq-x.x.x-bin.zip</span>")</li><li>Extract
the files from the ZIP file into a directory of your choice.</li><li>Proceed to
the <a shape="rect" href="#GettingStarted-StartingActiveMQ">#Starting
ActiveMQ</a> section of this document.</li><li>Following start-up, go to the <a
shape="rect" href="#GettingStarted-TestingtheInstallation">#Testing the
Installation</a> section of this document.</li></ol><h4
id="GettingStarted-WindowsSourceInstallation">Windows Source
Installation</h4><p>This procedure explains how to download and install the
source distribution on a Windows system.</p><ol><li>Download the latest
release<br clear="none">(see <a shape="rect"
href="download.html">Download</a> -> "The latest stable release" ->
"<span class="external-link">apache-activemq-x.x.x-source-re
lease.zip</span>")</li><li>Extract ActiveMQ from the ZIP file into a directory
of your choice.</li><li><p><span class="confluence-anchor-link"
id="GettingStarted-WindowsSourceInstallation"></span><br clear="none">The
recommended method of building ActiveMQ is the following:</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[REM add "-Dmaven.test.skip=true" if
tests are failing on your system (should not happen)
mvn clean install
]]></script>
</div></div><p>where [activemq_install_dir] is the directory in which ActiveMQ
was installed.</p></li><li><p>If you prefer to use an IDE, then you can
auto-generate the IDE's project file using maven plugins:</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[mvn eclipse:eclipse
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[mvn eclipse:eclipse
]]></script>
</div></div><p>or</p><div class="code panel pdl" style="border-width:
1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[mvn idea:idea
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[mvn idea:idea
]]></script>
</div></div><p>Feel free to use any other applicable IDE. Please refer to the
<a shape="rect" class="external-link"
href="http://maven.apache.org/reference/plugins/plugins.html";>plugin
reference</a> for more details.</p></li></ol><ol><li><p>Start ActiveMQ from the
target directory, for example:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[cd [activemq_install_dir]\assembly\target
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[cd [activemq_install_dir]\assembly\target
unzip activemq-x.x-SNAPSHOT.zip
cd activemq-x.x-SNAPSHOT
bin\activemq
]]></script>
-</div></div><p><strong>NOTE:</strong> Working directories get created relative
to the current directory. To create the working directories in the proper
place, ActiveMQ must be launched from its home/installation
directory.</p></li><li><p>Proceed to the <a shape="rect"
href="#GettingStarted-TestingtheInstallation">#Testing the Installation</a>
section.</p> <div class="aui-message problem shadowed information-macro">
- <p class="title">Warning</p>
- <span class="aui-icon icon-problem">Icon</span>
- <div class="message-content">
- <p>If you are building ActiveMQ 4.x under Windows
using Cygwin there is a path name length limitation. If the path name length is
exceeded, you may see build errors. To correct this, move the ActiveMQ source
directory higher in the file system tree, e.g., /cygdrive/c/d/sm.</p>
- </div>
- </div>
-</li></ol><h4 id="GettingStarted-WindowsDeveloper'sRelease">Windows
Developer's Release</h4><p>This procedure explains how to download and install
the latest developer's snapshot.</p><ol><li>Open the release archive: <a
shape="rect" class="external-link"
href="https://repository.apache.org/content/repositories/snapshots/org/apache/activemq/apache-activemq/";>https://repository.apache.org/content/repositories/snapshots/org/apache/activemq/apache-activemq/</a><br
clear="none">(open one of the SNAPSHOT directories)</li><li>Select the version
of ActiveMQ to download (if necessary, scroll down to see the ActiveMQ
snapshots).</li><li>Extract the files from the ZIP file into a directory of
your choice.</li><li>If a binary snapshot was downloaded, proceed to the <a
shape="rect" href="#GettingStarted-StartingActiveMQ">#Starting ActiveMQ</a>
section of this document.<br clear="none"> If a source snapshot was downloaded,
perform step 6 and step 7 of the <a shape="rect" href="#GettingStarted-Win
dowsSourceInstallation">#Windows Source Installation</a>
procedure.</li><li>Following start-up, proceed to the <a shape="rect"
href="#GettingStarted-TestingtheInstallation">#Testing the Installation</a>
section.</li></ol><h2
id="GettingStarted-InstallationProcedureforUnix">Installation Procedure for
Unix</h2><h4
id="GettingStarted-UnixBinaryInstallationUnixBinaryInstallation"><span
class="confluence-anchor-link"
id="GettingStarted-UnixBinaryInstallation"></span> Unix Binary
Installation</h4><p>This procedure explains how to download and install the
binary distribution on a Unix system.<br clear="none"> <strong>NOTE:</strong>
There are several alternative ways to perform this type of
installation.</p><ol><li><p>Download the activemq zipped tarball file to the
Unix machine, using either a browser or a tool, i.e., wget, scp, ftp, etc. for
example:<br clear="none">(see <a shape="rect" href="download.html">Download</a>
-> "The latest stable release")</p><div class="code panel pdl" sty
le="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[wget
http://activemq.apache.org/path/tofile/apache-activemq-x.x.x-bin.tar.gz
+</div></div><p><strong>NOTE:</strong> Working directories get created relative
to the current directory. To create the working directories in the proper
place, ActiveMQ must be launched from its home/installation
directory.</p></li><li><p>Proceed to the <a shape="rect"
href="#GettingStarted-TestingtheInstallation">#Testing the Installation</a>
section.</p><div class="confluence-information-macro
confluence-information-macro-warning"><p class="title">Warning</p><span
class="aui-icon aui-icon-small aui-iconfont-error
confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>If you are building ActiveMQ 4.x
under Windows using Cygwin there is a path name length limitation. If the path
name length is exceeded, you may see build errors. To correct this, move the
ActiveMQ source directory higher in the file system tree, e.g.,
/cygdrive/c/d/sm.</p></div></div></li></ol><h4
id="GettingStarted-WindowsDeveloper'sRelease">Windows Developer's
Release</h4><p>Thi
s procedure explains how to download and install the latest developer's
snapshot.</p><ol><li>Open the release archive: <a shape="rect"
class="external-link"
href="https://repository.apache.org/content/repositories/snapshots/org/apache/activemq/apache-activemq/";>https://repository.apache.org/content/repositories/snapshots/org/apache/activemq/apache-activemq/</a><br
clear="none">(open one of the SNAPSHOT directories)</li><li>Select the version
of ActiveMQ to download (if necessary, scroll down to see the ActiveMQ
snapshots).</li><li>Extract the files from the ZIP file into a directory of
your choice.</li><li>If a binary snapshot was downloaded, proceed to the <a
shape="rect" href="#GettingStarted-StartingActiveMQ">#Starting ActiveMQ</a>
section of this document.<br clear="none"> If a source snapshot was downloaded,
perform step 6 and step 7 of the <a shape="rect"
href="#GettingStarted-WindowsSourceInstallation">#Windows Source
Installation</a> procedure.</li><li>Following start-up, pr
oceed to the <a shape="rect"
href="#GettingStarted-TestingtheInstallation">#Testing the Installation</a>
section.</li></ol><h2
id="GettingStarted-InstallationProcedureforUnix">Installation Procedure for
Unix</h2><h4
id="GettingStarted-UnixBinaryInstallationUnixBinaryInstallation"><span
class="confluence-anchor-link"
id="GettingStarted-UnixBinaryInstallation"></span> Unix Binary
Installation</h4><p>This procedure explains how to download and install the
binary distribution on a Unix system.<br clear="none"> <strong>NOTE:</strong>
There are several alternative ways to perform this type of
installation.</p><ol><li><p>Download the activemq zipped tarball file to the
Unix machine, using either a browser or a tool, i.e., wget, scp, ftp, etc. for
example:<br clear="none">(see <a shape="rect" href="download.html">Download</a>
-> "The latest stable release")</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[wget
http://activemq.apache.org/path/tofile/apache-activemq-x.x.x-bin.tar.gz
]]></script>
</div></div></li><li><p>Extract the files from the zipped tarball into a
directory of your choice. For example:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[cd [activemq_install_dir]
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[cd [activemq_install_dir]
tar zxvf activemq-x.x.x-bin.tar.gz
]]></script>
</div></div></li><li><p>Proceed to the <a shape="rect"
href="#GettingStarted-StartingActiveMQ">#Starting ActiveMQ</a> section of this
document.</p></li><li>Following start-up, go to the <a shape="rect"
href="#GettingStarted-TestingtheInstallation">#Testing the Installation</a>
section.</li></ol><h4 id="GettingStarted-UsingHomebrewinstalleronOSX">Using
Homebrew installer on OSX</h4><p>If you use OSX as your platform, you can use
<a shape="rect" class="external-link" href="http://mxcl.github.com/homebrew/";
rel="nofollow">Homebrew</a> package manager to easily install Apache
ActiveMQ.</p><ol><li><p>After installing Homebrew package manager successfully,
just run</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[$ brew install apache-activemq
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[$ brew install apache-activemq
]]></script>
</div></div><p>You can expect the following output:</p><div class="code panel
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[==> Downloading
http://www.gossipcheck.com/mirrors/apache/activemq/apache-activemq/x.x.x/apache-activemq-x.x.x-bin.tar.gz
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[==> Downloading
http://www.gossipcheck.com/mirrors/apache/activemq/apache-activemq/x.x.x/apache-activemq-x.x.x-bin.tar.gz
######################################################################## 100.0%
==> Caveats
Software was installed to:
@@ -124,59 +108,53 @@ Software was installed to:
/usr/local/Cellar/apache-activemq/x.x.x: 406 files, 35M, built in 2 seconds
]]></script>
</div></div></li></ol><p>ActiveMQ will be installed in
<code>/usr/local/Cellar/apache-activemq/x.x.x/</code> directory (where
<code>x.x.x</code> denotes the actual version being installed).</p><p>Now you
can proceed to <a shape="rect"
href="#GettingStarted-StartingActiveMQ">#Starting ActiveMQ</a> and <a
shape="rect" href="#GettingStarted-TestingtheInstallation">#Testing the
Installation</a> sections.</p><h4
id="GettingStarted-UnixSourceInstallation">Unix Source Installation</h4><p>This
procedure explains how to download and install the source distribution on a
Unix system. This procedure assumes the Unix machine has a browser. Please see
the previous <a shape="rect"
href="#GettingStarted-UnixBinaryInstallation">#Unix Binary Installation</a>
section for details on how to install ActiveMQ without a
browser.</p><ol><li>Download the latest source release<br
clear="none">(see <a shape="rect" href="download.html">Download</a> ->
"The latest stable release" -> "<span class="exte
rnal-link">activemq-parent-x.x.x-source-release.zip</span>")</li><li><p>Extract
the files from the ZIP file into a directory of your choice. For
example:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[tar zxvf activemq.x.x-src.tar.gz
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[tar zxvf activemq.x.x-src.tar.gz
]]></script>
</div></div></li><li><p>Build ActiveMQ using Maven:<br clear="none"> The
preferred method of building ActiveMQ is the following:</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[cd [activemq_install_dir]
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[cd [activemq_install_dir]
mvn clean install # add "-Dmaven.test.skip=true" if tests are
failing on your system (should not happen)]]></script>
</div></div><p>If Maven crashes with a java.lang.OutOfMemoryError, you you
need to do this first (assuming a Bourne-like shell):</p><div class="code panel
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[export MAVEN_OPTS="-Xmx512M"
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[export MAVEN_OPTS="-Xmx512M"
]]></script>
</div></div><p>If you prefer to use an IDE then you can auto-generate the
IDE's project file using maven plugins:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[mvn eclipse:eclipse
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[mvn eclipse:eclipse
]]></script>
</div></div><p>or</p><div class="code panel pdl" style="border-width:
1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[mvn idea:idea
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[mvn idea:idea
]]></script>
</div></div><p>Feel free to use any other applicable IDE. Please refer to the
<a shape="rect" class="external-link"
href="http://maven.apache.org/reference/plugins/plugins.html";>plugin
reference</a> for more details.<br clear="none"> <strong>NOTE:</strong> Working
directories get created relative to the current directory. To create working
directories in the proper place, ActiveMQ must be launched from its
home/installation directory.</p></li><li>Proceed to the <a shape="rect"
href="#GettingStarted-StartingActiveMQ">#Starting ActiveMQ</a> section of this
document.</li><li>Proceed to <a shape="rect"
href="#GettingStarted-TestingtheInstallation">#Testing the Installation</a>
section.</li></ol><h4 id="GettingStarted-UnixDeveloper'sRelease">Unix
Developer's Release</h4><p>This procedure explains how to download and install
the latest developer's snapshot.</p><ol><li>Open the release archive: <a
shape="rect" class="external-link"
href="https://repository.apache.org/content/repositories/s
napshots/org/apache/activemq/apache-activemq/">https://repository.apache.org/content/repositories/snapshots/org/apache/activemq/apache-activemq/</a><br
clear="none">(open one of the SNAPSHOT directories)</li><li>Select the version
of ActiveMQ to download (you may have to scroll down to see the ActiveMQ
snapshots). <br clear="none">The filename will be similar to:
<code>activemq-x.x.x-tar.gz</code>.</li><li><p>Extract the files from the gzip
file into a directory of your choice. For example:<br clear="none"> For a
binary developer's snapshot:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[tar zxvf activemq-x.x.x.tar.gz
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[tar zxvf activemq-x.x.x.tar.gz
]]></script>
</div></div><p>For a source developer's snapshot:</p><div class="code panel
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[tar zxvf activemq-x.x.x-src.tar.gz
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[tar zxvf activemq-x.x.x-src.tar.gz
]]></script>
</div></div></li><li><p>If a binary snapshot was downloaded, to make it
executable, the <code>ActiveMQ</code> script may need its permissions
changed:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[cd [activemq_install_dir]/bin
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[cd [activemq_install_dir]/bin
chmod 755 activemq
]]></script>
</div></div></li><li>For a binary snapshot, proceed to the <a shape="rect"
href="#GettingStarted-StartingActiveMQ">#Starting ActiveMQ</a> section of this
document.</li><li>If a source snapshot was downloaded perform steps 6 - 8 of
the <a shape="rect" href="#GettingStarted-UnixSourceInstallation">#Unix Source
Installation</a> procedure.</li><li>Proceed to the <a shape="rect"
href="#GettingStarted-TestingtheInstallation">#Testing the Installation</a>
section.</li></ol><h2
id="GettingStarted-StartingActiveMQStartingActiveMQ"><span
class="confluence-anchor-link" id="GettingStarted-StartingActiveMQ"></span>
Starting ActiveMQ</h2><p>There now follows instructions on how to <a
shape="rect" href="run-broker.html">run the ActiveMQ Message Broker</a>.</p><h4
id="GettingStarted-OnWindows:">On Windows:</h4><p>From a console window, change
to the installation directory and run <code>ActiveMQ</code>:</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pd
l">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[cd [activemq_install_dir]
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[cd [activemq_install_dir]
]]></script>
</div></div><p>where <code>activemq_install_dir</code> is the directory in
which ActiveMQ was installed, e.g., <code>c:\Program Files\ActiveMQ-5.x</code>.
<br clear="none" class="atl-forced-newline"> Then type:</p><div class="code
panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[bin\activemq
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[bin\activemq
]]></script>
</div></div><p><strong>NOTE:</strong> Working directories get created relative
to the current directory. To create working directories in the proper place,
ActiveMQ must be launched from its home/installation directory.</p><h4
id="GettingStarted-OnUnix:">On Unix:</h4><p>From a command shell, change to the
installation directory and run <code>ActiveMQ</code> as a
<strong>foregroud</strong> process:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[cd [activemq_install_dir]/bin
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[cd [activemq_install_dir]/bin
./activemq console]]></script>
</div></div><p>From a command shell, change to the installation directory and
run <code>ActiveMQ</code> as a <strong>daemon</strong> process:</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[cd [activemq_install_dir]/bin
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[cd [activemq_install_dir]/bin
./activemq start]]></script>
</div></div><h3 id="GettingStarted-Morehelp">More help</h3><p>For other ways
of running the broker see <a shape="rect" href="run-broker.html">Here</a>. For
example you can run an <a shape="rect"
href="how-do-i-embed-a-broker-inside-a-connection.html">embedded broker</a>
inside your JMS Connection to avoid starting a separate process.</p><h2
id="GettingStarted-TestingtheInstallationTestingtheInstallation"><span
class="confluence-anchor-link"
id="GettingStarted-TestingtheInstallation"></span> Testing the
Installation</h2><h3 id="GettingStarted-Usingtheadministrativeinterface">Using
the administrative interface</h3><ul><li>Open the administrative
interface</li><li style="list-style-type: none;background-image:
none;"><ul><li>URL: <a shape="rect" class="external-link"
href="http://127.0.0.1:8161/admin/";
rel="nofollow">http://127.0.0.1:8161/admin/</a></li><li>Login:
admin</li><li>Passwort: admin</li></ul></li><li>Navigate to
"Queues"</li><li>Add a queue name and click create</li><li>Send
test message by klicking on "Send to"</li></ul><h3
id="GettingStarted-Logfileandconsoleoutput">Logfile and console
output</h3><p>If ActiveMQ is up and running without problems, the Window's
console window or the Unix command shell will display information similar to
the following log line:<br clear="none">(see stdout output or
"[activemq_install_dir]/data/activemq.log")</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[Apache ActiveMQ 5.11.1 (localhost,
ID:ntbk11111-50816-1428933306116-0:1) started |
org.apache.activemq.broker.BrokerService | main
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[Apache ActiveMQ 5.11.1 (localhost,
ID:ntbk11111-50816-1428933306116-0:1) started |
org.apache.activemq.broker.BrokerService | main
]]></script>
</div></div><h3 id="GettingStarted-Listenport">Listen port</h3><p>ActiveMQ's
default port is 61616. From another window run netstat and search for port
61616.</p><p>From a Windows console, type:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[netstat -an|find "61616"
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[netstat -an|find "61616"
]]></script>
</div></div><p><strong>OR</strong></p><p>From a Unix command shell,
type:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[netstat -nl|grep 61616
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[netstat -nl|grep 61616
]]></script>
-</div></div><h2 id="GettingStarted-MonitoringActiveMQ">Monitoring
ActiveMQ</h2><p>You can monitor ActiveMQ using the <a shape="rect"
href="web-console.html">Web Console</a> by pointing your browser at</p><p><a
shape="rect" class="external-link" href="http://localhost:8161/admin";
rel="nofollow">http://localhost:8161/admin</a></p> <div class="aui-message
hint shadowed information-macro">
- <span class="aui-icon icon-hint">Icon</span>
- <div class="message-content">
- <p>From ActiveMQ 5.8 onwards the web apps is
secured out of the box.<br clear="none"> The default username and password is
admin/admin. You can configure this in the conf/jetty-real.properties file.</p>
- </div>
- </div>
-<p>Or you can use the <a shape="rect" href="jmx.html">JMX</a> support to view
the running state of ActiveMQ.</p><p>For more information see the file
<code>docs/WebConsole-README.txt</code> in the distribution.</p><h2
id="GettingStarted-StoppingActiveMQ">Stopping ActiveMQ</h2><p>For both Windows
and Unix installations, terminate ActiveMQ by typing "CTRL-C" in the console or
command shell in which it is running.</p><p>If ActiveMQ was started in the
background on Unix, the process can be killed, with the following:</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[cd [activemq_install_dir]/bin
+</div></div><h2 id="GettingStarted-MonitoringActiveMQ">Monitoring
ActiveMQ</h2><p>You can monitor ActiveMQ using the <a shape="rect"
href="web-console.html">Web Console</a> by pointing your browser at</p><p><a
shape="rect" class="external-link" href="http://localhost:8161/admin";
rel="nofollow">http://localhost:8161/admin</a></p><div
class="confluence-information-macro
confluence-information-macro-information"><span class="aui-icon aui-icon-small
aui-iconfont-info confluence-information-macro-icon"></span><div
class="confluence-information-macro-body"><p>From ActiveMQ 5.8 onwards the web
apps is secured out of the box.<br clear="none"> The default username and
password is admin/admin. You can configure this in the
conf/jetty-real.properties file.</p></div></div><p>Or you can use the <a
shape="rect" href="jmx.html">JMX</a> support to view the running state of
ActiveMQ.</p><p>For more information see the file
<code>docs/WebConsole-README.txt</code> in the distribution.</p><h2 id="Getti
ngStarted-StoppingActiveMQ">Stopping ActiveMQ</h2><p>For both Windows and Unix
installations, terminate ActiveMQ by typing "CTRL-C" in the console or command
shell in which it is running.</p><p>If ActiveMQ was started in the background
on Unix, the process can be killed, with the following:</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[cd [activemq_install_dir]/bin
./activemq stop
]]></script>
</div></div><h2 id="GettingStarted-ConfiguringActiveMQ">Configuring
ActiveMQ</h2><p>The ActiveMQ broker should now run. You can configure the
broker by specifying an <a shape="rect" href="xml-configuration.html">Xml
Configuration</a> file as a parameter to the <em>activemq</em> command. An
alternative is to use the <a shape="rect"
href="broker-configuration-uri.html">Broker Configuration URI</a> to configure
things on the command line in a concise format (though the configuration
options are not as extensive as if you use Java or XML code). You can
also</p><p>Also see <a shape="rect"
href="configuring-transports.html">Configuring Transports</a> to see how you
can configure the various connection, transport and broker options using the
connection URL in the ActiveMQConnectionFactory.</p><p>See the <a shape="rect"
href="initial-configuration.html">Initial Configuration</a> for details of
which jars you need to add to your classpath to start using ActiveMQ in your
Java code</p><p>If yo
u want to use JNDI to connect to your JMS provider then please view the <a
shape="rect" href="jndi-support.html">JNDI Support</a>. If you are a Spring
user you should read about <a shape="rect" href="spring-support.html">Spring
Support</a></p><p>After the installation, ActiveMQ is running with a basic
configuration. For details on configuring options, please see refer to the <a
shape="rect" href="configuration.html">Configuration</a> section.</p><h2
id="GettingStarted-AdditionalResources">Additional Resources</h2><p>If you are
new to using ActiveMQ, running the <a shape="rect" href="web-samples.html">Web
Samples</a> or the <a shape="rect" href="examples.html">Examples</a> is a good
next step to learn more about ActiveMQ.</p><p>The Commercial Providers listed
on the <a shape="rect" href="support.html">Support</a> page may also have
additional documentation, examples, tutorials, etc... that can help you get
started.</p></div>
Modified: websites/production/activemq/content/group-membership.html
==============================================================================
--- websites/production/activemq/content/group-membership.html (original)
+++ websites/production/activemq/content/group-membership.html Sat Jun 27
21:23:55 2015
@@ -32,15 +32,6 @@
</style>
<![endif]-->
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shCore.css'
rel='stylesheet' type='text/css' />
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shThemeEclipse.css'
rel='stylesheet' type='text/css' />
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shCore.js'
type='text/javascript'></script>
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shBrushJava.js'
type='text/javascript'></script>
-
- <script type="text/javascript">
- SyntaxHighlighter.defaults['toolbar'] = false;
- SyntaxHighlighter.all();
- </script>
<title>
Apache ActiveMQ ™ -- Group Membership
@@ -86,7 +77,7 @@ You have to explicitly say which group y
Each GroupChannel has both a globally unique id and a name.</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[
+<script class="brush: java; gutter: false; theme: Default"
type="syntaxhighlighter"><![CDATA[
import org.apache.activeblaze.group.*;
Modified: websites/production/activemq/content/hello-world.html
==============================================================================
--- websites/production/activemq/content/hello-world.html (original)
+++ websites/production/activemq/content/hello-world.html Sat Jun 27 21:23:55
2015
@@ -32,15 +32,6 @@
</style>
<![endif]-->
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shCore.css'
rel='stylesheet' type='text/css' />
- <link
href='http://activemq.apache.org/styles/highlighter/styles/shThemeEclipse.css'
rel='stylesheet' type='text/css' />
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shCore.js'
type='text/javascript'></script>
- <script
src='http://activemq.apache.org/styles/highlighter/scripts/shBrushJava.js'
type='text/javascript'></script>
-
- <script type="text/javascript">
- SyntaxHighlighter.defaults['toolbar'] = false;
- SyntaxHighlighter.all();
- </script>
<title>
Apache ActiveMQ ™ -- Hello World
@@ -89,7 +80,7 @@
<p>The point of this example is to show you the basic code required to use JMS
in a straightforward way. The Consumers and Producers could very easy be on
completely different machines or in different processes.</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader
panelHeader pdl" style="border-bottom-width: 1px;"><b>App.java</b></div><div
class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><