• Release version: 2.2

• Release date: 2012/10/23

• Contact: Lan Yi, Kai Wei, Shengsheng Huang, Jason Dai

• Homepage: https://github.com/intel-hadoop/Hibench

• Contents:

  1. Overview
  2. Getting Started
  3. Running
  4. For Yarn

This benchmark suite contains 9 typical Hadoop workloads (including micro benchmarks, HDFS benchmarks, web search benchmarks, machine learning benchmarks, and data analytics benchmarks). This benchmark suite also has options for users to enable input/output compression for most workloads with default compression codec (zlib). Some initial work based on this benchmark suite please refer to the included ICDE workshop paper (i.e., WISS10_conf_full_011.pdf).

Note: Since HiBench-2.2, the input data of benchmarks are all automatically generated by their corresponding prepare scripts.

Micro Benchmarks:

1. Sort (sort)

   This workload sorts its text input data, which is generated using the Hadoop RandomTextWriter example.

2. WordCount (wordcount)

   This workload counts the occurrence of each word in the input data, which are generated using the Hadoop RandomTextWriter example. It is representative of another typical class of real world MapReduce jobs - extracting a small amount of interesting data from large data set.

3. TeraSort (terasort)

   TeraSort is a standard benchmark created by Jim Gray. Its input data is generated by Hadoop TeraGen example program.

HDFS Benchmarks:

4. enhanced DFSIO (dfsioe)

   Enhanced DFSIO tests the HDFS throughput of the Hadoop cluster by generating a large number of tasks performing writes and reads simultaneously. It measures the average I/O rate of each map task, the average throughput of each map task, and the aggregated throughput of HDFS cluster.

Web Search Benchmarks:

5. Nutch indexing (nutchindexing)

   Large-scale search indexing is one of the most significant uses of MapReduce. This workload tests the indexing sub-system in Nutch, a popular open source (Apache project) search engine. The workload uses the automatically generated Web data whose hyperlinks and words both follow the Zipfian distribution with corresponding parameters. The dict used to generate the Web page texts is the default linux dict file /usr/share/dict/linux.words.

6. PageRank (pagerank)

   The workloads contains an implementation of the PageRank algorithm on Hadoop (a search engine ranking benchmark included in pegasus 2.0). The workload uses the automatically generated Web data whose hyperlinks follow the Zipfian distribution.

Machine Learning Benchmarks:

7. Mahout Bayesian classification (bayes)

   Large-scale machine learning is another important use of MapReduce. This workload tests the Naive Bayesian (a popular classification algorithm for knowledge discovery and data mining) trainer in Mahout 0.7, which is an open source (Apache project) machine learning library. The workload uses the automatically generated documents whose words follow the zipfian distribution. The dict used for text generation is also from the default linux file /usr/share/dict/linux.words.

8. Mahout K-means clustering (kmeans)

   This workload tests the K-means (a well-known clustering algorithm for knowledge discovery and data mining) clustering in Mahout 0.7. The input data set is generated by GenKMeansDataset based on Uniform Distribution and Guassian Distribution.

Data Analytics Benchmarks:

9. Hive Query Benchmarks (hivebench)

   This workload is developed based on SIGMOD 09 paper "A Comparison of Approaches to Large-Scale Data Analysis" and HIVE-396. It contains Hive queries (Aggregation and Join) performing the typical OLAP queries described in the paper. Its input is also automatically generated Web data with hyperlinks following the Zipfian distribution.

2. Prerequisites

3. Setup HiBench-2.2

   Download/checkout HiBench-2.2 benchmark suite from https://github.com/intel-hadoop/HiBench/zipball/HiBench-2.2

4. Setup Hadoop

   Before you run any workload in the package, please verify the Hadoop framework is running correctly. All the workloads have been tested with Cloudera Distribution of Hadoop 3 update 4 (cdh3u4) and Hadoop version 1.0.3

5. Setup Hive (for hivebench)

   Please make sure you have properly set up Hive in your cluster if you want to test hivebench. Or the benchmark willuse the default Hive-0.9 release which is included in package.

6. Configure for the all workloads

   You need to set some global environment variables in the bin/hibench-config.sh file located in the root dir.

      HADOOP_HOME      <The Hadoop installation location>
      HADOOP_CONF_DIR  <The hadoop configuration DIR, default is $HADOOP_HOME/conf>
      COMPRESS_GLOBAL  <Whether to enable the in/out compression for all workloads, 0 is disable, 1 is enable>
      COMPRESS_CODEC_GLOBAL  <The default codec used for in/out data compression>
   

   Note: Do not change the default values of other global environment variables unless necessary.

7. Configure each workload

   You can modify the conf/configure.sh file under each workload folder if it exists. All the data size and options related to the workload are defined in this file.

8. Synchronize the time on all nodes (This is required for dfsioe, and optional for others)

• Run several workloads together

  The conf/benchmarks.lst file under the package folder defines the workloads to run when you execute the bin/run-all.sh script under the package folder. Each line in the list file specifies one workload. You can use # at the beginning of each line to skip the corresponding bench if necessary.

• Run each workload separately

  You can also run each workload separately. In general, there are 3 different files under one workload folder.

    conf/configure.sh	Configuration file contains all parameters such as data size and test options.
    bin/prepare*.sh   Generate or copy the job input data into HDFS.
    bin/run*.sh       Execute the workload
  

  Follow the steps below to run a workload

  1. Configure the benchmark:

     set your own configurations by modifying configure.sh if necessary

  2. Prepare data:

     bin/prepare.sh (bin/prepare-read.sh for dfsioe) to prepare input data in HDFS for running the benchmark

  3. Run the benchmark:

     bin/run*.sh to run the corresponding benchmark

At present, To run Hibench on top of Yarn is supported in Yarn branch. And all test cases are supported.

• If you are using mapreduce 1.0 on cdh4/5, you need to configure a little to run nutchindexing:

  Change the nutch-site-mr1.xml to nutch-site.xml to replace the default one in HiBench/nutchindexing/nutch-1.2-cdh4/conf or HiBench/nutchindexing/nutch-1.2-cdh5/conf which depends on your cdh version.