You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@activemq.apache.org by bu...@apache.org on 2016/04/05 04:21:47 UTC
svn commit: r984760 - in /websites/production/activemq/content:
cache/main.pageCache version-5-getting-started.html
version-5-initial-configuration.html
Author: buildbot
Date: Tue Apr 5 02:21:47 2016
New Revision: 984760
Log:
Production update by buildbot for activemq
Modified:
websites/production/activemq/content/cache/main.pageCache
websites/production/activemq/content/version-5-getting-started.html
websites/production/activemq/content/version-5-initial-configuration.html
Modified: websites/production/activemq/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/activemq/content/version-5-getting-started.html
==============================================================================
--- websites/production/activemq/content/version-5-getting-started.html (original)
+++ websites/production/activemq/content/version-5-getting-started.html Tue Apr 5 02:21:47 2016
@@ -81,7 +81,22 @@
<tbody>
<tr>
<td valign="top" width="100%">
-<div class="wiki-content maincontent"><h2 id="Version5GettingStarted-Introduction">Introduction</h2><p>This document describes how to install and configure ActiveMQ for both Unix and Windows' platforms.</p><h2 id="Version5GettingStarted-DocumentOrganization">Document Organization</h2><p>The Getting Started Guide for ActiveMQ contains the following sections:</p><ul><li><a shape="rect" href="version-5-getting-started.html">#Introduction</a></li><li><a shape="rect" href="version-5-getting-started.html">#Document Organization</a></li><li><a shape="rect" href="version-5-getting-started.html">#Pre-Installation Requirements</a></li><li><a shape="rect" href="version-5-getting-started.html">#Installation Procedure for Windows</a><ul><li><a shape="rect" href="version-5-getting-started.html">#Windows Binary Installation</a></li><li><a shape="rect" href="version-5-getting-started.html">#Windows Source Installation</a></li><li><a shape="rect" href="version-5-getting-started.html">#Windows Develo
pers' Release</a></li></ul></li><li><a shape="rect" href="version-5-getting-started.html">#Installation Procedure for Unix</a><ul><li><a shape="rect" href="version-5-getting-started.html">#Unix Binary Installation</a></li><li><a shape="rect" href="version-5-getting-started.html">#Unix Source Installation</a></li><li><a shape="rect" href="version-5-getting-started.html">#Unix Developers' Release</a></li></ul></li><li><a shape="rect" href="version-5-getting-started.html">#Starting ActiveMQ</a></li><li><a shape="rect" href="version-5-getting-started.html">#Testing the Installation</a></li><li><a shape="rect" href="version-5-getting-started.html">#Monitoring ActiveMQ</a></li><li><a shape="rect" href="version-5-getting-started.html">#Stopping ActiveMQ</a></li><li><a shape="rect" href="version-5-getting-started.html">#Starting ActiveMQ with a different configuration file</a></li><li><a shape="rect" href="version-5-getting-started.html">#Configuring ActiveMQ</a></li></ul><h2 id="Version5Ge
ttingStarted-Pre-InstallationRequirements">Pre-Installation Requirements</h2><p><strong>Hardware:</strong></p><ul><li>60 MB of free disk space for the ActiveMQ binary distribution.</li><li>200 MB of free disk space for the ActiveMQ source or developer's distributions.</li></ul><p><strong>Operating Systems:</strong></p><ul><li>Windows: Windows XP SP2, Windows 2000.</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>Java Developer Kit (JDK) 1.7.x or greater for deployment and 1.7.x (Java 7) for compiling/building.</li><li>The JAVA_HOME environment variable must be set to the directory where the JDK is installed, e.g., <code>c:\Program Files\jdk.1.7.0_xx_xx</code>.</li><li>Maven 3.0 or greater (required when installing source or developer's releases).</li><li><a shape="rect" class="external-link" href="http://cvs.apache.org/repository/geronimo-spec/jars/">JARs</a> that wil
l be used must be added to the classpath.</li></ul><h2 id="Version5GettingStarted-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="Version5GettingStarted-WindowsBinaryInstallation">Windows Binary Installation</h4><p>This procedure explains how to download and install the binary distribution on a Windows system.</p><ol><li>From a browser, navigate to <a shape="rect" class="external-link" href="http://activemq.apache.org/">activemq.apache.org/</a>.</li><li>Click the <a shape="rect" href="download.html">Download</a> link in the navigation pane (the left pane).</li><li>Select the latest distribution (for older releases, click the link to the archives).<br clear="none"> For a binary distribution, the filename will be similar to: <code>activemq-x.x.x.zip</code>.</li><li>Extract the files from the ZIP file into a directory o
f your choice.</li><li>Proceed to the <a shape="rect" href="version-5-getting-started.html">#Starting ActiveMQ</a> section of this document.</li><li>Following start-up, go to the <a shape="rect" href="version-5-getting-started.html">#Testing the Installation</a> section of this document.</li></ol><h4 id="Version5GettingStarted-WindowsSourceInstallation">Windows Source Installation</h4><p>This procedure explains how to download and install the source distribution on a Windows system.</p><p><strong>NOTE:</strong> ActiveMQ requires Java 7 to run and to build</p><ol><li>From a browser, navigate to <a shape="rect" class="external-link" href="http://activemq.apache.org/">activemq.apache.org/</a>.</li><li>Click the <a shape="rect" href="download.html">Download</a> link in the navigation pane (the left pane).</li><li>Select the latest distribution (for older releases, click the link to the archives).<br clear="none"> For a source distribution, the filename will be similar to: <code>activemq
-x.x-src.zip</code>.</li><li>Extract ActiveMQ from the ZIP file into a directory of your choice.</li><li><span class="confluence-anchor-link" id="Version5GettingStarted-WindowsSourceInstallation"></span> Build ActiveMQ using Maven 2.1 or greater and Java 1.7.</li></ol><p>The recommended method of building ActiveMQ is the following:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+<div class="wiki-content maincontent"><h2 id="Version5GettingStarted-Introduction">Introduction</h2><p>This document describes how to install and configure ActiveMQ for both Unix and Windows' platforms.</p><h2 id="Version5GettingStarted-DocumentOrganization">Document Organization</h2><p>The Getting Started Guide for ActiveMQ contains the following sections:</p><p><style type="text/css">/*<![CDATA[*/
+div.rbtoc1459822807839 {padding: 0px;}
+div.rbtoc1459822807839 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1459822807839 li {margin-left: 0px;padding-left: 0px;}
+
+/*]]>*/</style></p><div class="toc-macro rbtoc1459822807839">
+<ul class="toc-indentation"><li><a shape="rect" href="#Version5GettingStarted-Introduction">Introduction</a></li><li><a shape="rect" href="#Version5GettingStarted-DocumentOrganization">Document Organization</a></li><li><a shape="rect" href="#Version5GettingStarted-Pre-InstallationRequirements">Pre-Installation Requirements</a></li><li><a shape="rect" href="#Version5GettingStarted-InstallationProcedureforWindows">Installation Procedure for Windows</a>
+<ul class="toc-indentation"><li><a shape="rect" href="#Version5GettingStarted-WindowsBinaryInstallation">Windows Binary Installation</a></li><li><a shape="rect" href="#Version5GettingStarted-WindowsSourceInstallation">Windows Source Installation</a></li><li><a shape="rect" href="#Version5GettingStarted-WindowsDeveloper'sRelease">Windows Developer's Release</a></li></ul>
+</li><li><a shape="rect" href="#Version5GettingStarted-InstallationProcedureforUnix">Installation Procedure for Unix</a>
+<ul class="toc-indentation"><li><a shape="rect" href="#Version5GettingStarted-UnixBinaryInstallationUnixBinaryInstallation">Unix Binary Installation</a></li><li><a shape="rect" href="#Version5GettingStarted-UnixSourceInstallation">Unix Source Installation</a></li><li><a shape="rect" href="#Version5GettingStarted-UnixDeveloper'sRelease">Unix Developer's Release</a></li></ul>
+</li><li><a shape="rect" href="#Version5GettingStarted-StartingActiveMQStartingActiveMQ">Starting ActiveMQ</a>
+<ul class="toc-indentation"><li><a shape="rect" href="#Version5GettingStarted-OnWindows">On Windows</a></li><li><a shape="rect" href="#Version5GettingStarted-OnUnix">On Unix</a></li><li><a shape="rect" href="#Version5GettingStarted-Morehelp">More help</a></li></ul>
+</li><li><a shape="rect" href="#Version5GettingStarted-TestingtheInstallationTestingtheInstallation">Testing the Installation</a></li><li><a shape="rect" href="#Version5GettingStarted-MonitoringActiveMQ">Monitoring ActiveMQ</a></li><li><a shape="rect" href="#Version5GettingStarted-StoppingActiveMQ">Stopping ActiveMQ</a></li><li><a shape="rect" href="#Version5GettingStarted-StartingActiveMQwithadifferentconfigurationfileStartingActiveMQwithadifferentconfigurationfile">Starting ActiveMQ with a different configuration file</a>
+<ul class="toc-indentation"><li><a shape="rect" href="#Version5GettingStarted-ActiveMQ5.8orolder">ActiveMQ 5.8 or older</a></li><li><a shape="rect" href="#Version5GettingStarted-ActiveMQ5.9onwards">ActiveMQ 5.9 onwards</a></li></ul>
+</li><li><a shape="rect" href="#Version5GettingStarted-ConfiguringActiveMQ">Configuring ActiveMQ</a></li><li><a shape="rect" href="#Version5GettingStarted-AdditionalResources">Additional Resources</a></li></ul>
+</div><h2 id="Version5GettingStarted-Pre-InstallationRequirements">Pre-Installation Requirements</h2><p><strong>Hardware:</strong></p><ul><li>60 MB of free disk space for the ActiveMQ binary distribution.</li><li>200 MB of free disk space for the ActiveMQ source or developer's distributions.</li></ul><p><strong>Operating Systems:</strong></p><ul><li>Windows: Windows XP SP2, Windows 2000.</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>Java Developer Kit (JDK) 1.7.x or greater for deployment and 1.7.x (Java 7) for compiling/building.</li><li>The JAVA_HOME environment variable must be set to the directory where the JDK is installed, e.g., <code>c:\Program Files\jdk.1.7.0_xx_xx</code>.</li><li>Maven 3.0 or greater (required when installing source or developer's releases).</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.</li></ul><h2 id="Version5GettingStarted-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="Version5GettingStarted-WindowsBinaryInstallation">Windows Binary Installation</h4><p>This procedure explains how to download and install the binary distribution on a Windows system.</p><ol><li>From a browser, navigate to <a shape="rect" class="external-link" href="http://activemq.apache.org/">activemq.apache.org/</a>.</li><li>Click the <a shape="rect" href="download.html">Download</a> link in the navigation pane (the left pane).</li><li>Select the latest distribution (for older releases, click the link to the archives).<br clear="none"> For a binary distribution, the filename will be similar to: <code>activemq-x.x.x.zip</code>.</li><li>Extract the files from the ZIP
file into a directory of your choice.</li><li>Proceed to the <a shape="rect" href="version-5-getting-started.html">#Starting ActiveMQ</a> section of this document.</li><li>Following start-up, go to the <a shape="rect" href="version-5-getting-started.html">#Testing the Installation</a> section of this document.</li></ol><h4 id="Version5GettingStarted-WindowsSourceInstallation">Windows Source Installation</h4><p>This procedure explains how to download and install the source distribution on a Windows system.</p><p><strong>NOTE:</strong> ActiveMQ requires Java 7 to run and to build</p><ol><li>From a browser, navigate to <a shape="rect" class="external-link" href="http://activemq.apache.org/">activemq.apache.org/</a>.</li><li>Click the <a shape="rect" href="download.html">Download</a> link in the navigation pane (the left pane).</li><li>Select the latest distribution (for older releases, click the link to the archives).<br clear="none"> For a source distribution, the filename will be si
milar to: <code>activemq-x.x-src.zip</code>.</li><li>Extract ActiveMQ from the ZIP file into a directory of your choice.</li><li><span class="confluence-anchor-link" id="Version5GettingStarted-WindowsSourceInstallation"></span> Build ActiveMQ using Maven 2.1 or greater and Java 1.7.</li></ol><p>The recommended method of building ActiveMQ is the following:</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;">cd [activemq_install_dir]
mvn clean install
</pre>
@@ -141,7 +156,7 @@ mvn clean install -Dmaven.test.skip=true
<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">cd [activemq_install_dir]/bin
chmod 755 activemq
</pre>
-</div></div></li><li>For a binary snapshot, proceed to the <a shape="rect" href="version-5-getting-started.html">#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="version-5-getting-started.html">#Unix Source Installation</a> procedure.</li><li>Proceed to the <a shape="rect" href="version-5-getting-started.html">#Testing the Installation</a> section.</li></ol><h2 id="Version5GettingStarted-StartingActiveMQStartingActiveMQ"><span class="confluence-anchor-link" id="Version5GettingStarted-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><div class="confluence-information-macro confluence-information-macro-tip"><span class="aui-icon aui-icon-small aui-iconfont-approve confluence-information-macro-icon"></span><div class="confluence-information-macro-body"><p>See also <a shape="
rect" class="unresolved" href="#">Starting ActiveMQ with a different configuration file</a></p></div></div><h4 id="Version5GettingStarted-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 pdl">
+</div></div></li><li>For a binary snapshot, proceed to the <a shape="rect" href="version-5-getting-started.html">#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="version-5-getting-started.html">#Unix Source Installation</a> procedure.</li><li>Proceed to the <a shape="rect" href="version-5-getting-started.html">#Testing the Installation</a> section.</li></ol><h2 id="Version5GettingStarted-StartingActiveMQStartingActiveMQ"><span class="confluence-anchor-link" id="Version5GettingStarted-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><div class="confluence-information-macro confluence-information-macro-tip"><span class="aui-icon aui-icon-small aui-iconfont-approve confluence-information-macro-icon"></span><div class="confluence-information-macro-body"><p>See also <a shape="
rect" class="unresolved" href="#">Starting ActiveMQ with a different configuration file</a></p></div></div><h3 id="Version5GettingStarted-OnWindows">On Windows</h3><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 pdl">
<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">cd [activemq_install_dir]
</pre>
</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>.</p><p>Then type (depending on ActiveMQ version):</p><p><strong>ActiveMQ 5.10 onwards</strong></p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
@@ -150,7 +165,7 @@ chmod 755 activemq
</div></div><p><strong>ActiveMQ 5.9 or older</strong></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;">bin\activemq
</pre>
-</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="Version5GettingStarted-OnUnix:">On Unix:</h4><p>From a command shell, change to the installation directory and run <code>ActiveMQ</code>:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</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><h3 id="Version5GettingStarted-OnUnix">On Unix</h3><p>From a command shell, change to the installation directory and run <code>ActiveMQ</code>:</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;">cd [activemq_install_dir]
</pre>
</div></div><p>where <code>activemq_install_dir</code> is the directory in which ActiveMQ was installed, e.g., <code>/usr/local/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">
@@ -190,7 +205,7 @@ kill [PID]
</div></div><p>To start Active in console mode and load the <code>conf/activemq-demo.xml</code> file. Yes you need the <code>xbean:</code> as prefix.</p><p>And to launch as a background process you can do:</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;">bin/activemq start xbean:conf/activemq-demo.xml
</pre>
-</div></div><h4 id="Version5GettingStarted-ActiveMQ5.9onwards.">ActiveMQ 5.9 onwards.</h4><p>For example to use <code>examples/conf/activemq-demo.xml</code> which includes the web demos, you do as follows:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><h4 id="Version5GettingStarted-ActiveMQ5.9onwards">ActiveMQ 5.9 onwards</h4><p>For example to use <code>examples/conf/activemq-demo.xml</code> which includes the web demos, you do as follows:</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;">bin/activemq console xbean:examples/conf/activemq-demo.xml
</pre>
</div></div><p>To start Active in console mode and load the <code>examples/conf/activemq-demo.xml</code> file. Yes you need the <code>xbean:</code> as prefix.</p><p>And to launch as a background process you can do:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
Modified: websites/production/activemq/content/version-5-initial-configuration.html
==============================================================================
--- websites/production/activemq/content/version-5-initial-configuration.html (original)
+++ websites/production/activemq/content/version-5-initial-configuration.html Tue Apr 5 02:21:47 2016
@@ -72,7 +72,16 @@
<tbody>
<tr>
<td valign="top" width="100%">
-<div class="wiki-content maincontent"><h1 id="Version5InitialConfiguration-InitialConfiguration">Initial Configuration</h1><h2 id="Version5InitialConfiguration-DocumentOrganization">Document Organization</h2><ul><li><a shape="rect" href="version-5-initial-configuration.html">#Required JARs</a></li><li><a shape="rect" href="version-5-initial-configuration.html">#Optional JARS</a></li><li><a shape="rect" href="version-5-initial-configuration.html">#Persistence Support</a></li><li><a shape="rect" href="version-5-initial-configuration.html">#Next steps</a></li><li><a shape="rect" href="version-5-initial-configuration.html">#Additional Resources</a><ul><li><a shape="rect" href="version-5-initial-configuration.html">#Related Reading</a></li><li><a shape="rect" href="version-5-initial-configuration.html">#Specifications</a></li><li><a shape="rect" href="version-5-initial-configuration.html">#Related open source projects</a></li></ul></li></ul><p>Firstly you need to add the jars to your cla
sspath.</p><h2 id="Version5InitialConfiguration-RequiredJARs">Required JARs</h2><p>To make ActiveMQ easy to use, the default <strong>activemq-all.jar</strong> comes complete with all the libraries required. If you prefer to have explicit control over all the jars used by ActiveMQ here is the full list of individual jars required</p><ul><li>activemq-broker.jar</li><li>activemq-client.jar</li><li>activemq-kahadb-store.jar</li><li>activemq-spring.jar</li><li>hawtbuf-1.11.jar</li><li>slf4j-api.jar</li><li>slf4j-log4j12.jar</li><li>log4j-1.2.17.jar</li><li>J2EE APIs which could be the j2ee.jar from Sun or your J2EE container or you could use Geronimo's freely distributable geronimo-spec-j2ee.jar. If you are inside a servlet container and being dependent on the j2ee.jar causes you troubles, the parts of the J2EE jar we are dependent on are as follows...<ul><li>geronimo-spec-jms.jar</li><li>geronimo-spec-jta.jar</li><li>geronimo-spec-j2ee-management.jar</li></ul></li></ul><p>If you want to
grab a J2EE specification jar we recommend the Apache <a shape="rect" class="external-link" href="http://cvs.apache.org/repository/geronimo-spec/jars/">repository</a></p><h2 id="Version5InitialConfiguration-OptionalJARS">Optional JARS</h2><ul><li>spring.jar - if you wish to use the XML configuration file for configuring the Message Broker</li></ul><ul><li>if you wish to use message persistence then you need to add a persistent jar to your classpath (see below). If you just want a lightweight message bus with no durability you can leave this step out but we highly recommend persistence for production deployments.</li></ul><h2 id="Version5InitialConfiguration-PersistenceSupport">Persistence Support</h2><p>The default persistence is the <a shape="rect" href="amq-message-store.html">AMQ Message Store</a>. We do still support persistence via <a shape="rect" href="persistence.html">JDBC and a high performance journal</a>. For full explict control over configuration check out the <a shape
="rect" href="xml-configuration.html">Xml Configuration</a>.</p><p>If you're just doing some testing or in-VM SEDA based messaging you may wish to disable persistence. You can use the <a shape="rect" href="xml-configuration.html">Xml Configuration</a> for this.</p><p>You can do this by setting the usePersistence property to false either in the <a shape="rect" href="xml-configuration.html">Xml Configuration</a> or on the <a shape="rect" href="configuring-transports.html">broker URL</a>.</p><h2 id="Version5InitialConfiguration-Nextsteps">Next steps</h2><p>One of the first things you might want to do is <a shape="rect" href="run-broker.html">start a broker</a>. Once you have a broker running you could try using the <a shape="rect" href="jndi-support.html">JNDI Support</a> which shows how to run an example JMS program. Or there are some other <a shape="rect" href="examples.html">example programs</a></p><p>If you don't want to use JNDI you can just instantiate an <a shape="rect" class="e
xternal-link" href="http://activemq.codehaus.org/maven/apidocs/org/apache/activemq/ActiveMQConnectionFactory.html" rel="nofollow">ActiveMQConnectionFactory</a>, configure its properties directly and then you're ready to use the standard JMS API to create Connections, Sessions, MessageProducer and MessageConsumer instances.</p><h2 id="Version5InitialConfiguration-AdditionalResources">Additional Resources</h2><h3 id="Version5InitialConfiguration-RelatedReading">Related Reading</h3><ul><li>Sun's <a shape="rect" class="external-link" href="http://java.sun.com/products/jms/tutorial/" rel="nofollow">JMS Tutorial</a> is a handy place to start looking at how to use the JMS API directly</li><li>The ActiveMQ <a shape="rect" class="external-link" href="http://activemq.org" rel="nofollow">Website</a> for specifics on how to use ActiveMQ</li><li><a shape="rect" href="topologies.html">ActiveMQ Topologies</a></li><li><a shape="rect" href="clustering.html">ActiveMQ Clustering</a></li><li><a shape="
rect" href="networks-of-brokers.html">ActiveMQ Network of Brokers</a></li><li><a shape="rect" class="external-link" href="http://www.eecs.harvard.edu/~mdw/proj/seda/" rel="nofollow">Staged Event Driven Architecture (SEDA)</a></li></ul><h3 id="Version5InitialConfiguration-Specifications">Specifications</h3><ul><li><a shape="rect" class="external-link" href="http://java.sun.com/j2ee/connector/" rel="nofollow">Java Connector Architecture 1.5</a></li><li><a shape="rect" class="external-link" href="http://java.sun.com/products/jms/index.jsp" rel="nofollow">Java Messaging Service</a></li><li><a shape="rect" class="external-link" href="http://ws.apache.org/wsif/">WSIF</a></li><li><a shape="rect" class="external-link" href="http://www-128.ibm.com/developerworks/webservices/library/specification/ws-notification/" rel="nofollow">WS-Notification</a></li></ul><h3 id="Version5InitialConfiguration-Relatedopensourceprojects">Related open source projects</h3><ul><li><a shape="rect" class="external-
link" href="http://geronimo.apache.org/">Apache Geronimo</a></li><li><a shape="rect" class="external-link" href="http://www.hermesjms.com/" rel="nofollow">Hermes JMS</a></li><li><a shape="rect" class="external-link" href="http://jencks.org/" rel="nofollow">Jencks</a> is a Spring JCA container allowing you to use connection & thread & POJO pooling for consuming JMS in highly concurrent servers</li><li><a shape="rect" class="external-link" href="http://lingo.codehaus.org/" rel="nofollow">Lingo</a> is a Spring/POJO remoting layer for JMS. It allows you to reuse all the power of JMS from your POJOs without using any of the JMS APIs directly</li><li><a shape="rect" class="external-link" href="http://www.springframework.org/" rel="nofollow">Spring</a></li><li><a shape="rect" class="external-link" href="http://stomp.codehaus.org/" rel="nofollow">Stomp</a> is an open wire protocol (similar to HTTP) for communicating with MOMs from different languages. It has clients for languages li
ke C, C#, Python, Perl, Ruby etc.</li><li><a shape="rect" class="external-link" href="http://xbean.org/" rel="nofollow">XBean</a> is used as the default XML configuration mechanism for ActiveMQ</li></ul></div>
+<div class="wiki-content maincontent"><h2 id="Version5InitialConfiguration-DocumentOrganization">Document Organization</h2><p><style type="text/css">/*<![CDATA[*/
+div.rbtoc1459822811042 {padding: 0px;}
+div.rbtoc1459822811042 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1459822811042 li {margin-left: 0px;padding-left: 0px;}
+
+/*]]>*/</style></p><div class="toc-macro rbtoc1459822811042">
+<ul class="toc-indentation"><li><a shape="rect" href="#Version5InitialConfiguration-RequiredJARs">Required JARs</a></li><li><a shape="rect" href="#Version5InitialConfiguration-OptionalJARS">Optional JARS</a></li><li><a shape="rect" href="#Version5InitialConfiguration-Persistencesupport">Persistence support</a></li><li><a shape="rect" href="#Version5InitialConfiguration-Nextsteps">Next steps</a></li><li><a shape="rect" href="#Version5InitialConfiguration-Additionalresources">Additional resources</a>
+<ul class="toc-indentation"><li><a shape="rect" href="#Version5InitialConfiguration-Relatedreading">Related reading</a></li><li><a shape="rect" href="#Version5InitialConfiguration-Specifications">Specifications</a></li><li><a shape="rect" href="#Version5InitialConfiguration-Relatedopensourceprojects">Related open source projects</a></li></ul>
+</li></ul>
+</div><p>Firstly you need to add the jars to your classpath.</p><h2 id="Version5InitialConfiguration-RequiredJARs">Required JARs</h2><p>To make ActiveMQ easy to use, the default <strong>activemq-all.jar</strong> comes complete with all the libraries required. If you prefer to have explicit control over all the jars used by ActiveMQ here is the full list of individual jars required</p><ul><li>activemq-broker.jar</li><li>activemq-client.jar</li><li>activemq-kahadb-store.jar</li><li>activemq-spring.jar</li><li>hawtbuf-1.11.jar</li><li>slf4j-api.jar</li><li>slf4j-log4j12.jar</li><li>log4j-1.2.17.jar</li><li>J2EE APIs which could be the j2ee.jar from Sun or your J2EE container or you could use Geronimo's freely distributable geronimo-spec-j2ee.jar. If you are inside a servlet container and being dependent on the j2ee.jar causes you troubles, the parts of the J2EE jar we are dependent on are as follows...<ul><li>geronimo-spec-jms.jar</li><li>geronimo-spec-jta.jar</li><li>geronimo-spec-j2e
e-management.jar</li></ul></li></ul><p>If you want to grab a J2EE specification jar we recommend the Apache <a shape="rect" class="external-link" href="http://cvs.apache.org/repository/geronimo-spec/jars/">repository</a></p><h2 id="Version5InitialConfiguration-OptionalJARS">Optional JARS</h2><ul><li>spring.jar - if you wish to use the XML configuration file for configuring the Message Broker</li></ul><ul><li>if you wish to use message persistence then you need to add a persistent jar to your classpath (see below). If you just want a lightweight message bus with no durability you can leave this step out but we highly recommend persistence for production deployments.</li></ul><h2 id="Version5InitialConfiguration-Persistencesupport">Persistence support</h2><p>The default persistence is the <a shape="rect" href="amq-message-store.html">AMQ Message Store</a>. We do still support persistence via <a shape="rect" href="persistence.html">JDBC and a high performance journal</a>. For full expl
ict control over configuration check out the <a shape="rect" href="xml-configuration.html">Xml Configuration</a>.</p><p>If you're just doing some testing or in-VM SEDA based messaging you may wish to disable persistence. You can use the <a shape="rect" href="xml-configuration.html">Xml Configuration</a> for this.</p><p>You can do this by setting the usePersistence property to false either in the <a shape="rect" href="xml-configuration.html">Xml Configuration</a> or on the <a shape="rect" href="configuring-transports.html">broker URL</a>.</p><h2 id="Version5InitialConfiguration-Nextsteps">Next steps</h2><p>One of the first things you might want to do is <a shape="rect" href="run-broker.html">start a broker</a>. Once you have a broker running you could try using the <a shape="rect" href="jndi-support.html">JNDI Support</a> which shows how to run an example JMS program. Or there are some other <a shape="rect" href="examples.html">example programs</a></p><p>If you don't want to use JNDI
you can just instantiate an <a shape="rect" class="external-link" href="http://activemq.codehaus.org/maven/apidocs/org/apache/activemq/ActiveMQConnectionFactory.html" rel="nofollow">ActiveMQConnectionFactory</a>, configure its properties directly and then you're ready to use the standard JMS API to create Connections, Sessions, MessageProducer and MessageConsumer instances.</p><h2 id="Version5InitialConfiguration-Additionalresources">Additional resources</h2><h3 id="Version5InitialConfiguration-Relatedreading">Related reading</h3><ul><li>Sun's <a shape="rect" class="external-link" href="http://java.sun.com/products/jms/tutorial/" rel="nofollow">JMS Tutorial</a> is a handy place to start looking at how to use the JMS API directly</li><li>The ActiveMQ <a shape="rect" class="external-link" href="http://activemq.org" rel="nofollow">Website</a> for specifics on how to use ActiveMQ</li><li><a shape="rect" href="topologies.html">ActiveMQ Topologies</a></li><li><a shape="rect" href="cluste
ring.html">ActiveMQ Clustering</a></li><li><a shape="rect" href="networks-of-brokers.html">ActiveMQ Network of Brokers</a></li><li><a shape="rect" class="external-link" href="http://www.eecs.harvard.edu/~mdw/proj/seda/" rel="nofollow">Staged Event Driven Architecture (SEDA)</a></li></ul><h3 id="Version5InitialConfiguration-Specifications">Specifications</h3><ul><li><a shape="rect" class="external-link" href="http://java.sun.com/j2ee/connector/" rel="nofollow">Java Connector Architecture 1.5</a></li><li><a shape="rect" class="external-link" href="http://java.sun.com/products/jms/index.jsp" rel="nofollow">Java Messaging Service</a></li><li><a shape="rect" class="external-link" href="http://ws.apache.org/wsif/">WSIF</a></li><li><a shape="rect" class="external-link" href="http://www-128.ibm.com/developerworks/webservices/library/specification/ws-notification/" rel="nofollow">WS-Notification</a></li></ul><h3 id="Version5InitialConfiguration-Relatedopensourceprojects">Related open source
projects</h3><ul><li><a shape="rect" class="external-link" href="http://geronimo.apache.org/">Apache Geronimo</a></li><li><a shape="rect" class="external-link" href="http://www.hermesjms.com/" rel="nofollow">Hermes JMS</a></li><li><a shape="rect" class="external-link" href="http://jencks.org/" rel="nofollow">Jencks</a> is a Spring JCA container allowing you to use connection & thread & POJO pooling for consuming JMS in highly concurrent servers</li><li><a shape="rect" class="external-link" href="http://lingo.codehaus.org/" rel="nofollow">Lingo</a> is a Spring/POJO remoting layer for JMS. It allows you to reuse all the power of JMS from your POJOs without using any of the JMS APIs directly</li><li><a shape="rect" class="external-link" href="http://www.springframework.org/" rel="nofollow">Spring</a></li><li><a shape="rect" class="external-link" href="http://stomp.codehaus.org/" rel="nofollow">Stomp</a> is an open wire protocol (similar to HTTP) for communicating with MOMs from
different languages. It has clients for languages like C, C#, Python, Perl, Ruby etc.</li><li><a shape="rect" class="external-link" href="http://xbean.org/" rel="nofollow">XBean</a> is used as the default XML configuration mechanism for ActiveMQ</li></ul></div>
</td>
<td valign="top">
<div class="navigation">