Hortonworks Data Platform 1.1: HMC Quick Start

Hortonworks Management Center (HMC), based on Apache Ambari, is a web-based method to install the Hortonworks Data Platform (HDP). The following instructions contain information to help prepare your cluster and install the software. These quick start instructions are here to help you get started. We recommend you review this information thoroughly prior to performing an installation. And for complete installation instructions, please refer to the Hortonworks Documentation.

System Requirements

Component Platforms
Hortonworks Management Center (HMC) (1) Operating Systems
RHEL / CentOS 5 (64-bit)
RHEL / CentOS 6 (64-bit)

Web Browsers
Mozilla Firefox – Latest stable version (12 or later)
Hadoop Components Operating Systems (2)
RHEL / CentOS 5 (64-bit)
RHEL / CentOS 6 (64-bit)
  1. The Hortonworks Management Center runs on the HMC Server.
  2. To install the Hadoop Components on different Operating Systems (such as SUSE Linux Enterprise Server), use gsInstaller or one of the Manual Install options.

Preparing Your Cluster

In order to prepare your cluster for HDP, you will need to perform steps on each host that will be part of your cluster, as well as prepare the entire cluster to accept installation of the HDP software. This section provides information on those configurations.

Perform the following steps on the HMC Server and each host you plan to include as part of your cluster.

  1. Confirm the Fully Qualified Domain Name (FQDN) for each host using the command hostname -f.

    If deploying your cluster to Amazon EC2, be sure to use the Private DNS host name.

  2. Confirm each host has Internet access via HTTP, HTTPS and FTP. When performing the HDP install, each host in the cluster will access the Internet to obtain software packages required for installation.

    If your hosts will use a proxy to access the Internet, configure each host machine to use an Internet proxy. Check with your IT or network team for these settings.

    If you do not have Internet access available to your cluster hosts refer to the Hortonworks Documentation on how to setup a Local Mirror Repository.

  3. Remove or disable any existing Puppet agent configurations. HDP performs the software installation (and ongoing cluster management) using Puppet. With HDP, the HMC Server is the Puppet master and each host in your cluster acts as a Puppet Agent.
  4. Disable SELinux
  5. Enable NTP on the cluster to synchronize the clocks across the hosts.
  6. Prepare Password-less SSH Login for root user between the HMC Server and each host in the cluster. This enables the HMC Server to reach each host in the cluster via SSH without prompting for a password.

    Password-less SSH Login is required for the HMC Server to access each host in the cluster and install the necessary software components. For more information, please refer to the Hortonworks Documentation.

    Confirm the HMC Server can SSH to itself without prompting for a password. This can be done using the ssh root@localhost command.

  7. Check the dependencies on each host in the cluster using the yum info [dependency]command. Confirm the following are either not installed, or if installed, they are these versions based on your operating system.
    Name Dependency Version-Release
    Ruby ruby [RHEL + CentOS 5]
    1.8.5-24.el5
    [RHEL + CentOS 6]
    1.8.7.*.el6
    Puppet puppet [RHEL + CentOS 5]
    2.7.9-2
    [RHEL + CentOS 6]
    2.7.9-2.el6
    Ruby Rack rubygem-rack [RHEL + CentOS 5]
    1.1.0-2.el5
    [RHEL + CentOS 6]
    1.1.0-2.el6
    Ruby Passenger rubygem-passenger [RHEL + CentOS 5]
    3.0.12-1.el5.centos
    [RHEL + CentOS 6]
    3.0.12-1.el6
    Nagios nagios [RHEL + CentOS 5]
    3.0.12-1.el5.centos
    [RHEL + CentOS 6]
    3.2.3-2.el6
    Nagios Plugins nagios-plugins [RHEL + CentOS 5]
    1.4.15-2.el5
    [RHEL + CentOS 6]
    1.4.9-1
    Nagios Common nagios-common [RHEL + CentOS 5]
    2.12-10.el5
    [RHEL + CentOS 6]
    2.12-10.el6
    MySQL mysql [RHEL + CentOS 5 + 6]
    5.*
    Ganglia ganglia-gmond
    ganglia-gmetad    		 [RHEL + CentOS 5 + 6]
    3.2.0

Pre-Flight Operations Checklist

Complete the Preparing Your Cluster steps above and confirm you have the following handy before you install and start HMC:

Check Operation Description
SSH Private Key Obtain the SSH Private Key (typically id_rsa) to use during the installation. Refer to the Hortonworks Documentation for more information on how the Private Key is used during cluster provisioning.
Host names text file Create a text file of host names that will be part of your cluster. This file should contain a list of target host names, separated by newline, for the cluster. Refer to the Preparing Your Cluster section for more information on obtaining the hostname for each host in your cluster.

The host name should be the FQDN for the host, not the IP address. For more information, refer to the Hortonworks Documentation.

Download and Install

  1. On the server you plan to use to host HMC, download and install the appropriate RPM based on your HMC Server platform.
    HMC Server Platform HDP RPM
    RHEL / CentOS 5 (64-bit) rpm -Uvh http://public-repo-1.hortonworks.com/HDP-1.1.1.16/repos/centos5/hdp-release-1.1.1.16-1.el5.noarch.rpm
    RHEL / CentOS 6 (64-bit) rpm -Uvh http://public-repo-1.hortonworks.com/HDP-1.1.1.16/repos/centos6/hdp-release-1.1.1.16-1.el6.noarch.rpm
  2. Install Extra Packages for Enterprise Linux (EPEL) with the following: 
    yum install epel-release
  3. ** RHEL / CentOS 5 HMC Server installs only **. Install the “PHP Extension Community Library for JSON” with the following: 
    yum install php-pecl-json
  4. Install HMC using the following: 
    yum install hmc
  5. Confirm HMC is installed by querying hmcfrom the RPM list with the following: 
    rpm -qa | grep hmc
  6. Start the HMC service. You will be prompted to agree to the Oracle Java License and download the binaries: 
    service hmc start
  7. Stop the firewall with the following: 
    /etc/init.d/iptables stop
  8. Proceed to Provisioning Your Cluster.

Provisioning Your Cluster

  1. Be sure you have performed steps in the Pre-Flight Operations Checklist and confirm you have your Host names text file and HMC Server SSH Private Key file handy.
  2. Browse to HMC start page: 
    http://{your.hmc.server}/hmc/html
  3. Click the “Get Started” button.
  4. Follow the wizard instructions to provision your cluster.

Additional Resources

Learn more about our products, Hadoop and participate in the community with the following resources: