Created attachment 31422 [details] Channel test according to documentation The only available documentation for tribes is http://tomcat.apache.org/tomcat-7.0-doc/tribes/introduction.html (where all sub pages are empty) The provided example 1) doesn't compile 2) produces Exception in thread "main" org.apache.catalina.tribes.ChannelException: No destination given; No faulty members identified. at org.apache.catalina.tribes.group.GroupChannel.send(GroupChannel.java:202) at org.apache.catalina.tribes.group.GroupChannel.send(GroupChannel.java:182) at ChannelTest.main(ChannelTest.java:54) after making it compileable If one wants to use tribes in a cluster environment for custom message sharing, there are no usefull examples available in the documentation. It would be great to have some getting startet guides for common usage scenarios in using this (obviously very powerfull and performant, otherwise Tomcat would used it for internal clustering ;-) messaging framework. Of course you could checkout the sources from SVN and browse the tests and examples provided there, but a short and accurate documentation would definitely a better source for getting started with tribes. Regards Matthias
I've fixed the obvious bug in the example. The errors you see are because you only have a single member in the cluster so there is nowhere to send the message to. Patches to improve the documentation are always welcome. You may want to take a look in the unit tests as there are some Tribes demos / samples / tests that you might want to refer to and/or adapt for use in the docs.
Hi Mark, tnx for your reply! I was hoping that there is some (maybe internal) documentation available, which could be made public on the website. If that's not the case, I will try to dig into the sources and testcases. Where's the right place to submit documentation-patches to? Regards Matthias
The javadoc documentation also exists there, Tomcat 8 addresses: http://tomcat.apache.org/tomcat-8.0-doc/api/index.html http://tomcat.apache.org/tomcat-8.0-doc/api/org/apache/catalina/tribes/package-summary.html#package_description
With Tomcat 7 reaching EOL, move the remaining open enhancement requests to Tomcat 8.