...

Installing Bigtop Hadoop distribution artifacts lets you have an up and running Hadoop cluster complete with
various Hadoop ecosystem projects in just a few minutes. Be it a single node pseudo-distributed
configuration, or a fully distributed cluster, just make sure you install the packages, install the JDK,
format the namenode and have fun! If Bigtop is not supported on your OS, you can install one of the supported OSes
on a virtual machine.

Getting the packages onto your box

...

1. Install the Apache Bigtop GPG key

   No Format
   wget -O- http://www.apache.org/dist/incubator/bigtop/stable/repos/GPG-KEY-bigtop | sudo apt-key add -

2. Make sure to grab the repo file:

   No Format
   sudo wget -O /etc/apt/sources.list.d/bigtop.list http://www.apache.org/dist/incubator/bigtop/stable/repos/ubuntu/bigtop.list

3. Enable the mirror that is closest to you (uncomment one and only one pair of deb/deb-src lines). If the downloads are too slow, try another mirror

   No Format
   sudo vi /etc/apt/sources.list.d/bigtop.list

4. Update the apt cache

   No Format
   sudo apt-get update

5. Browse through the artifacts

   No Format
   apt-cache search hadoop

6. Make sure that you have the latest JDK installed on your system as well. You can either get it from the official Oracle website (http://www.oracle.com/technetwork/java/javase/downloads/jdk-6u29-download-513648.html^{Image Removed}) or follow the advice given by your Linux distribution. If your JDK is installed in a non-standard location, make sure to add the line below to the /etc/default/hadoop file

   No Format
   export JAVA_HOME=XXXX

7. Install the full Hadoop stack (or parts of it)

   No Format
   sudo apt-get install hadoop\* flume-* mahout\* oozie\* whirr-*

...

1. You have the latest JDK installed on your system as well. You can either get it from the official Oracle website (http://www.oracle.com/technetwork/java/javase/downloads/jdk-6u29-download-513648.html^{Image Removed}) or follow the advice given by your Linux distribution (e.g. some Debian based Linux distributions have JDK packaged as part of their extended set of packages). If your JDK is installed in a non-standard location, make sure to add the line below to the /etc/default/hadoop file

   No Format
   export JAVA_HOME=XXXX

2. Format the namenode

   No Format
   sudo -u hdfs hadoop namenode -format

3. Start the necessary Hadoop services. E.g. for the pseudo distributed Hadoop installation you can simply do:

   No Format
   for i in hadoop-namenode hadoop-datanode hadoop-jobtracker hadoop-tasktracker ; do sudo service $i start ; done

4. Once your basic cluster is up and running it is a good idea to create a home directory on the HDFS:

   No Format
   sudo -u hdfs hadoop fs -mkdir /user/$USER sudo -u hdfs hadoop fs -chown $USER /user/$USER

5. Enjoy your cluster

   No Format
   hadoop fs -lsr / hadoop jar /usr/lib/hadoop/hadoop-examples.jar pi 10 1000

...

It is highly recommended that you read documentation provided by the Hadoop project itself (http://hadoop.apache.org/common/docs/r0.20.205.0/^{Image Removed}) and that you browse through the Puppet deployment code that is shipped as part of the Bigtop release (bigtop-deploy/puppet/modules, bigtop-deploy/puppet/manifests).