MapReduce Edit on Github

The learning objectives for MapReduce are:

• Interprocess Communication (IPC)
• Pipes
• Files and File Descriptors
• MapReduce
• Jeff Dean

We suggest you read the following from the wikibook before starting MapReduce:

• Pipes, Part 1: Introduction to pipes
• Pipes, Part 2: Pipe programming secrets

In 2004, Google released a general framework for processing large data sets on clusters of computers. We recommend you read this link on Wikipedia for a general understanding of MapReduce. Also, this paper written by Jeffrey Dean and Sanjay Ghemawat gives more detailed information about MapReduce. However, we will explain everything you need to know below.

To demonstrate what MapReduce can do, we’ll start with a small dataset–three lines of text:

Hello
there
class!

The goal of this MapReduce program will be to count the number of occurrences of each letter in the input.

MapReduce is designed to make it easy to process large data sets, spreading the work across many machines. We’ll start by splitting our (not so large) data set into one chunk per line.

Map. Once the data is split into chunks, map() is used to convert the input into (key, value) pairs. In this example, our map() function will create a (key, value) pair for each letter in the input, where the key is the letter and the value is 1.

Reduce. Now that the data is organized into (key, value) pairs, the reduce() function is used to combine all the values for each key. In this example, it will “reduce” multiple values by adding up the counts for each letter. Note that only values for the same key are reduced. Each key is reduced independently, which makes it easy to process keys in parallel.

MapReduce is useful because many different algorithms can be implemented by plugging in different functions for map() and reduce(). If you want to implement a new algorithm you just need to implement those two functions. The MapReduce framework will take care of all the other aspects of running a large job: splitting the data and CPU time across any number of machines, recovering from machine failures, tracking job progress, etc.

For this MP, you have been tasked with building a simplified version of the MapReduce framework. It will run multiple processes on one machine as independent processing units and use IPC mechanisms to communicate between them. map() and reduce() will be programs that read from standard input and write to standard output. The input data for each mapper program will be lines of text. Key/value pairs will be represented as a line of text with “: “ between the key and the value:

key1: value1
key two: values and keys may contain spaces
key_3: but they cannot have colons or newlines

You’ll spread the work across multiple instances of the mapper executable.

[...input_file...]
|       |       |
MAP1  MAP2  MAP3
    \  |  /
     REDUCE
       |
  output_file

The input file will need to be split into chunks, with one chunk for each mapper process. To split the input file, we’ve supplied the tool splitter. Run it without arguments for a brief explanation of how it works. You’ll start up one instance of splitter for each mapper, using a pipe to send stdout of splitter to stdin of the mapper program.

  splitter inputfile 3 0
  |
  |     splitter inputfile 3 1
  |     |
  |     |    splitter inputfile 3 2
  |     |    |
MAP1  MAP2  MAP3
   \  |  /
    REDUCE
      |
 output_file

Command line:

mapreduce <input_file> <output_file> <mapper_executable> <reducer_executable> <mapper_count>

Sample Usage

% ./mapreduce test.in test.out ./my_mapper ./my_reducer 3

Your program will:

• Split the input file into parts and pipe the contents into different mapper processes (use splitter).
• Write the output of the reducer process to the output file.

Remember to close all the unused file descriptors!

This too can be done in the Unix shell:

% (./splitter inputfile 3 0 | my_mapper ; \
   ./splitter inputfile 3 1 | my_mapper ; \
   ./splitter inputfile 3 2 | my_mapper ; ) | my_reducer > test.out

Things we will be testing for:

• Inputs of varying size
• Different types of mapper and reducer tasks
• Both mapper and and reducer generating accurate output to stdout file descriptor independently
• Splitter being used correctly to generate equally sized input data for each mapper
• All mappers being run in parallel resulting in at least 2x performance speedup for the pi executable
• No memory leaks and memory errors when running the application

Things that will not be tested for:

• Illegal inputs for either the mapper or reducer (Input data in a format other than as described above)
• Invalid mapper or reducer code (mappers or reducers that do not work)
• Key Value pairs that are larger than a pipe buffer of 4096 bytes.

Building

This MP has a very complicated Makefile, but, it defines all the normal targets.

make # builds provided code and student code in release mode
make debug # builds provided code and student code in debug mode
# there is no tsan target because threading is not needed for this MP.

Input Data

To download the example input files (books from Project Gutenberg), use the Makefile:

make data

You should now see data/dracula.txt and data/alice.txt in your mp folder

Running Your Code

We have provided the following mappers:

• mapper_wordcount
• mapper_lettercount
• mapper_asciicount
• mapper_wordlengths
• mapper_pi

These each be used anywhere we specify my_mapper in these docs.

And the following reducers:

• reducer_sum
• reducer_pi

These each be used anywhere we specify my_reducer in these docs.

For example, if you wanted to count the occurrences of each word in Alice in Wonderland, you can run and of the following

./mapreduce data/alice.txt test.out ./mapper_wordcount ./reducer_sum 4

Record Setting Pi Code

As well as the simple mapper/reducer pairs, we also have also included some really cool pi computation code (see this for more info). For instructions on how to use the pi code, see the file pi/README.txt. Note that we do not currently compile this with an NVIDIA compiler, so you will not be able to use the CUDA version of this code (which we have not tested) unless you fiddle with the Makefile.

Please read details on Academic Integrity fully. These are shared by all assignments in CS 241.

We will be using Subversion as our hand-in system this semester. Our grading system will checkout your most recent (pre-deadline) commit for grading. Therefore, to hand in your code, all you have to do is commit it to your Subversion repository.

To check out the provided code for mapreduce from the class repository, go to your cs241 directory (the one you checked out for "know your tools") and run:

svn up

If you run ls you will now see a mapreduce folder, where you can find this assignment! To commit your changes (send them to us) type:

svn ci -m "mapreduce submission"

Your repository directory can be viewed from a web browser from the following URL: https://subversion.ews.illinois.edu/svn/sp17-cs241/NETID/mapreduce where NETID is your University NetID. It is important to check that the files you expect to be graded are present and up to date in your SVN copy.

We strive to provide the best assignments that we can for this course and would like your feedback on them!

This is the form we will use to evaluate assignments. We appreciate the time you take to give us your honest feedback and we promise to keep iterating on these assignments to make your experience in 241 the best it can be.
https://goo.gl/forms/z06gBY7MocFDrE3S2