Improve documentation for Servicemix Clustering
-----------------------------------------------

                 Key: SM-1881
                 URL: https://issues.apache.org/activemq/browse/SM-1881
             Project: ServiceMix
          Issue Type: Improvement
          Components: documentation
    Affects Versions: 3.3.1
         Environment: Servicemix Fuse 3.4
            Reporter: Ryan Moquin
            Priority: Minor


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" ...



-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply via email to