Skeleton Storm project for The Fifth Elephant, 2013 workshop on Big Data, Real-time Processing and Storm on 11th July, 2013 at NIMHANS Convention Centre, Bangalore.
This will be a live-coding session where you will learn how to use Apache Storm. This workshop is for software developers with some background in Java programming who are interested in distributed data processing and more so real-time stream processing.
This repository contains an application for demonstrating Apache Storm distributed framework by counting the words present in random sentences fed by Storm Pipeline code [in Storm terminology: Spout] in real-time.
This project does not need internet access while executing the topology i.e. once the project is configured and Maven downloads all the required dependencies. Please check my other repo, StormTweetsWordCount for counting words in tweets in real-time which needs internet access for getting data from Twitter.
Apache Storm is an open source distributed real-time computation system, developed at BackType by Nathan Marz and team. It has been open sourced by Twitter [post BackType acquisition] in August, 2011. And Storm became a top level project in Apache on 29th September, 2014.
This application has been developed and tested initially with Storm v0.8.2 on Windows 7 in local mode; and was eventually updated and tested with Storm v0.9.3 on 28th December, 2014. Application may or may not work with earlier or later versions than Storm v0.9.3.
This application has been tested in:
- Local mode on a CentOS machine and even on Microsoft Windows 7 machine.
- Cluster mode on a private cluster and also on Amazon EC2 environment of 4 machines and 5 machines respectively; with all the machines in private cluster running Ubuntu while EC2 environment machines were powered by CentOS.
- Recent update to Apache Storm v0.9.3 has not been tested in a Cluster mode.
This application uses and complements Storm Starter Project.
- Application receives random sentences from Spout.
- It splits each sentence with space as the delimiter and counts frequency of the words present in sentences.
- Every 5 seconds, during processing, the application logs the word and its count to the console and also to a log file.
- In local mode, topology runs for 2 minutes and then shuts down. Topology time duration can be updated by modifying this value in
WordCountTopology.java. - Also, this project has been made compatible with both Eclipse IDE and IntelliJ IDEA. Import the project in your favorite IDE [which has Maven plugin installed] and you can quickly follow the code.
- As of today, this codebase has almost no or very less comments.
- Apache Storm v0.9.3
- Google Guava v18.0
- Logback v1.1.2
Also, please check pom.xml for more information on the various dependencies of the project.
This project uses Apache Maven to build and run the topology.
You need the following on your machine:
- Oracle JDK >= 1.8.x
- Apache Maven >= 3.2.3
- Clone this repo and import as an existing Apache Maven project to either Eclipse IDE or IntelliJ IDEA.
- This application uses Google Guava for making life simple while using Collections.
- Requires ZooKeeper, etc installed and configured in case of executing this project in distributed mode i.e. Storm Cluster.
- Follow the steps on Storm Wiki for more details on setting up a Storm Cluster.
- Follow the steps on Storm Wiki for more details on setting up a Storm Cluster.
Rest of the required frameworks and libraries are downloaded by Apache Maven as required in the build process, the first time the Apache Maven build is invoked.
To build and run this topology, you must use Java 1.8.
Local mode can also be run on Windows environment without installing any specific software or framework as such.
Note: Please make sure to clean your temp folder as it adds lot of temporary files in every run.
In local mode, this application can be run from command line by invoking:
mvn clean compile exec:java -Dexec.classpathScope=compile -Dexec.mainClass=org.p7h.storm.offline.wordcount.topology.WordCountTopology
or
mvn clean compile package && java -jar target/storm-wordcount-1.0-SNAPSHOT-jar-with-dependencies.jar
Distributed mode requires a complete and proper Storm Cluster setup. Please check Apache Storm wiki for setting up a Storm Cluster.
In distributed mode, after starting Nimbus and Supervisors on individual machines, this application can be executed on the master [or Nimbus] machine by invoking the following on the command line:
storm jar target/storm-wordcount-1.0-SNAPSHOT.jar org.p7h.storm.offline.wordcount.topology.WordCountTopology WordCount
If you find any issues, please report them either raising an issue here on Github or alert me on Twitter @P7h. Or even better, please send a pull request.
Appreciate your help. Thanks!
Copyright © 2013-2015 Prashanth Babu.
Licensed under the Apache License, Version 2.0.