Deploying Cloudera Manager and CDH on AWS

To deploy Cloudera Manager and CDH on an AWS EC2 instance, begin by creating an environment. The environment defines common settings, like region and key pair, that Cloudera Director uses with AWS. While creating an environment, you are also prompted to deploy its first cluster.

To create an environment:

  1. Open a web browser and go to the private IP address of the instance you created in Launching an EC2 Instance for Cloudera Director. Include port 7189 in the address. For example: 
    http://192.0.2.0:7189
  2. In the Cloudera Director login screen, enter admin in both the Username and the Password fields.
  3. In the Cloudera Director Welcome screen, click Let's get started.

    This opens a wizard for adding an environment, Cloudera Manager, and a CDH cluster.

  4. In the Add Environment screen:
    1. Enter a name in the Environment Name field.
    2. Select Amazon Web Services (AWS) from the Cloud provider field.
    3. Enter your AWS credentials in the Access key ID and Secret access key fields.
    4. In the EC2 region field, select the same region in which your Cloudera Director instance was created.
      Sample image of the General Information and EC2 sections.

    5. In the SSH Credentials section:
      1. Enter ec2-user in the Username field.
      2. Copy the SSH private key you created in Launching an EC2 Instance for Cloudera Director in the Private key field.

      Sample image of the SSH Credentials section.

  5. Click Continue to add Cloudera Manager.
  6. In the Add Cloudera Manager screen:
    1. Enter a name for this deployment of Cloudera Manager in the Cloudera Manager name field.
    2. In the Instance Template field, click Select a Template if you already have one that you want to use, otherwise, click Create New Instance Template.

      The Create New Instance Template modal screen displays.


      Sample image of Add Cloudera Manager screen.

  7. In the Create New Instance Template modal screen:
    1. In the Instance Template name field, enter a name for the template.
    2. In the Instance type field, select m4.large or m4.xlarge.
    3. In the Image (AMI) ID field, enter the ID for the Amazon machine image (AMI) you chose in Launching an EC2 Instance for Cloudera Director, or find another AMI with a supported operating system.
    4. In the Tags field, add one or more tags to associate with the instance.
    5. In the Security group IDs field, enter the security group ID you set up in Creating a New Security Group.
    6. In the VPC subnet ID field, enter the ID of the VPC subnet that was created during VPC setup.
    7. Click Save changes.

    Sample image of Instance Template screen.

  8. In the Add Cloudera Manager screen, click Cloudera Manager Configurations.
  9. In the Cloudera Manager Configurations modal screen, set the heap size:
    1. In the Scope field, select Host Monitor and add firehose_heapsize and 1073741824 in the respective Name and Value fields.
    2. Click +.
    3. In the Scope field, select Service Monitor and add firehose_heapsize and 1073741824 in the respective Name and Value fields.
    4. Click Save Changes.

    Sample image of Cloudera Manager Configurations modal screen

  10. By default, the version of Cloudera Manager installed depends on the version of Cloudera Director you are using:
    • If you are using Cloudera Director 2.0, the latest released version of Cloudera Manager 5.5 is installed by default.
    To install a version of Cloudera Manager different than the default version, perform the following steps:
    1. In the Configurations section, check Override default Cloudera Manager repository.
    2. In the Repository URL field, enter the repository URL for the version of Cloudera Manager you want to install. Repository URLs for versions of Cloudera Manager 5 have the form http://archive.cloudera.com/cm5/ followed by the operating system, operating system major version, processor architecture, cm (for Cloudera Manager), and the Cloudera Manager major, minor, and (if applicable) maintenance release number. For example, for Cloudera Manager 5.5.4, the repository URL is http://archive.cloudera.com/cm5/redhat/7/x86_64/cm/5.5.4/.
    3. In the Repository Key URL field, enter the URL for the repository key. Repository key URLs have the same form as repository URLs except they end with the name of the key file instead of the Cloudera Manager version. For example, the repository key URL for any version of Cloudera Manager 5 on any supported version of Red Hat 7 is http://archive.cloudera.com/cm5/redhat/7/x86_64/cm/RPM-GPG-KEY-cloudera.
  11. In the Add Cloudera Manager screen, click Continue.
  12. At the Confirmation prompt, click OK to begin adding a cluster.
  13. On the Add Cluster screen:
    1. Enter a name for the cluster in the Cluster name field.
    2. Select the version of CDH to deploy in the Version field.
    3. Enter the version of CDH to deploy in the Version field or leave the default value. By default, the version of CDH installed depends on the version of Cloudera Director you are using:
      • If you are using Cloudera Director 2.0, the latest released version of CDH 5.5 is installed by default.
      To install a version of CDH different than the default version, perform the following steps:
      1. Enter the desired CDH version in the Version field of the Products section. For example, for CDH 5.4.8 enter 5.4.8.
      2. Scroll down to Configurations (optional) and expand the section.
      3. Click Override default parcel repositories.
      4. Enter the repository parcel URL for the version of CDH you want to install. Parcel URLs for versions of CDH 5 have the form http://archive.cloudera.com/cdh5/parcels/, followed by the major, minor, and (if applicable) maintenance release number. For example, the URL for CDH 5.4.8 is http://archive.cloudera.com/cdh5/parcels/5.4.8.
    4. In the Services section, select the services you want to install.
    5. In the Instance groups area, create a new template for the groups or for each group and the number of instances you want. If you want to use Spot instances for your workers group:
      1. In the Create New Instance Template modal screen, click Advanced Options.
      2. In the Spot bid (USD/hr) field, enter your Spot bid price.
      3. Click the Use Spot instances checkbox.
      4. Click Save Changes.

      Sample image of the Instance groups section.

  14. Click Continue.
  15. At the Confirmation prompt, click OK to deploy the cluster. Cloudera Director displays a status screen.
    Sample image of Status screen.

  16. When the cluster is ready, click Continue.

    You are finished with the deployment tasks.