(Update: tested v2.7.2 on Ubuntu 18)


OBS: security warning !
Note: change the core-site.xml and hdfs-site.xml content before running.
Note: change the HDUSER username before running.

# w/ java
curl https://raw.githubusercontent.com/SunnyBingoMe/install-hadoop/master/setup-hadoop | bash

Env & Hd-Structure Config (Multi-Node Only)

Make sure the master node and the hadoop user, e.g. $hduser can access work nodes using passphrase-less ssh keys.
If a different username ($hduser) rather than the installer user ($user) is to run hadoop, we need to run setup_profile and setup_environment after su $hduser (some minor errors will be given by bash, no worries.)

For multi-node usage, on each node, append /etc/hosts with:

. . . hd-master hd-node1 hd-node2 hd-node2

For multi-node usage, on master, config $HADOOP_HOME/etc/hadoop/slaves as:


(by default: the slaves file has a single line localhost, i.e. the master will consider localhost as the only 1 datanode.)

Explain (vis Sunny exp): running start-dfs.sh on master will cause the master to check slaves and run hdfs.daemon.sh start datanode on each slave via ssh. Thus the DataNode will rely on its own config. If the NameNode address ("fs.default.name" in core-site.xml) on the DataNode is wrong, the DataNode will not be able to connect to the NameNode. Also, stop-dfs.sh canNOT stop DataNode:s if the DataNode is not in slaves (and the DataNode will try to re-connect until max-retry). This file is only read by the master when need to use, so the modification during the hdfs running will also take effect whenever the master needs the related content in the file, such as when start-/stop-dfs.sh

Tip 1: [safe mode] If the hdfs has been formatted & tested under single-node mode and then being changed to multi-node with a drop of files, it canNOT leave safe mode, The safe-mode is shown in the first line of hdfs dfsadmin -report. The cluster is in safe-mode when started, but will leave safe-mode after file checks are ok in several seconds.

Tip 2: [adding node] does not require restarting hdfs/NameNode. (see below "Add A New DataNode" regarding how to add)

Hadoop Config (Advanced Usage Only)

(curl-bash code already includes this, we can ignore this part when just starting to try.)

On each node, set NameNode Location by updating $HADOOP_HOME/etc/hadoop/core-site.xml.

<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="configuration.xsl"?>
        <description>optional, temporary directories.</description>
        <description>optional, default 9000. IPC port for jar job submission.</description>

On each node, set path for HDFS, by updating $HADOOP_HOME/etc/hadoop/hdfs-site.xml.

    <!-- property>
    </property -->
            <description>optional?, default 1?.</description>

Format FS

On master:

hdfs namenode -format

Tip: formatting is always needed after a fresh installation and only the NameNode needs formatting.


On master, run: (run in anywhere, should be in PATH already)



(For either single or multi-node clusters.)

bash (local)

# admin test:
hdfs dfsadmin -report
hdfs dfsadmin -help

# folder io test:
hdfs dfs -ls / # test read
hdfs dfs -mkdir -p /foo/bar && hdfs dfs -ls /foo/bar && hdfs dfs -ls /  # test write

# file io test:
cat /etc/*release > file1.txt
date > file2.txt
hdfs dfs -put file1.txt file2.txt /foo/bar && rm file1.txt file2.txt && hdfs dfs -cat /foo/bar/file2.txt # write local to hdfs
ls *.txt; hdfs dfs -get /foo/bar/file1.txt; ls *.txt # read hdfs to local

py (py2, local & remote)

pip install hdfs


import datetime
from hdfs import InsecureClient

t_datetime = datetime.datetime.now()
content = 'asdf\n ddddd' + str(t_datetime)
client = InsecureClient('http://hd-master:50070')
with client.write('/foo/bar/file3.txt', overwrite=True) as pf_write:

(Note: 50070 is for both Web UI and Restful API.)


from hdfs import InsecureClient
client = InsecureClient('http://hd-master:50070')
with client.read('/foo/bar/file3.txt') as pf_read:
    content_read = pf_read.read()

OBS: by default, the remote permission is not enabled.
To enable:

sed -i "s/<configuration>/<configuration><property><name>dfs.permissions.enabled<\/name><value>false<\/value><\/property>/" /usr/local/hadoop/hadoop-2.7.2/etc/hadoop/hdfs-site.xml

WARN: for test only, insecure!

Web UI / GUI

Default port 50070 on master (any interface IP will work).
Note 1: this port is also used for rest-api.
Note 2: use core-site.xml to change if needed.
see pic in ps at the bottom.

Change Single-Node To Multi-Node

The curl-bash script is for single-node only.
To have a multi-node cluster:

  • The NameNode needs to listen on a public address (which requires /etc/hosts if using hostnames than IPs) instead of localhost ("fs.default.name" in core-site.xml on the master)
  • The DataNode:s need to know the master's address ("fs.default.name" in core-site.xml on slaves) (which also requires /etc/hosts if using hostnames than IPs)
  • To let the NameNode start the DataNode:s automatically when start-dfs.sh, the DataNode:s should be in $HADOOP_HOME/etc/hadoop/slaves file.
  • All automatic start/stop:s are done via passphrase-less ssh.

To change the first 2 points wrt the public address:

ansibleall 'ADDR="hd-master:9000" && \
HADOOP_HOME="/usr/local/hadoop/hadoop-2.7.2/" && \
sed -i "s/.*<value>hdfs:\/\/.*/\t<value>hdfs:\/\/${ADDR}<\/value>/" $HADOOP_HOME/etc/hadoop/core-site.xml'

(for non-ansible users: on each node: set ADDR and HADOOP_HOME and then do sed.)

Add A New DataNode

Summary: install the same, config the same, start the DataNode and done/ready to use.

  1. Make sure the NameNode is listening on a public address.
  2. Install use the same hdfs, e.g. curl-bash.
  3. Config the same (e.g. just copy folder $HADOOP_HOME/etc/hadoop/ to the new DataNode).
  4. On the new DataNode: hdfs.daemon.sh start datanode.
  5. Remember to add the new DataNode to $HADOOP_HOME/etc/hadoop/slaves on the master so that it can be stop/start by the master.

Spark Usage

Make sure all spark nodes have permission to access HDFS.

Detailed Config & Performance Tuning



Main ref: linode
See more in doc


Hadoop Web UI (50070):
Hadoop Web UI