Author: buildbot
Date: Mon Apr 13 15:21:05 2015
New Revision: 947419
Log:
Production update by buildbot for activemq
Modified:
websites/production/activemq/content/cache/main.pageCache
websites/production/activemq/content/getting-started.html
Modified: websites/production/activemq/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/activemq/content/getting-started.html
==============================================================================
--- websites/production/activemq/content/getting-started.html (original)
+++ websites/production/activemq/content/getting-started.html Mon Apr 13
15:21:05 2015
@@ -81,44 +81,37 @@
<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>33 MB of free disk
space for the ActiveMQ 4.x binary distribution.</li><li>200 MB of free disk
space for the ActiveMQ 4.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>Java Developer Kit
(JDK)  J<strong>DK 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</li><li>Maven</li><li><a shape="rect" class="external-link"
href="http://cvs.apache.org/repository/geronimo-spec/j
ars/">JARs</a> that will be used must be added to the classpath.</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 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="#GettingStarted-Download">#Download</a> link in the
navigation pane (the left pane).</li><li>Click the <a shape="rect"
href="#GettingStarted-ActiveMQ4.xRelease">#ActiveMQ 4.x Release</a> link under
the "Latest Releases" section. This brings up a new page.</li><li>Under the <a
shape="rect" href="#GettingStarted-DownloadHere">#Down
load Here</a> section, select the desired distribution (you may have to scroll
down to see the "Download Here" section).<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="#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><p><strong>NOTE:</strong> ActiveMQ
can be run on a Java 1.4.x system, however, Java 1.5 is required to
compile/build ActiveMQ.</p><ol><li>From a browser, navigate to <a shape="rect"
class="external-link" href="h
ttp://activemq.apache.org/">activemq.apache.org/</a>.</li><li>Click the <a
shape="rect" href="#GettingStarted-Download">#Download</a> link in the
navigation pane (the left pane).</li><li>Click the <a shape="rect"
href="#GettingStarted-ActiveMQ4.xRelease">#ActiveMQ 4.x Release</a> link under
the "Latest Releases" section. This brings up another page.</li><li>Under the
<a shape="rect" href="#GettingStarted-DownloadHere">#Download Here</a> section,
select the desired distribution (if necessary, scroll down to see the "Download
Here" section).<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="GettingStarted-WindowsSourceInstallation"></span> Build ActiveMQ using
Maven 2.0.4 or greater and Java 1.5.</li></ol><p>The recommended method of
building ActiveMQ is the following:</p><div class="code panel pdl" s
tyle="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[cd [activemq_install_dir]
-mvn clean install
-]]></script>
-</div></div><p>where [activemq_install_dir] is the directory in which ActiveMQ
was installed.</p><p>If the above build fails on some tests, type 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]
-mvn clean install -Dmaven.test.skip=true
+<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)
+mvn clean install
]]></script>
-</div></div><ol><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">
+</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>
</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>
-</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><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">
+</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
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>Proceed to the <a shape="rect"
href="#GettingStarted-TestingtheInstallation">#Testing the Installation</a>
section.</li></ol> <div class="aui-message problem shadowed
information-macro">
+</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>
-<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><p><strong>NOTE:</strong> ActiveMQ can be run on a
Java 1.4.x system, however, Java 1.5 is required to compile/build
ActiveMQ.</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="#GettingStarted-Download">#Download</a> link in the
navigation pane (the left pane).</li><li>Click the <a shape="rect"
href="#GettingStarted-CurrentdevelopmentSNAPSHOTrelease">#Current development
SNAPSHOT release</a> link.</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-StartingAc
tiveMQ">#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, 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 gzip file to the Unix
machine, using either a browser or a tool, i.e.,
wget, scp, ftp, etc. 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[> wget
http://activemq.apache.org/path/tofile/apache-activemq-4.1.0-incubator.tar.gz
+</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
]]></script>
-</div></div></li><li><p>Extract the files from the gzip 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.x.tar.gz
-]]></script>
-</div></div></li><li><p>If the <code>ActiveMQ</code> start-up script is not
executable, change its permissions. The <code>ActiveMQ</code> script is located
in the <code>bin</code> 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]/bin
-> chmod 755 activemq
+</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]
+tar zxvf activemq-x.x.x-bin.tar.gz
]]></script>
-</div></div></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.</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>After installing Homebrew package manager successfully,
just run</li></ol><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
+</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>
</div></div><p>You can expect the following output:</p><div class="code panel
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
@@ -130,19 +123,14 @@ Software was installed to:
==> Summary
/usr/local/Cellar/apache-activemq/x.x.x: 406 files, 35M, built in 2 seconds
]]></script>
-</div></div><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><p><strong>NOTE:</strong> ActiveMQ can be run on a Java 1.4.x
system, however, Java 1.5 is required to compile/build
ActiveMQ.</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="#GettingStarted-Download">#Download</a> link in the
navigation pane (the left pane).</li><li>Click the <a shape="rect"
href="#GettingStarted-ActiveMQ4.xRelease">#ActiveMQ 4.x Release</a> link under
the "Latest Releases" section. This brings up a new page.</li><li>Under the <a
shape="rect" href="#GettingStarted-DownloadHere">#Download Here</a> section,
select the desired distribution (if necessary, scroll down to see the "Download
Here" section).<br clear="none"> For a source distribution, the filename will
be similar to: <code>activemq-x.x-src.tar.gz</code>.</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">
+</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>
-</div></div></li><li><p>Build ActiveMQ using Maven 2.0.4 or greater and Java
5:<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">
+</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]
-mvn clean install
-]]></script>
+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>
-</div></div><p>If the above build fails on some tests, do 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]
-mvn clean install -Dmaven.test.skip=true
+<script class="theme: Default; brush: java; gutter: false"
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
@@ -150,7 +138,7 @@ mvn clean install -Dmaven.test.skip=true
</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>
-</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><p><strong>NOTE:</strong> ActiveMQ can be
run on a Java 1.4.x system, however, Java 5 is required to compile/build
ActiveMQ.</p><o
l><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="#GettingStarted-Download">#Download</a> link in the
navigation pane (the left pane).</li><li>Click the <a shape="rect"
href="#GettingStarted-CurrentdevelopmentSNAPSHOTrelease">#Current development
SNAPSHOT release</a> link.</li><li>Select the version of ActiveMQ to download
(you may have to scroll down to see the ActiveMQ snapshots). The filename will
be similar to: <code>activemq-x.x.x-tar.gz</code> or
<code>activemq-x.x.x-src.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">
+</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>
</div></div><p>For a source developer's snapshot:</p><div class="code panel
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
@@ -163,38 +151,23 @@ chmod 755 activemq
</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>
-</div></div><p>where <code>activemq_install_dir</code> is the directory in
which ActiveMQ was installed, e.g., <code>c:\Program Files\ActiveMQ-4.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">
+</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>
-</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>:</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>
-</div></div><p>where <code>activemq_install_dir</code> is the directory in
which ActiveMQ was installed, e.g., <code>/usr/local/activemq-4.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
-
-OR
-
-bin/activemq > /tmp/smlog 2>&1 &;
-Note: /tmp/smlog may be changed to another file name.
-]]></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> <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>Do NOT close the console or shell in which
ActiveMQ was started, as that will terminate ActiveMQ (unless ActiveMQ was
started with nohup).</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[nohup bin/activemq > /tmp/smlog
2>&1 &
-]]></script>
-</div></div>
- </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><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:</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[INFO ActiveMQ JMS Message Broker
(ID:apple-s-Computer.local-51222-1140729837569-0:0) has started
+</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
+./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
+./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>
-</div></div><p><br clear="none" class="atl-forced-newline"> 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">
+</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>
</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 -an|grep 61616
+<script class="theme: Default; brush: java; gutter: false"
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>
@@ -203,9 +176,8 @@ Note: /tmp/smlog may be changed to anoth
</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[ps -ef|grep activemq
-kill [PID]
- where [PID] is the process id of the ActiveMQ process.
+<script class="theme: Default; brush: java; gutter: false"
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>
</td>
