blob: 078482a50d2d2ec0335165e433a1828ca814e9e4 [file] [log] [blame]
<div class="wiki-content maincontent"><div style="padding-right:20px;float:left;margin-left:-20px;">
<p><span class="confluence-embedded-file-wrapper"><img class="confluence-embedded-image confluence-external-resource" src="http://activemq.apache.org/activemq-500-release.data/activemq-5.x-box-reflection.png" data-image-src="http://activemq.apache.org/activemq-500-release.data/activemq-5.x-box-reflection.png"></span></p></div>
<p>Apache ActiveMQ 5.8.0 resolves <a shape="rect" class="external-link" href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;jqlQuery=project+%3D+AMQ+AND+fixVersion+%3D+%225.8.0%22+AND+status+%3D+Resolved+ORDER+BY+priority+DESC&amp;mode=hide">160 issues</a>, mostly bug fixes and improvements. It has the following new features:</p><p></p><ul><li><a shape="rect" href="amqp.html">AMQP</a></li><li>new feature modules and activemq-client module allowing smaller foorprint</li><li>management via <a shape="rect" href="rest.html">REST</a> with <a shape="rect" class="external-link" href="http://www.jolokia.org/" rel="nofollow">jolokia</a> jmx to http bridge</li><li>Includes <a shape="rect" class="external-link" href="http://camel.apache.org/camel-2103-release.html">Apache Camel 2.10.3</a></li><li>Java 7 support (compiled with jdk6 and validated with jdk7)</li><li><a shape="rect" href="pure-master-slave.html">Pure Master Slave</a> no longer supported</li></ul> There are some changes in 5.8 that may require some code change
<ol><li>New modules may effect your maven pom dependencies<br clear="none">
<code>activemq-core</code> has been replaced with <code>activemq-client</code> and <code>activemq-broker</code>. The various message stores have their own activemq-xx-store module. The uber module <code>activemq-all</code> remains.</li><li>Changed JMX Mbean ObjectNames will effect scripts or tools that directly reference Mbean names<br clear="none">
All mbeans now share the type=Broker attribute, which gives them containment. In this way, consumers hang off of destinations, which hang off the broker.<br clear="none">
The different Mbean types are identified by the presence of specific identifiers in their ObjectNames. The mapping from old to new ObjectName is as follows:
<div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p> Type </p></th><th colspan="1" rowspan="1" class="confluenceTh"><p> Old Name </p></th><th colspan="1" rowspan="1" class="confluenceTh"><p> New Name </p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> Broker </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Type=Broker </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> type=Broker </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> Destination </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Type=Queue|Topic,Destination=&lt;destination identifier&gt; </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> type=Broker,destinationType=Queue|Topic,destinationName=&lt;destination identifier&gt; </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> Connector </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Type=Connector </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> type=Broker,connector=clientConnectors </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> NetworkConnector </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Type=NetworkConnector </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> type=Broker,connector=networkConnectors </p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p> Connection </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> Type=Connection </p></td><td colspan="1" rowspan="1" class="confluenceTd"><p> type=Broker,connector=*,connectionViewType=remoteAddress|clientId </p></td></tr></tbody></table></div>
</li><li>OSGi integration has changed. The full details are at <a shape="rect" href="osgi-integration.html">OSGi Integration</a>. In summary:
<ol><li>There is a single uber OSGI bundle</li><li>The broker and webconsole are now configured via config admin pid files through an OSGi managed service factory.</li></ol>
</li><li>The ActiveMQ binary file <code>bin/run.jar</code> has been renamed to <code>bin/activemq.jar</code>.</li></ol><h2 id="ActiveMQ5.8.0Release-GettingtheBinaryDistributions">Getting the Binary Distributions</h2><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Download Link</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>PGP Signature file of download</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Windows Distribution</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://archive.apache.org/dist/activemq/apache-activemq/5.8.0/apache-activemq-5.8.0-bin.zip">apache-activemq-5.8.0-bin.zip</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://archive.apache.org/dist/activemq/apache-activemq/5.8.0/apache-activemq-5.8.0-bin.zip.asc">apache-activemq-5.8.0-bin.zip.asc</a></p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Unix/Linux/Cygwin Distribution</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://archive.apache.org/dist/activemq/apache-activemq/5.8.0/apache-activemq-5.8.0-bin.tar.gz">apache-activemq-5.8.0-bin.tar.gz</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://archive.apache.org/dist/activemq/apache-activemq/5.8.0/apache-activemq-5.8.0-bin.tar.gz.asc">apache-activemq-5.8.0-bin.tar.gz.asc</a></p></td></tr></tbody></table></div><p></p><h2 id="ActiveMQ5.8.0Release-VerifytheIntegrityofDownloads">Verify the Integrity of Downloads</h2><p>It is essential that you verify the integrity of the downloaded files using the PGP or MD5 signatures. The PGP signatures can be verified using PGP or GPG. Begin by following these steps:</p><ol><li>Download the <a shape="rect" class="external-link" href="http://www.apache.org/dist/activemq/KEYS">KEYS</a></li><li>Download the asc signature file for the relevant distribution</li><li><p>Verify the signatures using the following commands, depending on your use of PGP or GPG:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">$ pgpk -a KEYS
$ pgpv apache-activemq-&lt;version&gt;-bin.tar.gz.asc
</pre>
</div></div><p>or</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">$ pgp -ka KEYS
$ pgp apache-activemq-&lt;version&gt;-bin.tar.gz.asc
</pre>
</div></div><p>or</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">$ gpg --import KEYS
$ gpg --verify apache-activemq-&lt;version&gt;-bin.tar.gz.asc
</pre>
</div></div></li></ol><p>(Where &lt;version&gt; is replaced with the actual version, e.g., 5.1.0, 5.2.0, etc.).</p><p>Alternatively, you can verify the MD5 signature on the files. A Unix program called <code>md5</code> or <code>md5sum</code> is included in most Linux and Unix distributions. It is also available as part of <a shape="rect" class="external-link" href="http://www.gnu.org/software/textutils/textutils.html" rel="nofollow">GNU Textutils</a>. Windows users can utilize any of the following md5 programs:</p><ul><li><a shape="rect" class="external-link" href="http://www.fourmilab.ch/md5/" rel="nofollow">md5</a></li><li><a shape="rect" class="external-link" href="http://www.pc-tools.net/win32/md5sums/" rel="nofollow">md5sums</a></li><li><a shape="rect" class="external-link" href="http://www.slavasoft.com/fsum/" rel="nofollow">SlavaSoft FSUM</a></li></ul><h2 id="ActiveMQ5.8.0Release-GettingtheBinariesusingMaven2">Getting the Binaries using Maven 2</h2><p>To use this release in your maven project, the proper dependency configuration that you should use in your <a shape="rect" class="external-link" href="http://maven.apache.org/guides/introduction/introduction-to-the-pom.html">Maven POM</a> is:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">&lt;dependency&gt;
&lt;groupId&gt;org.apache.activemq&lt;/groupId&gt;
&lt;artifactId&gt;activemq-all&lt;/artifactId&gt;
&lt;version&gt;5.8.0&lt;/version&gt;
&lt;/dependency&gt;
</pre>
</div></div><div></div>
<h2 id="ActiveMQ5.8.0Release-GettingtheSourceCode">Getting the Source Code</h2><h3 id="ActiveMQ5.8.0Release-SourceDistributions">Source Distributions</h3><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Description</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Download Link</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>PGP Signature file of download</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Source Release</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://archive.apache.org/dist/activemq/apache-activemq/5.8.0/activemq-parent-5.8.0-source-release.zip">activemq-parent-5.8.0-source-release.zip</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://archive.apache.org/dist/activemq/apache-activemq/5.8.0/activemq-parent-5.8.0-source-release.zip.asc">activemq-parent-5.8.0-source-release.zip.asc</a></p></td></tr></tbody></table></div><h3 id="ActiveMQ5.8.0Release-SVNTagCheckout">SVN Tag Checkout</h3><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">svn co http://svn.apache.org/repos/asf/activemq/tags/activemq-5.8.0
</pre>
</div></div><h2 id="ActiveMQ5.8.0Release-Changelog">Changelog</h2><p>For a more detailed view of new features and bug fixes, see the <a shape="rect" class="external-link" href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311210&amp;version=12323282">release notes</a></p><p>Also see the previous <a shape="rect" href="activemq-570-release.html">ActiveMQ 5.7.0 Release</a></p></div>