3.1.2. Instructions

  1. Use a workstation with access to the Internet and download the tarball image of the appropriate Hortonworks yum repository.

    Table 4.3. Deploying HDP - Option I
    Cluster OS HDP Repository Tarballs

    RHEL/ CentOS 5.x

    • HDP Repository:

      wget http://public-repo-1.hortonworks.com/HDP-1.2.0/repos/centos5/HDP-1.2.0-centos5.tar.gz
    • HDP-Utils Repository:

      wget http://public-repo-1.hortonworks.com/HDP-UTILS-1.1.0.15/repos/centos5/HDP-UTILS-1.1.0.15-centos5.tar.gz
    • Ambari Repository (Optional):

      wget http://public-repo-1.hortonworks.com/ambari/centos5/ambari-1.2.2.3-centos5.tar.gz

    RHEL/ CentOS 6.x

    • HDP Repository:

      wget http://public-repo-1.hortonworks.com/HDP-1.2.0/repos/centos6/HDP-1.2.0-centos6.tar.gz
    • HDP-Utils Repository (Optional):

      wget http://public-repo-1.hortonworks.com/HDP-UTILS-1.1.0.15/repos/centos6/HDP-UTILS-1.1.0.15-centos6.tar.gz
    • Ambari Repository (Optional):

      wget http://public-repo-1.hortonworks.com/ambari/centos6/ambari-1.2.2.3-centos5.tar.gz

    SLES 11

    • HDP Repository:

      wget http://public-repo-1.hortonworks.com/HDP-1.2.0/repos/suse11/HDP-1.2.0-suse11.tar.gz
    • HDP-Utils Repository (Optional):

      wget http://public-repo-1.hortonworks.com/HDP-UTILS-1.1.0.15/repos/suse11/HDP-UTILS-1.1.0.15-suse11.tar.gz
    • Ambari Repository (Optional):

      wget http://public-repo-1.hortonworks.com/ambari/suse11/ambari-1.2.2.3-centos5.tar.gz

    [Note]Note

    The EPEL repository is not available as a tarball currently. Use one of Options II through IV to provide access to the EPEL repository.

  2. Create an HTTP server.

    • On the mirror server, install an HTTP server (such as Apache httpd) using the instructions provided here.

    • Activate this web server.

    • Ensure that the firewall settings (if any) allow inbound HTTP access from your cluster nodes to your mirror server.

      [Note]Note

      If you are using EC2, make sure that SELinux is disabled.

  3. On your mirror server, create a directory for your web server.

    • For example, from a shell window, type:

      • For RHEL/CentOS: mkdir –p /var/www/html/hdp/

      • For SLES: mkdir –p /srv/www/htdocs/rpms

    • If you are using a symlink, enable the followsymlinks on your web server.

  4. Copy the HDP Repository Tarballs to the directory created in step 3, and untar these tarballs.

  5. Verify the configuration.

    • The configuration is successful, if you can access the above directory through your web browser.

      To test this out, browse to the following URLs:

      • HDP Repository:

        http://yourwebserver/hdp/HDP-1.2.0/repos/$os
      • HDP-Utils Repository (Optional):

        http://yourwebserver/hdp/HDP-UTILS-1.1.0.15/repos/$os
      • Ambari Repository (Optional):

        http://yourwebserver/hdp/ambari/$os/1.x/GA

      where, $os can be centos5, centos6, or suse11.

      For each repository, you should see directory listing for the HDP or HDP-UTILS, or Ambari components along with the RPMs.

  6. Configure the yum or zypper clients on all the nodes in your cluster.

    1. Fetch the yum configuration file from your mirror server.

      • HDP Repository:

        http://yourwebserver/hdp/HDP-1.2.0/repos/$os/hdp.repo
      • HDP-Utils Repository (Optional):

        http://yourwebserver/hdp/HDP-UTILS-1.1.0.15/repos/$os/hdp-utils.repo
      • Ambari Repository (Optional):

        http://yourwebserver/hdp/ambari/$os/1.x/GA

      where, $os can be centos5, centos6, or suse11.

    2. Store the repo file(s) in a temporary location.

    3. Edit the repo file(s), changing the value of the baseurl property to the local mirror URL.

      • Edit the /etc/yum.repos.d/hdp.repo file changing the baseurl property as shown below:

        http://yourwebserver/hdp/HDP-1.2.0/repos/$os/hdp.repo
      • Edit the /etc/yum.repos.d/hdp-utils.repo file changing the baseurl property as shown below:

        http://yourwebserver/hdp/HDP-UTILS-1.1.0.15/repos/$os/hdp-utils.repo
      • Edit the /etc/yum.repos.d/ambari.repo file changing the baseurl property as shown below:

        [ambari-1.x]
        name=Ambari 1.x
        baseurl=http://yourwebserver/hdp/ambari/$os/1.x/GA/ambari.repo
        gpgcheck=1
        gpgkey=//public-repo-1.hortonworks.com/ambari/centos5/RPM-GPG-KEY/RPM-GPG-KEY-Jenkins
        enabled=1
        priority=1
        
        [HDP-UTILS-1.1.0.15]
        name=Hortonworks Data Platform Utils Version - HDP-UTILS-1.1.0.15
        baseurl=http://yourwebserver/HDP-UTILS-1.1.0.15/repos/centos5
        gpgcheck=0
        gpgkey=//public-repo-1.hortonworks.com/ambari/centos5/RPM-GPG-KEY/RPM-GPG-KEY-Jenkins
        enabled=1
        priority=1
        
        [Updates-ambari-1.x]
        name=ambari-1.x - Updates
        baseurl=http://yourwebserver/ambari/centos5/1.x/updates
        gpgcheck=1
        gpgkey=//public-repo-1.hortonworks.com/ambari/centos5/RPM-GPG-KEY/RPM-GPG-KEY-Jenkins
        enabled=1
        priority=1
        

      where, $os can be centos5, centos6, or suse11.

    4. Copy the yum/zypper client configuration file to all nodes in your cluster.

      • For RHEL and CentOS: Use scp or pdsh to copy the client yum configuration file to /etc/yum.repos.d/ directory on every node in the cluster.

      • For SLES:

        1. Store the repo file(s) back into the repository location in the web server.

          • Store the /etc/yum.repos.d/hdp.repo file:

            cp /tmp/hdp.repo /srv/www/htdocs/rpms/hdp/HDP-1.2.0/repos/suse11
          • Store the /etc/yum.repos.d/hdp-utils.repo file:

            cp /tmp/hdp-utils.repo /srv/www/htdocs/rpms/hdp/HDP-UTILS-1.1.0.15/repos/suse11
          • Store the /etc/yum.repos.d/ambari.repo file:

            cp /tmp/ambari.repo /srv/www/htdocs/rpms/hdp/ambari/suse11/1.x/GA

        2. On every node, invoke the following command:

          • HDP Repository:

            zypper addrepo -r http://yourwebserver/hdp/HDP-1.2.0/repos/suse11/hdp.repo
          • HDP-Utils Repository (Optional):

            zypper addrepo -r http://yourwebserver/hdp/HDP-UTILS-1.1.0.15/repos/suse11/hdp-utils.repo
          • Ambari Repository (Optional):

            zypper addrepo -r http://yourwebserver/hdp/ambari/suse11/1.x/GA/ambari.repo

  7. If your cluster runs CentOS or RHEL, and if you have multiple repositories configured in your environment, deploy the following plugin on all the nodes in your cluster.

    1. Install the plugin.

      • For RHEL and CentOS v5.x

        yum install yum-priorities
      • For RHEL and CentOS v6.x

        yum install yum-plugin-priorities
    2. Edit the /etc/yum/pluginconf.d/priorities.conf file to add the following:

      [main]
      enabled=1
      gpgcheck=0