Uploading patch. includes Kafka channel kerberos documentation and also a minor fix to existing doc (removed capacity & transactionCapacity settings from example as they dont apply to this channel)

revising patch with minor addition to documentation

Hari Shreedharan can u take a look ?

I am not too familiar with the new kafka API. Jeff Holoman - could you take a look?

Looks ok but the following lines need to be addressed:

a1.channels.c1.kafka.producer.security.protocol = SASL_PLAINTEXT
+ a1.channels.c1.kafka.consumer.security.protocol = SASL_PLAINTEXT

s/c1/channel1 per the previous lines.

Also if we are going to take the time to document this does it make sense to include an example configuration with SASL_SSL as well? I see that it was called out in the change(i.e, look at the kafka docs) and that's probably fine. I could go either way really.

Jeff Holoman thanks for spotting that problem .. shall upload a fixed patch soon.

I considered providing examples for other modes too but was not able to test them out. After briefly looking over the other modes, leaned away from providing examples for each of them and instead just refer to them via a link... as it seemed a bit much (e.g. with and without authorization) although useful.

I decided to put this example since the kafka folks tell me that SASL_PLAINTEXT is most common one.

uploading revised patch v3 with fix for issue pointed out by Jeff Holoman

LGTM +1

+1. I am going to commit this.

Commit c1fae53bf2c254f5cf1282f32116a7aedc5340ed in flume's branch refs/heads/trunk from Roshan Naik
[ https://git-wip-us.apache.org/repos/asf?p=flume.git;h=c1fae53 ]

FLUME-2901. Document Kerberos setup for Kafka channel

Add details about configuring Kafka channel to work with a Kerberized
Kafka cluster.

(Roshan Naik via Mike Percy)

Pushed to trunk. Thanks for the patch Roshan!

Also thank you Jeff for reviewing.

UNSTABLE: Integrated in Flume-trunk-hbase-1 #193 (See https://builds.apache.org/job/Flume-trunk-hbase-1/193/)
FLUME-2901. Document Kerberos setup for Kafka channel (mpercy: http://git-wip-us.apache.org/repos/asf/flume/repo?p=flume.git&a=commit&h=c1fae53bf2c254f5cf1282f32116a7aedc5340ed)

• flume-ng-doc/sphinx/FlumeUserGuide.rst