Question

I'm trying to install Kafka message queue on Windows for testing purposes (not for production).

I found this article on how to install Apache Kafka 0.8 on Windows: http://janschulte.wordpress.com/2013/10/13/apache-kafka-0-8-on-windows/

It's a good article, but it's outdated, unfortunately.

Does someone know a way to achieve that?

Was it helpful?

Solution

Ok, it's finally not complicated :)

The only steps are:

Edit (2021/10) Latest versions of Kafka end up with an AccessDeniedException upon startup, and even when successfully started, throw the same error during log rotation. Kafka utilizes Java methods designed for Unix filesystem libraries, so installing Kafka in WSL2 is recommended (link to Confluent blog, but steps also applicable to Apache Kafka direct installation).

Old answer

  1. Download Kafka and uncompress it somewhere nice (let's say C:/Kafka)
  2. Install Cygwin

If using Cygwin, edit \bin\kafka-run-class.sh and at the end of the file, change

`exec $JAVA $KAFKA_HEAP_OPTS $KAFKA_JVM_PERFORMANCE_OPTS $KAFKA_GC_LOG_OPTS $KAFKA_JMX_OPTS $KAFKA_LOG4J_OPTS -cp $CLASSPATH $KAFKA_OPTS "$@"`

to

``exec java $KAFKA_HEAP_OPTS $KAFKA_JVM_PERFORMANCE_OPTS $KAFKA_GC_LOG_OPTS $KAFKA_JMX_OPTS $KAFKA_LOG4J_OPTS -cp `cygpath -wp $CLASSPATH` $KAFKA_OPTS "$@"``
  1. In Environment Variables, Add java to your Path System Variable:

enter image description here

That's it.. you can now run ZooKeeper and Kafka servers and start playing with topics and stuff..

OTHER TIPS

These are the steps I followed to run kafka on Windows

  1. Install Zookeeper first (I downloaded v3.3.6) zookeeper-3.3.6.tar.gz
  2. Extract Zookeeper and run this command in powershell/cmd \zookeeper-3.3.6\bin> .\zkServer.cmd Now this should up a Zookeeper instance on localhost:2181
  3. Download Kafka binary version (I downloaded v0.10.0.1)kafka_2.10-0.10.0.1.tgz
  4. Extract Kafka, time to modify some configs
  5. Inside Kafka extraction you can find .\config\server.properties
  6. In .\config\server.properties replace log.dirs=c:/kafka/kafka-logs
  7. Note: Make sure to create those folders in relevant paths
  8. Happy news: Now Kafka ships with windows .bat scripts, You can find these files inside ./bin/windows folder
  9. Start powershell/cmd and run this command to start Kafka broker .\bin\windows\kafka-server-start.bat .\config\server.properties
  10. DONE!, Now you have a running Zookeeper instance and a Kafka broker.

You will probably find that Kafka comes with Windows .bat files under the bin folder to help you run Kafka under windows. However, those bat files are not updated since version 0.8.0 and some of Kafka's logic has changed (regarding topics, etc.).

I have tried two ways to solve this problem. One is to use Cygwin or MinGW to simulate Linux environment and run the Linux shell script, but there would be tons of other problems related to path names. The other solution, which is simpler and come with less trouble, is to use the corrected version of Windows bat files.

Please refer to this blog post.

  1. Download any binary version(I've downloaded kafka_2.11-0.10.2.0) of Kafka from https://kafka.apache.org/downloads

  2. Extract it to any folder(I've extracted to "C:\Kafka")

  3. Open Command Prompt

  4. Go to the folder that you extract Kafka(C:\Kafka\kafka_2.11-0.10.2.0)

  5. Run this command to start Zookeeper

    .\bin\windows\zookeeper-server-start.bat .\config\zookeeper.properties
    
  6. Run this command to start Kafka

    .\bin\windows\kafka-server-start.bat .\config\server.properties
    

Now it works!

In version 0.9.0. there are scripts in "bin" folder for windows. You can use them.

With Chocolatey and Powershell:

  1. chocolatey.exe install kafka -> installs Kafka into C:\ProgramData\chocolatey\lib\kafka\tools\kafka_2.11-1.0.0\ - your version might differ of course
  2. add C:\ProgramData\chocolatey\lib\kafka\tools\kafka_2.11-1.0.0\ to your powershell path using notepad $PROFILE

After restarting powershell kafka-console-consumer should work as a command.

You also need to install ssl.properties with keystore and truststore. Put them e.g. into C:\ProgramData\kafka and put that into ssl.properties (please note the escaping of the backslashes):

security.protocol=SSL

ssl.truststore.location=C:\\ProgramData\\kafka\\kafka-truststore.jks
ssl.truststore.password=PASSWORD

ssl.keystore.location=C:\\ProgramData\\kafka\\kafka-keystore.jks
ssl.keystore.password=PASSWORD
ssl.key.password=PASSWORD

client.id=console-test

Now things like kafka-consumer-groups --bootstrap-server SERVERNAME:9094 --command-config C:\ProgramData\kafka\ssl.properties --list should first pop up a firewall warning which you'd need to accept and then output a list of groups.

Running From A windows Shell

As of April 2019, downloading Kafka from their website worked on Windows almost right out of the box

Downloading and using the windows version .bat files is described here: https://kafka.apache.org/quickstart

I ran into two problems when I did this:

1) JAVA_HOME was set to an unsupported JDK which led to this kind of error

Exception in thread "main" java.lang.VerifyError: Uninitialized object exists on backward branch 209

Replacing with JDK 11 solved the problem.

2) The JAVA_HOME must not contain spaces which caused a 'cannot find the specified file' error. To fix this I used a shortened path like set JAVA_HOME=C:\Progra~1\Java\jdk-11.0.1


Running From Cygwin

If instead of the .bat files, you want to run the .sh files from cygwin, there is actually quite a bit that needs to be done, and even after that there may be problems that come up later. I can't really recommend this option, but I do use it as it's pretty convenient for some purposes.

If your JAVA_HOME path contains a space e.g. "C:\Program Files\Java\Jdk..." you will see something like this:

bin/kafka-run-class.sh: line 305: exec: C:\Program: not found

One solution is to copy the jdk to a path without spaces, and change the Java home accordingly.

If you don't want to change the JDK location, you can change the cygwin env variable as follows:

JAVA_HOME="/cygdrive/c/Program Files/Java/jdk-11.0.1"

and change the line

exec $JAVA $KAFKA_HEAP_OPTS $KAFKA_JVM_PERFORMANCE_OPTS $KAFKA_GC_LOG_OPTS $KAFKA_JMX_OPTS $KAFKA_LOG4J_OPTS -cp $CLASSPATH $KAFKA_OPTS "$@"

to

exec "$JAVA" $KAFKA_HEAP_OPTS $KAFKA_JVM_PERFORMANCE_OPTS $KAFKA_GC_LOG_OPTS $KAFKA_JMX_OPTS $KAFKA_LOG4J_OPTS -cp $CLASSPATH $KAFKA_OPTS "$@"

There was another problem with the log parameters in kafka-run-class.sh and I had to replace the line

KAFKA_GC_LOG_OPTS="-Xlog:gc*:file=$LOG_DIR/$GC_LOG_FILE_NAME:time,tags:filecount=10,filesize=102400"

with

KAFKA_GC_LOG_OPTS="-Xlog:gc*"

And even after all these changes I occasionally run into problems of Kafka shutting down because of an incompatible windows style path in the logs directories as described here: Kafka 1.0 stops with FATAL SHUTDOWN error. Logs directory failed In short, you may be better off running the Kafka .bat scripts from the windows directory...

Kafka & Zookeeper have inbuilt Windows specific scripts as verified in the latest version. As mentioned in other other answers, the directory for windows scripts will be under kafka_2.12-2.4.0\bin\windows for Kafka. Zookeeper scripts are under /bin only but ending with "*.cmd"

There will be few minor additional steps you will have to do with ZooKeeper & Kafka like

  • Creating zoo.cfg for ZooKeeper
  • Configuring windows specific data directory for ZeeKeeper
  • Kafka comes with default configuration file & it has very good OS specific handling i.e. log.dirs=/tmp/kafka-logs but it will create that directory structure under C:/ directory seamlessly without failing.

It is also easy to quickly setup a Kafka Cluster with multiple Kafka Brokers on Windows with minor configurations. You can also create topics, publish/consume messages, verify topics/partitions etc. all from Windows Command Prompt. Here is a good detailed reference for the windows specific setup Kafka Setup on Windows OS | Basic Installation, Setup, Verification, Cluster Setup, Storage

I had configured Zookeeper and Apache Kafka on my Windows machine.

For Zookeeper, simply configure ZOOKEEPER_HOME and set the PATH also and then rename the zoo.sample.cfg to zoo.cfg and also change the path for dataDir in the zoo.cfg

For Apache Kafka, simply unzip and start the server from bin folder and start the Producer/Consumer from windows folder under the Kafka directory

there is some useful command to start kafka & create/read some event on windows: 1-go to folder kafka and run cmd:

C:\Tools\kafka_2.13-3.5.0>

2- run zookeeper:

.\bin\windows\zookeeper-server-start.bat .\config\zookeeper.properties

3- run kafka server:

.\bin\windows\kafka-server-start.bat .\config\server.properties

4-create topic

.\bin\windows\kafka-topics.bat --create --topic <topicName> --bootstrap-server localhost:9092

5-create producer:

.\bin\windows\kafka-console-producer.bat --topic <topicName> --bootstrap-server localhost:9092

6-create consumer:

.\bin\windows\kafka-console-consumer.bat --topic <topicName> --bootstrap-server localhost:9092

7- read message from begenning:

.\bin\windows\kafka-console-consumer.bat --topic topic-example --from-beginning --bootstrap-server localhost:9092

enter image description here

Licensed under: CC-BY-SA with attribution
Not affiliated with StackOverflow
scroll top