Tutorial: How to Launch HDCloud Controller via AWS CLI

This tutorial shows you how to use the AWS Command Line Interface to launch the Hortonworks Data Cloud (HDCloud) for AWS cloud controller.

Overview

In this tutorial, we will use the AWS CLI to launch the HDCloud cloud controller. The steps include:

Meeting the prerequisites.

Subscribing to HDCloud AWS Marketplace services.

Launching cloud controller via AWS CLI (basic template).

Adding additional parameters if using the advanced template.

Our suggestion is that you first go through the launch process using the CloudFormation Management Console to get familiar with the procedure. Once you're comfortable with the launch process, you can automate via the AWS CLI. For instructions on how to launch using the UI, refer to the Launch Cloud Controller documentation.

Meet the Prerequisites

Log in to your AWS account. If you don’t have one, set it up and then generate or upload your SSH keypair.

Install and configure the AWS CLI tool. For links and instructions, refer to AWS documentation, including:

MY_KEY_NAME: Enter the name of your private SSH key used in the chosen regionMY_STACK_NAME: Choose a name for your stackMY_PASSWORD: Choose a passwordMY_EMAIL: Enter a valid email addressREMOTE_ACCESS: Specify a valid CIDR range. You can use this tool to calculate a valid CIDR range that includes your public IP address. Or, at your own risk, you can enter 0.0.0.0/0 to allow access from all.

The following parameters are optional. If you want to use default values, you can simply delete the lines that declare these parameters:

INSTANCE_TYPE: Default is m4.largeTELEMETRY: Default is “I Do Not Opt In to SmartSense Telemetry”. To opt in, use "I Have Read and Opt In to SmartSense Telemetry"

VPC_ID: ID of an existing VPCSUBNET_ID: ID of an existing subnet that is located within the specified VPCRDS_ENDPOINT: URL:PORT for your existing RDS instanceRDS_USER: RDS instance userRDS_PASSWORD: Password for your RDS instance userRDS_DB: Name of a database that exists on your RDS instance

Obtaining Template Link

In case you are trying to use a different version of HDCloud than the one described or you want to verify the template link, you can obtain the template link (that is the value of template-body) using the following steps: