Get Started with Cascading on Hortonworks Data Platform 2.1
This tutorial will enable you, as a Java developer, to learn the following:
- Introduce you to Hortonworks Data Platform 2.1 on Hortonworks Sandbox, a single-node cluster
- Introduce you to Java Cascading SDK
- Examine the WordCount program in Java
- Build the single unit of execution, the jar file, using the gradle build tool
- Deploy the jar file onto to the Sandbox
- Examine the resulting MapReduce Jobs
- View at the output stored as an HDSF file.
To start this tutorial, you must do two things: First, download the Sandbox and follow the installation instructions. Second, download the Cascading SDK.
The example WordCount is derived from part 2 of the Cascading Impatient Series.
Downloading and installing the HDP 2.1 Sandbox
- Download and install HDP 2.1 Sandbox.
- Familiarize yourself with the navigation on the Linux virtual host through a shell window.
- Login into your Linux Sandbox and create a user cascade (E.g : useradd cascade ).
Git Clone Cascading example and Build it
- Download and install gradle-1.1 onto the Linux sandbox.
- On the Sandbox cd /home/cascade
git clone git://github.com/Cascading/Impatient.git
gradle clean jar(this builds the impatient.jar file, which is your wordcount unit of execution)
Deploying and running the Cascading Java application
Now you’re ready to run and deploy your impatient.jar file onto the cluster.
- su cascade
- cd /home/cascade/Impatient/part2
- hadoop fs -mkdir -p /user/cascade/data/
hadoop fs -copyFromLocal data/rain.txt /user/cascade/data/
hadoop jar ./build/libs/impatient.jar data/rain.txt output/wc
This command will produce the following output:
Tracking the MapReduce Jobs on Sandbox
Once the job is submitted (or running) you can actually track its progress from the Sandbox Hue’s Job Browser. By default, it will display all jobs run by the user hue; filter by the user cascade.
Double click on any links to see job details.
Viewing the WordCount Output
When the job is finished, the word counts are written as an HDFS file part-00000. Use the Sandbox Hue’s File Browser to navigate to the HDFS directory and view its contents.
Above and Beyond
For the adventurous, you can try the entire Impatient Series, after you have downloaded the sources from the github. Beyond the Impatient series, there’re other tutorials and case examples to play with.