Another note I'd suggest for the zookeeper name-spacing doc is that the path must exist in zookeeper before starting the brokers. There is an error message, but it's not always clear what the problem is (I think there is even a Jira issue to make the error more clear).
-Chris On Sat, Aug 10, 2013 at 4:16 PM, Jay Kreps <jay.kr...@gmail.com> wrote: > Hey guys, > > I'm actively working on the docs. Any tips like this are much appreciated > especially if you can be specific (as you have) about what is clear and > what is unclear. I will attempt to clarify the zookeeper chroot info in the > changes I'm making this weekend. > > Whenever possible if we can channel people's confusion into tangible > documentation improvements I think that would be great. > > -jay > > Sent from my iPhone > > On Aug 10, 2013, at 1:42 PM, Jason Rosenberg <j...@squareup.com> wrote: > > > Philip, > > > > Agreed vis-a-vis the docs. But I also understand how you can sometimes > > find yourself with a seemingly basic question that doesn't present itself > > with an obvious reading list. You just want to get going with the > basics, > > in the interest of learning by doing, and it's usually a huge time > savings > > to get a quick answer from a willing forum participant. > > > > A forum like this one has been very helpful to me, so I don't mind giving > > back. > > > > Jason > > > > > > On Sat, Aug 10, 2013 at 3:32 PM, Philip O'Toole <phi...@loggly.com> > wrote: > > > >> Jason - thanks. I am sure that extra information will be appreciated. > >> > >> Of course, when the list gets a message like this one, it helps everyone > >> if it includes details about what has been already done. E.g. "I have > read > >> the docs but it is still not clear to me how X works when...". Perhaps > >> Vadim had actually done this. > >> > >> I particularly enjoyed reading the Kafka design docs, when I first came > >> across them. Hence I always push people to read them if they haven't > done > >> so. > >> > >> Cheers, > >> > >> Philip > >> > >> On Aug 10, 2013, at 12:08 PM, Jason Rosenberg <j...@squareup.com> wrote: > >> > >>> Yeah, the basics are there, e.g. in the doc for the zookeeper.connect > >>> property: > >>> > >>> "Specifies the zookeeper connection string in the form > >>> hostname:port/chroot. Here the chroot is a base directory which is > >>> prepended to all path operations (this effectively namespaces all kafka > >>> znodes to allow sharing with other applications on the same zookeeper > >>> cluster)." > >>> > >>> Actually though, I think the docs could be slightly more clear, as past > >>> confusion on this list will atest. > >>> > >>> The confusing part is what to do if you have multiple hosts in your zk > >>> cluster. In that case, the '/chroot' is only appended to the end of > the > >>> list of host/port pairs, e.g.: > >>> > >>> host1.xyz.com:1234,host2.xyz.com:1234,host3.xyz.com:1234/chroot > >>> > >>> This is often not obvious to readers of the docs. > >>> > >>> Jason > >>> > >>> > >>> > >>> > >>> On Fri, Aug 9, 2013 at 6:29 PM, Philip O'Toole <phi...@loggly.com> > >> wrote: > >>> > >>>> Have you read the docs? They are well written. It's all there, > including > >>>> the paths. > >>>> > >>>> Philip > >>>> > >>>> On Aug 9, 2013, at 3:24 PM, Vadim Keylis <vkeylis2...@gmail.com> > wrote: > >>>> > >>>>> I am trying to setup kafka service and connect to zookeeper that > would > >>>> be shared with Other projects. Can someone advice how to configure > >>>> namespace in kafka and zookeeper. > >>>>> > >>>>> Thanks so much > >>>>> > >>>>> Sent from my iPad > >> >
