[SM-1881] Improve documentation for Servicemix Clustering

• Type: Improvement
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 3.3.1
• Component/s: documentation

Environment

Servicemix Fuse 3.4

• Assignee: Unassigned
• Reporter: Ryan Moquin
• Created: 28/Jul/09 16:19
• Updated: 24/Aug/09 14:21
• Resolved: 24/Aug/09 14:21

Description

I think the instructions on the following page need some clarifications:

http://servicemix.apache.org/clustering.html

The first change is that the transport connector will not work as it is setup by default.

<amq:transportConnectors>
<amq:transportConnector uri="tcp://localhost:61616" discoveryUri="multicast://default"/>
</amq:transportConnectors>

tcp://localhost:61616 will not work for a connection from a networkConnector, it needs to be:

<amq:transportConnectors>
<amq:transportConnector uri="tcp://0.0.0.0:61616" discoveryUri="multicast://default"/>
</amq:transportConnectors>

According to the ActiveMQ docs, if you don't use 0.0.0.0 it will only accept connections from localhost.

Also, for static configuration, the discoveryUri="multicast://default" should be removed from the transport connector.

One correction I noticed as well, which is that on the following line on that page:

<amq:broker brokerName="host1_broker1" depends-on="jmxServer">

It doesn't show the id="broker" which implies that it gets removed in favor of brokerName, when in fact both should be there otherwise servicemix won't start.

One last critical thing that the clustering page is missing, is that clustering WILL NOT work unless you add a name attribute to your jbi container in the servicemix.xml for example:

<sm:container id="jbi" name="host1broker" ...