Public | Automated Build

Last pushed: a year ago
Short Description
SURFsara Hadoop service client as a Docker container
Full Description


This repository contains client configuration for the SURFsara Hadoop cluster
Hathi. At the moment it contains configuration for Hadoop 2.7.1 and Pig 0.16.0
and Spark 2.1.1.


This software is tested on Linux and OSX. On Linux you need to make sure that
Git, Java 7 and the Kerberos client libraries are installed. On OSX these
should already be installed.

Debian-based Linux (Debian, Ubuntu, Mint):

apt-get install git openjdk-7-jre-headless krb5-user

Enterprise Linux (Redhat, CentOS, Fedora):

yum install git java-1.7.0-openjdk krb5-workstation

Note that when using the Oracle JDK (e.g. OSX) you will need to install the
Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files
for your specific JVM version.

For Oracle Java 7 they can be found here:

For Oracle Java 8:


The first time you need to download the official Hadoop/Pig/Spark software from
Apache and put the SURFsara configuration in the right location. We provide a
helper script that will do this automatically:

git clone --depth 1
/path/to/hathi-client/bin/ hadoop
/path/to/hathi-client/bin/ pig
/path/to/hathi-client/bin/ spark

Whenever you want to use the cluster you need to perform the following once per

1) Setup the environment:

eval $(/path/to/hathi-client/bin/

(You can add this line to your ~/.profile so that it is run automatically on

2) Now you can authenticate using Kerberos:


And use the Hadoop, Pig and Spark utilities:

hdfs dfs -ls /

yarn jar $HADOOP_HOME/share/hadoop/mapreduce/hadoop-mapreduce-examples-*.jar pi 5 5

spark-submit --class org.apache.spark.examples.SparkPi \
             --master yarn  --deploy-mode cluster \
             $SPARK_HOME/lib/spark-examples*.jar 10

Browser setup

In order to authenticate to the webapps you will need to use Firefox and alter
the about:config (promise to be careful). Search for the key
network.negotiate-auth.trusted-uris and add the value

In addition, Firefox needs to be aware of the Kerberos setup. For this the
Kerberos configuration conf/krb5.conf needs to be placed in the right
location (you will need root access for this). Note that if you work with
different Kerberos realms you can also add the KDC configuration (the
[realms] section) from the hathi-client file to any existing Kerberos
configuration file. To copy (and overwrite any existing files) the
configuration to the correct location:

For OSX:

cp git/hathi-client/conf/krb5.conf $HOME/Library/Preferences/

For Linux:

sudo cp git/hathi-client/conf/krb5.conf /etc/

The resource manager of the cluster can then be found at

The namenode of the cluster is located at


For more information about the SURFsara Hadoop cluster see

For any questions using Hadoop at SURFsara contact the SURFsara

Docker Pull Command
Source Repository