Skip to content
Collection of tools for bootstrapping Apache Ambari & deploying clusters
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
Vagrantfile Feature/ambari 2.7.3 hdp 3.1 (#39) Apr 17, 2019


Collection of tools for bootstrapping Apache Ambari & deploying clusters

There are several tools:

  • - script which installs & configures Ambari along with it's pre-requisites.
  • ./deploy/ - tools to quickly deploy clusters using Ambari
  • ./providers/ - tools for various infrastructure/Cloud providers


Install & configure ambari-agent and/or ambari-server along with any pre-requisites.


  • RedHat Enterprise Linux & CentOS 6
  • Planned support: Ubuntu. Welcoming contribution for any others


  • 'root' or 'sudo' access
  • Internet access and functioning yum/apt repositories.


  • Quick start (ambari-agent only):

    • Fetch and then execute: sudo sh ./
    • Or, if you trust me: curl -sSL | sudo -E sh
  • With options (showing install of Ambari agent, server, Oracle Java, and registering to an Ambari Server such that SSH keys aren't required)

    export install_ambari_agent=true
    export install_ambari_server=true
    export java_provider=oracle
    export ambari_server=myserver.domain.local
    sudo sh ./


By default the script runs with these parameters:

install_ambari_agent=true   ## Install the ambari-agent package.
install_ambari_server=false ## Install the ambari-server package.
java_provider=open          ## Which Java provider to use ('open' or 'oracle').
ambari_server=localhost     ## Hostname of the Ambari Server.
                            ##   Allowing agents to register themselves with the
                            ##   server so you do not need to distribute SSH keys.
ambari_version=1.7.0        ## Used to determine which repo/source to get packages from.
                            ##   Only tested with 1.7.0
ambari_repo=...             ## The ambari.repo file to use for yum. See file for default
                            ##   and change at your own risk.


I need to run this against a large number of hosts

There are a few options:

a. If the servers are deployed through automation (such as with CloudProviders), you can include it in that orchestration. See ./providers/aws/ for an example. b. Pass the script to the servers a distributed ssh tool, such as pdsh. You could do this directly with SSH but ‘pdsh’ is more efficient.

bootstrap_url=  ## this is the internal hostname of the ambari_server. Likely different than the host you will SSH too.

## install the ambari-server
pdsh -w "curl -sSL ${bootstrap_url} | install_ambari_server=true sh"

## install to all other nodes. See ‘man pdsh’ for the various ways you can specify hosts.
pdsh -w p-workshop-ops0[2-4] "curl -sSL ${bootstrap_url} | ambari_server=${ambari_server} sh"

I want to install Ambari & then deploy HDP using blueprints

After deploying the server & agents, you can quickly deploy HDP using Ambari Blueprints. See more in ./api-examples/.

Alternatively, use the script from ./deploy/ to generate an Ambari Blueprint and deploy the cluster.

For example, this will deploy to a single node & then deploy with all HDP services which are supported by Ambari Blueprints.

yum -y install git python-argparse
git clone
cd ambari-bootstrap
export install_ambari_server=true
cd deploy
bash ./deploy-recommended-cluster.bash

If deploying to multiple nodes, install to all of the agent machines 1st, as described earlier, and then run the above on the server.


You can’t perform that action at this time.