Community Articles
Find and share helpful community-sourced technical articles.

Purpose of this article:

When you install HDP for dev/test environment, you would repeat same commands to set up your host OS. To save time, created a BASH script which helps to set up the host OS (Ubuntu only) and docker image (CentOS).

What this script does:

  • Install packages on Ubuntu host OS
  • Set up docker, such as creating image and spawning containers
  • [Optional] Set up a local repository for HDP (not Ambari) with Apache2

What this script does NOT:

  • As of this writing, this does not install HDP Please use Ambari Blueprint if you would like to automate HDP installation as well
  • This step is NOT for production environment but would be useful to test HA components

Host set up steps:

  1. Install Ubuntu 14.x LTS on your VirtualBox/VMware/Azure/AWS. It should be easy to deploy Ubuntu VM if you use Azure or AWS. If you are using VirtualBox/VMWare, you might want to backup Ubuntu installed VM as a template, so that later you can clone.
  2. Login to Ubuntu and become root (sudo -i)
  3. Download script: wget -O ./ && chmod u+x ./
  4. Start the script with Install mode: ./ -i
  5. Script will ask a few questions such as your choice of guest OS, Ambari version, HDP version etc.. Normally default values should be OK, so you can just keep pressing Enter key. NOTE: The end of interview, it asks you to save your answer in a text file. You can reuse this file to skip interview when you install a new cluster
  6. After saving your responses, it will ask you "Would you like to start setup this host? [Y]:". If you answer yes, it starts setting up your Ubuntu host OS.
  7. After waiting for while, the scripts finishes, or if there is any error, it stops. The time would be depending on your choice. If you selected to setup a local repo, downloading repo may take long time.
  8. Once the script completed successfully, your choice of Ambari Server should be installed and running on your specified docker container on port 8080. NOTE: At this moment, docker containers are installed in a private network, so that you would need to do one of followings ("1" would be the easiest):
    1. Following command creates proxy from your local PC port 18080: ssh -D 18080 username@ubuntu-hostname
    2. Following command do port forwarding from your localhost:8080 to node1:8080 ssh -L 8080:node1.localdomain:8080 username@ubuntu-hostname
    3. Set up proper proxy, such as squid
  9. If you decided to set up a proxy, installing addon such as "SwitchySharp" would be handy.
  10. Once you confirmed you can use Ambari web interface, please proceed to install HDP. If you choose to set up a HDP local repository, please replace "" to "dockerhost1.localdomain" (if you used default value)


  11. Private key should be ~/.ssh/id_rsa in any node


  12. After this, the step should be same as installing normal HDP. NOTE: if you decided to install older Ambari version, there is a known issue AMBARI-8620

Host Start up step

  • If you shutdown the VM, next time you can just run "./ -s" which starts up containers, Ambari Server, Ambari Agents and HDP services.



Now, to setup host and install HDP, only "./ -a". It automatically sets up the latest HDP in your Ubuntu 14.04 (16 is not supported) To access, it starts a proxy on port 28080, so you can change the browser proxy setting to use Ubuntu_IP:28080. Or, if Ubuntu and your PC are in same network, just adding a route to containers works (eg: route add -net Ubuntu_IP on your Mac)