You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by bu...@apache.org on 2014/03/22 11:46:38 UTC

[Bug 56300] New: [Tribes] No useful examples, lack of documentation

https://issues.apache.org/bugzilla/show_bug.cgi?id=56300

            Bug ID: 56300
           Summary: [Tribes] No useful examples, lack of documentation
           Product: Tomcat 7
           Version: unspecified
          Hardware: PC
                OS: Linux
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Documentation
          Assignee: dev@tomcat.apache.org
          Reporter: his.madness82@gmail.com

Created attachment 31422
  --> https://issues.apache.org/bugzilla/attachment.cgi?id=31422&action=edit
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

-- 
You are receiving this mail because:
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org

[Bug 56300] [Tribes] No useful examples, lack of documentation

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=56300

--- Comment #2 from Matthias Müller <hi...@gmail.com> ---
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

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org

[Bug 56300] [Tribes] No useful examples, lack of documentation

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=56300

Mark Thomas <ma...@apache.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Severity|normal                      |enhancement

--- Comment #1 from Mark Thomas <ma...@apache.org> ---
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.

-- 
You are receiving this mail because:
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org

[Bug 56300] [Tribes] No useful examples, lack of documentation

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=56300

Matthias Müller <hi...@gmail.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |his.madness82@gmail.com

-- 
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org

[Bug 56300] [Tribes] No useful examples, lack of documentation

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=56300

--- Comment #3 from Konstantin Kolinko <kn...@gmail.com> ---
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

-- 
You are receiving this mail because:
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org