Cloudera Manager and CDH QuickStart Guide

This quick start guide describes how to quickly create a new installation of Cloudera Manager 5, CDH 5, and managed services on a cluster of four hosts. The resulting deployment can be used for demonstrations and proof-of-concept applications, but is not recommended for production.

• QuickStart Cluster Host Requirements
• Download and Run the Cloudera Manager Server Installer
• On RHEL 5 and CentOS 5, Install Python 2.6 or 2.7
• Start the Cloudera Manager Admin Console
• Install and Configure Software Using the Cloudera Manager Wizard
  • Choose Cloudera Manager Edition and Specify Hosts
  • Install CDH and Managed Service Software
  • Add and Configure Services
  • Running a MapReduce Job
  • Testing with Hue

  QuickStart Cluster Host Requirements

  • The hosts must have at least 10 GB RAM.
  • You must have root or password-less sudo access to the hosts.
  • If using root, the hosts must accept the same root password.
  • The hosts must have Internet access to allow the wizard to install software from archive.cloudera.com .
  • Run a supported OS:
    • See CDH 5 and Cloudera Manager 5 Requirements and Supported Versions.
    • SLES - SUSE Linux Enterprise Server 11, 64-bit. Service Pack 2 or higher is required. The Updates repository must be active and SUSE Linux Enterprise Software Development Kit 11 SP1 is required.
    • Debian - Wheezy (7.0 and 7.1), 64-bit.
    • Ubuntu - Trusty (14.04) and (Precise) 12.04, 64-bit.

    Download and Run the Cloudera Manager Server Installer

    1. Open Cloudera Manager Downloads in a web browser.
    2. In the Cloudera Manager box, click Download Now .
    3. Click Download Cloudera Manager to download the most recent version of the installer or click Select a Different Version to download an earlier version. The product interest dialog box displays.
    4. Click Sign in and enter your email address and password or complete the product interest form and click Continue . The Cloudera Standard License page displays.
    5. Accept the license agreement and click Submit . The Automated Installation instructions display. You can also view system requirements and release notes, and you can go to the documentation.
    6. Download the installer:

    $ wget https://archive.cloudera.com/cm5/installer/latest/cloudera-manager-installer.bin

    $ chmod u+x cloudera-manager-installer.bin

    Install Cloudera Manager packages from the Internet:

    $ sudo ./cloudera-manager-installer.bin

    $ sudo ./cloudera-manager-installer.bin --skip_repo_package=1

    1. The installer installs the Oracle JDK and the Cloudera Manager repository files.
    2. The installer installs the Cloudera Manager Server and embedded PostgreSQL packages.
    3. The installer starts the Cloudera Manager Server and embedded PostgreSQL database.

    Note: If the installation is interrupted, you may need to clean up before you can re-run it. See Uninstalling Cloudera Manager and Managed Software.

    On RHEL 5 and CentOS 5, Install Python 2.6 or 2.7

    CDH 5 Hue works only with the default system Python version of the operating system it is being installed on. For example, on RHEL/CentOS 6, you need Python 2.6 to start Hue.

    To install packages from the EPEL repository, download the appropriate repository RPM packages to your machine and then install Python using yum . For example, use the following commands for RHEL 5 or CentOS 5:

    $ su -c 'rpm -Uvh http://download.fedoraproject.org/pub/epel/5/i386/epel-release-5-4.noarch.rpm' . $ yum install python26

    Start the Cloudera Manager Admin Console

    1. Wait several minutes for the Cloudera Manager Server to start. To observe the startup process, run tail -f /var/log/cloudera-scm-server/cloudera-scm-server.log on the Cloudera Manager Server host. If the Cloudera Manager Server does not start, see Troubleshooting Installation and Upgrade Problems.
    2. In a web browser, enter http:// Server host :7180 , where Server host is the FQDN or IP address of the host where the Cloudera Manager Server is running. The login screen for Cloudera Manager Admin Console displays.
    3. Log into Cloudera Manager Admin Console with the credentials: Username: admin Password: admin .
    4. After you log in, the Cloudera Manager End User License Terms and Conditions page displays. Read the terms and conditions and then select Yes to accept them.
    5. Click Continue . The Welcome to Cloudera Manager page displays.

    Install and Configure Software Using the Cloudera Manager Wizard

    Installing and configuring Cloudera Manager, CDH, and managed service software on the cluster hosts involves the following main steps.

    • Choose Cloudera Manager Edition and Specify Hosts
    • Install CDH and Managed Service Software
    • Add and Configure Services

    Choose Cloudera Manager Edition and Specify Hosts

    1. Choose Cloudera Enterprise Enterprise Data Hub Edition Trial, which does not require a license, but expires after 60 days and cannot be renewed. The trial allows you to create all CDH and managed services supported by Cloudera Manager. Click Continue .
    2. Information is displayed indicating which edition of Cloudera Manager will be installed and the services you can choose from. Click Continue . The Specify hosts for your CDH cluster installation screen displays.
    3. Specify the four hosts on which to install CDH and managed services. You can specify hostnames or IP addresses and ranges, for example: 10.1.1.[1-4] or host[1-3].company.com. You can specify multiple addresses and address ranges by separating them by commas, semicolons, tabs, or blank spaces, or by placing them on separate lines.
    4. Click Search. Cloudera Manager identifies the hosts on your cluster. Verify that the number of hosts shown matches the number of hosts where you want to install services. Clear host entries that do not exist and clear the hosts where you do not want to install services. Click Continue . The Select Repository screen displays.

    Install CDH and Managed Service Software

    1. Keep the default distribution method Use Parcels and the default version of CDH 5. Leave the Additional Parcels selections at None.
    2. For the Cloudera Manager Agent, keep the default Matched release for this Cloudera Manager Server. Click Continue . The JDK Installation Options screen displays.
    3. Select the Install Oracle Java SE Development Kit (JDK) checkbox to allow Cloudera Manager to install the JDK on each cluster host or uncheck if you plan to install it yourself. Leave the Install Java Unlimited Strength Encryption Policy Files checkbox cleared. Click Continue . The Enable Single User Mode screen displays.
    4. Leave the Single User Mode checkbox cleared and click Continue . The Provide SSH login credentials page displays.
    5. Specify host SSH login properties:
       1. Keep the default login root or enter the username for an account that has password-less sudo permission.
       2. If you choose to use password authentication, enter and confirm the password.

       Add and Configure Services

       1. Select All Services to create HDFS, YARN (includes MapReduce 2), ZooKeeper, Oozie, Hive, Hue, Sqoop, HBase, Impala, Solr, Spark, and Key-Value Store Indexer services. Click Continue . The Customize Role Assignments screen displays.
       2. Configure the following role assignments:
          • Click the text field under the HBase Thrift Server role. In the host selection dialog box that displays, select the checkbox next to any host and click OK at the bottom right.
          • Click the text field under the Server role of the ZooKeeper service. In the host selection dialog box that displays, uncheck the checkbox next to the host assigned by default (the master host) and select checkboxes next to the remaining three hosts. Click OK at the bottom right.
          Click Continue . The Database Setup screen displays.
       3. Leave the default setting of Use Embedded Database to have Cloudera Manager create and configure all required databases in an embedded PostgreSQL database. Click Test Connection. When the test completes, click Continue . The Review Changes screen displays.
       4. Review the configuration changes to be applied. Click Continue . The Command Progress page displays.
       5. The wizard performs 32 steps to configure and starts the services. When the startup completes, click Continue .
       6. A success message displays indicating that the cluster has been successfully started. Click Finish to proceed to the Home > Status tab.

       Test the Installation

       The Home > Status tab looks something like this:
       

       

       On the left side of the screen is a list of services currently running with their status information. All the services should be running with Good Health , however there may be a small number of configuration warnings indicated by a wrench icon and a number , which you can ignore.

       You can click each service to view more detailed information about the service. You can also test your installation by running a MapReduce job or interacting with the cluster with a Hue application.

       Running a MapReduce Job

       1. Log into a cluster host.
       2. Run the Hadoop PiEstimator example:

       sudo -u hdfs hadoop jar \ /opt/cloudera/parcels/CDH/lib/hadoop-mapreduce/hadoop-mapreduce-examples.jar \ pi 10 100

       

       Testing with Hue

       1. In the Cloudera Manager Admin Console Home > Status tab, click the Hue service.
       2. Click the Hue Web UI link, which opens Hue in a new window.
       3. Log in with the credentials, username: hdfs , password: hdfs .
       4. Choose an application in the navigation bar at the top of the browser window.

       For more information, see the Hue User Guide.