Setting up an Environment to Build the Hadoop Native Library

The following are my notes on how to setup a freshly installed Centos 6.5 machine to compile the Hadoop native library. My reason for doing this was to add a modified version of the native library which utilized hardware compression. In order to accomplish that, I needed to recompile the native library. In a previous post, “Integrating Hardware Accelerated Gzip Compression into Hadoop”, I described the process for modifying the Hadoop native library to use a hardware compression accelerator.

In that previous post I utilized Hadoop 2.2. In this post I’m using Hadoop 2.4 because that’s the version of Hadoop that matches what is utilized by Ambari 1.6.0, the management tool I’ve chosen to administer my current cluster. Additionally, I was using Ubuntu 12.04 in the previous post, whereas in this post I’m using Centos 6.5. Ubuntu is typically my default Linux flavor, but because it is not compatible with Ambari, I installed Centos 6.5.

All of these steps assume you are logged in as “root”. If you aren’t, prefix the commands below with “sudo”.

1. Install the development tools required to build the native library via the package manager. (Note: Some of these may already be installed)

# yum -y update
# yum -y groupinstall “Development Tools”
# yum -y install zlib-devel
# yum -y install xz-devel
# yum -y install cmake
# yum -y install openssl-devel


2. Optionally install these packages. (Note: These steps aren’t required to build Hadoop’s native library, I just find myself having to install them eventually)

2.1 Install the kernel development package, vi, and git using the package manager
# yum install kernel-devel
# yum install vi
# yum install git
# yum install lynx

2.2 Install hexedit manually
# wget
# rpm -Uvh hexedit-1.2.10-1.el6.rf.x86_64.rpm

2.3 If you have an AHA Hardware Compression Accelerator installed, install/load the driver, and build the hardware accelerated zlib variant. See Steps 1-2 of this post.

3. Install Oracle Java JDK 1.7

You might already have this JDK installed, otherwise download Oracle Java JDK 7.1; The file should be named something similar to “jdk-7u71-linux-x64.tar.gz”. On my machine which is also a datanode (installed via Ambari) the JDK was located in /usr/jdk64/jdk1.7.0_67/.

Without the JDK already installed do this:
# mv jdk-7u71-linux-x64.tar.gz /opt/
# tar -xvf jdk-7u71-linux-x64.tar.gz
# echo -e 'export JAVA_HOME=/opt/jdk1.7.0_71\nexport PATH=${JAVA_HOME}/bin:${PATH}' > /etc/profile.d/

With the JDK already installed to /usr/jdk64/jdk1.7.0_67/ do this:
# echo -e 'export JAVA_HOME=/usr/jdk64/jdk1.7.0_67\nexport PATH=${JAVA_HOME}/bin:${PATH}' > /etc/profile.d/


4. Install Maven 3.0.5

# cd /usr/local/
# wget
# tar -xvf apache-maven-3.0.5-bin.tar.gz
# ln -s apache-maven-3.0.5 maven
# echo -e 'export M2_HOME=/usr/local/maven\nexport PATH=${M2_HOME}/bin:${PATH}' > /etc/profile.d/


5. Install Ant 1.9.4

# cd /usr/local/
# wget
# tar -xvf apache-ant-1.9.4-bin.tar.gz
# ln -s /usr/local/apache-ant-1.9.4 ant
# echo -e 'export ANT_HOME=/usr/local/ant\nexport PATH=${ANT_HOME}/bin:${PATH}' > /etc/profile.d/


6. Install Protobuf 2.5.0

# wget
# tar -xvf protobuf-2.5.0.tar.gz
# cd protobuf-2.5.0
# ./configure
# make install


7. Download Hadoop 2.4.0 source

# mkdir /usr/local/hadoop_src
# cd /usr/local/hadoop_src
# wget --no-check-certificate
# tar -xvf hadoop-2.4.0-src.tar.gz


8. Compile the Hadoop native library. This step takes a while. On my machine it takes around 50 minutes to complete. (Note: Make any changes to the native library, such as adding support for hardware compression, before this step).

# cd /usr/local/hadoop_src/hadoop-2.4.0-src
# mvn package -Pdist,native -DskipTests -Dtar


9. Backup Hadoop’s native library, and then replace it with the version compiled in step 8 (Note: The path to the hadoop libraries below are the default location that Ambari installs to. Your installation path will vary depending on how you went about your Hadoop installation)

# cd /usr/local/hadoop_src/hadoop-2.4.0-src/hadoop-dist/target/hadoop-2.4.0/lib/
# tar -cvf native_NEW.tar.gz native
# cp native_NEW.tar.gz /usr/lib/hadoop/lib/
# cd /usr/lib/hadoop/lib/
# tar -cvf native_ORIGINAL.tar.gz native
# rm -rf native
# tar -xvf native_NEW.tar.gz

That’s it!


If you aren’t able to find the exact versions of Ant, Maven, or Protobuf that I’m using in this article (and it’s causing problems), here is a zip file containing all of those tools along with the Hexedit rpm.

I’ve also have a link, here to the bash path scripts from steps 3, 4, and 5.

5 comments on “Setting up an Environment to Build the Hadoop Native Library

  1. I install Ubuntu in virtual box and my host machine is windows 8 so is this same process in my configuration? I am using hadoop- 2.7.1

  2. Thank you veru much.

    I have followd teh smae approach what you have followed still I am getting the same warning message.

  3. In my hadoop 2.7.1. I found that if on Centos 6 if b2zip is not installed
    the command hadoop checknative -a fails to load native libraries. I think the same is true for Snappy.

Leave a Reply

Your email address will not be published. Required fields are marked *