Modified:
websites/production/activemq/content/shared-file-system-master-slave.html
==============================================================================
--- websites/production/activemq/content/shared-file-system-master-slave.html
(original)
+++ websites/production/activemq/content/shared-file-system-master-slave.html
Wed Feb 4 13:26:12 2015
@@ -74,7 +74,7 @@
<a href="features.html">Features</a> > <a
href="clustering.html">Clustering</a> > <a
href="masterslave.html">MasterSlave</a> > <a
href="shared-file-system-master-slave.html">Shared File System Master Slave</a>
</div>
<div id="site-quicklinks">
-<p><a shape="rect" href="download.html">Download</a> | <a shape="rect"
class="external-link"
href="http://activemq.apache.org/maven/5.10.0/apidocs/index.html";>JavaDocs</a>
<a shape="rect" href="javadocs.html">More...</a> | <a shape="rect"
href="source.html">Source</a> | <a shape="rect"
href="discussion-forums.html">Forums</a> | <a shape="rect"
href="support.html">Support</a></p>
+<p><a shape="rect" href="download.html">Download</a> | <a shape="rect"
class="external-link"
href="http://activemq.apache.org/maven/5.11.0/apidocs/index.html";>JavaDocs</a>
<a shape="rect" href="javadocs.html">More...</a> | <a shape="rect"
href="source.html">Source</a> | <a shape="rect"
href="discussion-forums.html">Forums</a> | <a shape="rect"
href="support.html">Support</a></p>
</div>
</div>
@@ -118,10 +118,10 @@
<amqPersistenceAdapter
directory="/sharedFileSystem/sharedBrokerData"/>
</persistenceAdapter>
]]></script>
-</div></div><h3 id="SharedFileSystemMasterSlave-Startup">Startup</h3><p>On
startup one master grabs an exclusive lock on the broker file directory - all
other brokers are slaves and pause waiting for the exclusive lock.</p><p><img
class="confluence-embedded-image"
src="https://cwiki.apache.org/confluence/download/attachments/35958/Startup.png?version=1&modificationDate=1153806958000&api=v2";
data-image-src="/confluence/download/attachments/35958/Startup.png?version=1&modificationDate=1153806958000&api=v2"></p><p>Clients
should be using the <a shape="rect"
href="failover-transport-reference.html">Failover Transport</a> to connect to
the available brokers. e.g. using a URL something like the following</p><div
class="code panel pdl" style="border-width: 1px;"><div class="codeContent
panelContent pdl">
+</div></div><h3 id="SharedFileSystemMasterSlave-Startup">Startup</h3><p>On
startup one master grabs an exclusive lock on the broker file directory - all
other brokers are slaves and pause waiting for the exclusive lock.</p><p><img
class="confluence-embedded-image"
src="shared-file-system-master-slave.data/Startup.png"
data-image-src="/confluence/download/attachments/35958/Startup.png?version=1&modificationDate=1153806958000&api=v2"></p><p>Clients
should be using the <a shape="rect"
href="failover-transport-reference.html">Failover Transport</a> to connect to
the available brokers. e.g. using a URL something like 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[failover:(tcp://broker1:61616,tcp://broker2:61616,tcp://broker3:61616)
]]></script>
-</div></div><p>Only the master broker starts up its transport connectors and
so the clients can only connect to the master.</p><h3
id="SharedFileSystemMasterSlave-Masterfailure">Master failure</h3><p>If the
master looses the exclusive lock then it immediately shuts down. If a master
shuts down or fails, one of the other slaves will grab the lock and so the
topology switches to the following diagram</p><p><img
class="confluence-embedded-image"
src="https://cwiki.apache.org/confluence/download/attachments/35958/MasterFailed.png?version=1&modificationDate=1153806959000&api=v2";
data-image-src="/confluence/download/attachments/35958/MasterFailed.png?version=1&modificationDate=1153806959000&api=v2"></p><p>One
of the other other slaves immediately grabs the exclusive lock on the file
system to them commences becoming the master, starting all of its transport
connectors.</p><p>Clients loose connection to the stopped master and then the
failover transport tries to connect to
the available brokers - of which the only one available is the new
master.</p><h3 id="SharedFileSystemMasterSlave-Masterrestart">Master
restart</h3><p>At any time you can restart other brokers which join the cluster
and start as slaves waiting to become a master if the master is shutdown or a
failure occurs. So the following topology is created after a restart of an old
master...</p><p><img class="confluence-embedded-image"
src="https://cwiki.apache.org/confluence/download/attachments/35958/MasterRestarted.png?version=1&modificationDate=1153806958000&api=v2";
data-image-src="/confluence/download/attachments/35958/MasterRestarted.png?version=1&modificationDate=1153806958000&api=v2"></p><h3
id="SharedFileSystemMasterSlave-SchedulerSupport">Scheduler
Support</h3><p>ActiveMQ maintains information about schedules independent to
the settings in the persistence adapter. With a shared file-system it is
therefore important to tell ActiveMQ expressly where to store scheduler in
formation. To do this, set the <code>dataDirectory</code> attribute on
the <code>broker</code>, for example:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeContent panelContent pdl">
+</div></div><p>Only the master broker starts up its transport connectors and
so the clients can only connect to the master.</p><h3
id="SharedFileSystemMasterSlave-Masterfailure">Master failure</h3><p>If the
master looses the exclusive lock then it immediately shuts down. If a master
shuts down or fails, one of the other slaves will grab the lock and so the
topology switches to the following diagram</p><p><img
class="confluence-embedded-image"
src="shared-file-system-master-slave.data/MasterFailed.png"
data-image-src="/confluence/download/attachments/35958/MasterFailed.png?version=1&modificationDate=1153806959000&api=v2"></p><p>One
of the other other slaves immediately grabs the exclusive lock on the file
system to them commences becoming the master, starting all of its transport
connectors.</p><p>Clients loose connection to the stopped master and then the
failover transport tries to connect to the available brokers - of which the
only one available is the new master.</p><h3
id="SharedFileSystemMasterSlave-Masterrestart">Master restart</h3><p>At any
time you can restart other brokers which join the cluster and start as slaves
waiting to become a master if the master is shutdown or a failure occurs. So
the following topology is created after a restart of an old
master...</p><p><img class="confluence-embedded-image"
src="shared-file-system-master-slave.data/MasterRestarted.png"
data-image-src="/confluence/download/attachments/35958/MasterRestarted.png?version=1&modificationDate=1153806958000&api=v2"></p><h3
id="SharedFileSystemMasterSlave-SchedulerSupport">Scheduler
Support</h3><p>ActiveMQ maintains information about schedules independent to
the settings in the persistence adapter. With a shared file-system it is
therefore important to tell ActiveMQ expressly where to store scheduler
information. To do this, set the <code>dataDirectory</code> attribute on
the <code>broker</code>, for example:</p><div class="code panel pdl"
style="border-
width: 1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><
![https://cwiki.apache.org/confluence/download/attachments/35958/Startup.png?version=1&modificationDate=1153806958000&api=v2"](https://cwiki.apache.org/confluence/download/attachments/35958/Startup.png?version=1&modificationDate=1153806958000&api=v2"){kind=link}
![https://cwiki.apache.org/confluence/download/attachments/35958/MasterFailed.png?version=1&modificationDate=1153806959000&api=v2"](https://cwiki.apache.org/confluence/download/attachments/35958/MasterFailed.png?version=1&modificationDate=1153806959000&api=v2"){kind=link}
![https://cwiki.apache.org/confluence/download/attachments/35958/MasterRestarted.png?version=1&modificationDate=1153806958000&api=v2"](https://cwiki.apache.org/confluence/download/attachments/35958/MasterRestarted.png?version=1&modificationDate=1153806958000&api=v2"){kind=link}