activemq-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r984760 - in /websites/production/activemq/content: cache/main.pageCache version-5-getting-started.html version-5-initial-configuration.html
Date Tue, 05 Apr 2016 02:21:47 GMT
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
&amp; thread &amp; 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 &amp; thread &amp; 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">



Mime
View raw message