Running Apache Hadoop 2.1.0 on Windows

I am new to Hadoop and have run into problems trying to run it on my Windows 7 machine. Particularly I am interested in running Hadoop 2.1.0 as its release notes mention that running on Windows is supported. I know that I can try to run 1.x versions on Windows with Cygwin or even use prepared VM by for example Cloudera, but these options are in some reasons less convenient for me.

Having examined a tarball from I found that there really are some *.cmd scripts that can be run without Cygwin. Everything worked fine when I formated HDFS partition but when I tried to run hdfs namenode daemon I faced two errors: first, non fatal, was that winutils.exe could not be found (it really wasn't present in the tarball downloaded). I found the sources of this component in the Apache Hadoop sources tree and compiled it with Microsoft SDK and MSbuild. Thanks to detailed error message it was clear where to put the executable to satisfy Hadoop. But the second error which is fatal doesn't contain enough information for me to solve:

13/09/05 10:20:09 FATAL namenode.NameNode: Exception in namenode join
    at$Windows.access0(Native Method)
    at org.apache.hadoop.fs.FileUtil.canWrite(
    at org.apache.hadoop.hdfs.server.common.Storage$StorageDirectory.analyzeStorage(
    at org.apache.hadoop.hdfs.server.namenode.FSImage.recoverStorageDirs(
    at org.apache.hadoop.hdfs.server.namenode.FSImage.recoverTransitionRead(
13/09/05 10:20:09 INFO util.ExitUtil: Exiting with status 1

Looks like something else should be compiled. I'm going to try to build Hadoop from the source with Maven but isn't there a simpler way? Isn't there some option-I-know-not-of that can disable native code and make that tarball usable on Windows?

Thank you.

UPDATED. Yes, indeed. "Homebrew" package contained some extra files, most importantly winutils.exe and hadoop.dll. With this files namenode and datanode started successfully. I think the question can be closed. I didn't delete it in case someone face the same difficulty.

UPDATED 2. To build the "homebrew" package I did the following:

  1. Got sources, and unpacked them.
  2. Read carefully BUILDING.txt.
  3. Installed dependencies:
    3a) Windows SDK 7.1
    3b) Maven (I used 3.0.5) 3c) JDK (I used 1.7.25)
    3d) ProtocolBuffer (I used 2.5.0 - ). It is enough just to put compiler (protoc.exe) into some of the PATH folders.
    3e) A set of UNIX command line tools (I installed Cygwin)
  4. Started command line of Windows SDK. Start | All programs | Microsoft Windows SDK v7.1 | ... Command Prompt (I modified this shortcut, adding option /release in the command line to build release versions of native code). All the next steps are made from inside SDK command line window)
  5. Set up the environment:

    set JAVA_HOME={path_to_JDK_root}

It seems that JAVA_HOME MUST NOT contain space!

set PATH={path_to_maven_bin};%PATH%  
set Platform=x64  
set PATH={path_to_cygwin_bin};%PATH%  
set PATH={path_to_protoc.exe};%PATH%  
  1. Changed dir to sources root folder (BUILDING.txt warns that there are some limitations on the path length so sources root should have short name - I used D:\hds)
  2. Ran building process:

    mvn package -Pdist -DskipTests

You can try without 'skipTests' but on my machine some tests failed and building was terminated. It may be connected to sybolic link issues mentioned in BUILDING .txt. 8. Picked the result in hadoop-dist\target\hadoop-2.1.0-beta (windows executables and dlls are in 'bin' folder)


I had the same problem but with recent hadoop v. 2.2.0. Here are my steps for solving that problem:

  1. I've built winutils.exe from sources. Project directory:


    My OS: Windows 7. Tool for building: MS Visual Studio Express 2013 for Windows Desktop (it's free and can be loaded from ). Open Studio, File -> Open -> winutils.sln. Right click on solution on the right side -> Build. There were a couple errors in my case (you might need to fix project properties, specify output folder). Viola! You get winutils.exe - put it into hadoop's bin.

  2. Next we need to build hadoop.dll. Some woodoo magic here goes: open


    in MS VS; right click on solution -> build. I got a bunch of errors. I created manually several missed header files (don't ask me why they are missed in source tarball!):

    (and don't ask me what this project on git is for! I don't know - google pointed it out by searching header file names) I've copied


    (result of step # 1) into


    And finally build operation produces hadoop.dll! Put it again into hadoop's bin and happily run namenode!

Hope my steps will help somebody.

I have followed following steps to install Hadoop 2.2.0

Steps to build Hadoop bin distribution for Windows

  1. Download and install Microsoft Windows SDK v7.1.

  2. Download and install Unix command-line tool Cygwin.

  3. Download and install Maven 3.1.1.

  4. Download Protocol Buffers 2.5.0 and extract to a folder (say c:\protobuf).

  5. Add Environment Variables JAVA_HOME, M2_HOME and Platform if not added already. Note : Variable name Platform is case sensitive. And value will be either x64 or Win32 for building on a 64-bit or 32-bit system. Edit Path Variable to add bin directory of Cygwin (say C:\cygwin64\bin), bin directory of Maven (say C:\maven\bin) and installation path of Protocol Buffers (say c:\protobuf).

  6. Download hadoop-2.2.0-src.tar.gz and extract to a folder having short path (say c:\hdfs) to avoid runtime problem due to maximum path length limitation in Windows.

  7. Select Start --> All Programs --> Microsoft Windows SDK v7.1 and open Windows SDK 7.1 Command Prompt. Change directory to Hadoop source code folder (c:\hdfs). Execute mvn package with options -Pdist,native-win -DskipTests -Dtar to create Windows binary tar distribution.

  8. If everything goes well in the previous step, then native distribution hadoop-2.2.0.tar.gz will be created inside C:\hdfs\hadoop-dist\target\hadoop-2.2.0 directory.

Install Hadoop

  1. Extract hadoop-2.2.0.tar.gz to a folder (say c:\hadoop).

  2. Add Environment Variable HADOOP_HOME and edit Path Variable to add bin directory of HADOOP_HOME (say C:\hadoop\bin).

Configure Hadoop







C:\hadoop\etc\hadoop\ yarn-site.xml


Format namenode

For the first time only, namenode needs to be formatted.

C:\Users\abhijitg>cd c:\hadoop\bin 
c:\hadoop\bin>hdfs namenode –format

Start HDFS (Namenode and Datanode)

C:\Users\abhijitg>cd c:\hadoop\sbin

Start MapReduce aka YARN (Resource Manager and Node Manager)

C:\Users\abhijitg>cd c:\hadoop\sbin
starting yarn daemons

Total four separate Command Prompt windows will be opened automatically to run Namenode, Datanode, Resource Manager, Node Manager

Reference : Build, Install, Configure and Run Apache Hadoop 2.2.0 in Microsoft Windows OS

Han has prepared the Hadoop 2.2 Windows x64 binaries (see his blog) and uploaded them to Github.

After putting the two binaries winutils.exe and hadoop.dll into the %hadoop_prefix%\bin folder, I got the same UnsatisfiedLinkError.

The problem was that some dependency of hadoop.dll was missing. I used Dependency Walker to check the dependencies of the binaries and the Microsoft Visual C++ 2010 Redistributables were missing.

So besides building all the components yourself, the answer to the problem is

  • make sure to use the same architecture for Java and the native code. java -version tells you if you use 32 or x64.
  • then use Dependency Walker to make sure all native binaries are pure and of the same architecture. Sometimes a x64 dependency is missing and Windows falls back to x86, which does not work. See answer of another question.
  • also check if all dependencies of the native binaries are satisfied.

In addition to other solutions, here is a pre-built copy of winutil.exe. Donload it and add to $HADOOP_HOME/bin. It works for me.

(Source :Click here)

Instead of using the official branch I would suggest the windows optimized

You need to compile it, build winutils.exe under windows and place it in the hadoop/bin directory

I ran into same problem with Hadoop 2.4.1 on Windows 8.1; there were a few differences with the resulting solution caused mostly by the newer OS.

I first installed Hadoop 2.4.1 binary, unpacking it into %HADOOP_HOME%.

The previous answers describe how to set up Java, protobuf, cygwin, and maven, and the needed environment variables. I had to change my Platform environment variable from HP's odd 'BCD' value.

I downloaded the source from an Apache mirror, and unpacked it in a short directory (HADOOP_SRC = C:\hsrc). Maven ran fine from a standard Windows command prompt in that directory: mvn package -DskipTests.

Instead of using the Windows 7 SDK (which I could not get to load) or the Windows 8.1 SDK (which doesn't have the command line build tools), I used the free Microsoft Visual Studio Express 2013 for Windows Desktop. Hadoop's build needed the MSBuild location (C:\Program Files (x86)\MSBuild\12.0) in the PATH, and required that the various Hadoop native source projects be upgraded to the newer (MS VS 2013) format. The maven build failures were nice enough to point out the absolute path of each project as it failed, making it easy to load the project into Visual Studio (which automatically converts, after asking).

Once built, I copied the native executables and libraries into the Hadoop bin directory. They were built in %HADOOP_SRC%\hadoop-common-project\hadoop-common\target\bin, and needed to be copied into %HADOOP_HOME%\bin.

Adding hadoop.dll and hdfs.dll to the %HADOOP_HOME%\bin folder did the trick for me.

Just installed Hadoop 2.2.0 in my environment win7 X64.

following BUILD.txt makes me did that.Note that:the dir in the hdfs-site.xml and mapred-site.xml is starts with / like below



May help u!


 ? Hadoop data visualization
 ? Data Visualisation
 ? Data Visualisation
 ? Data Visualisation
 ? Data visualization using graphs (Display relationships between people, based on personality test)
 ? Data flow visualisation
 ? Displaying web based visualisation or graphing of data based on a postgresql database?
 ? Multiple inputs multivariate data visualisation
 ? Data Visualisation Algorithm Books
 ? Data Visualisation Algorithm Books