Download our CloudFormation template from https://s3.amazonaws.com/unraveldatarepo/unravel_aws_marketspace_01.json to your local /tmp folder.

Use AWS CLI or the AWS Marketplace console to create the Unravel EC2 instance:

From AWS CLI, run the aws cloudformation command with these parameters.

Syntax:

 aws cloudformation create-stack --stack-name UnravelEC2 \ 
--template-body file:///tmp/unravel_aws_marketspace_01.json \ 
--parameters ParameterKey=Zone,ParameterValue=AWS_ZONE_NAME \ 
ParameterKey=InstanceType,ParameterValue=AWS_INSTANCE_TYPE \ 
ParameterKey=KeyName,ParameterValue=my_ssh_key \ 
ParameterKey=UnravelVPCBlock,ParameterValue=AWS_VPC_BLOCK \ 
ParameterKey=TrustedSshIPBlock, ParameterValue=AWS_SSH_BLOCK \ 
--capabilities CAPABILITY_IAM | tee UnravelEC2-stack.json 

Example:

 aws cloudformation create-stack --stack-name UnravelEC2number \ 
--template-body file:///tmp/unravel_aws_marketspace_01.json \ 
--parameters ParameterKey=Zone,ParameterValue=us-east-1d \ 
ParameterKey=InstanceType,ParameterValue=r4.2xlarge \ 
ParameterKey=KeyName,ParameterValue=topcat \ 
ParameterKey=UnravelVPCBlock,ParameterValue=10.12.0.0/16 \ 
ParameterKey=TrustedSshIPBlock, ParameterValue=0.0.0.0/0 \ 
--capabilities CAPABILITY_IAM | tee UnravelEC2-stack.json 

From AWS Marketplace (https://aws.amazon.com/marketplace):

1. Type unravel in the search box:

   

2. In the search results, select Unravel APM for EMR and click Continue to Subscribe.

   

3. Click Continue to Configuration.

4. On the Configure this software page, select the following:

   • Fulfillment Option: Unravel EC2 instance

   • Software Version: 4.5.0.5

   • Region: Select the region that matches your existing Amazon EMR.

5. Click Continue to Launch.

   

6. On the Launch this software page, click Usage Instructions to download the documentation for the Unravel EC2 instance.

7. In the Choose Action pull-down menu, select Launch CloudFormation.

8. Click Launch.

   You are now on the CloudFormation portal (https://console.aws.amazon.com/cloudformation/home)

9. In the Choose a template section, select Specify an Amazon S3 template URL, leave the default URL as is, and click Next.

   You are now on the Specify Details page on the CloudFormation portal.

10. On the Specify Details page, specify your settings for this EC2 instance, and click Next.

11. On the Options page, leave all settings as default and click Next.

12. On the Review page, accept the notice about IAM resources and click Create.

    The deployed application together with its virtual resources is called a CloudFormation "stack" and is named UnravelEC2number.

    Tip

    If you don't see your new stack in the list, wait 30-60 seconds and refresh the page.

When the status of the stack changes to CREATE_COMPLETE, select it and expand its Outputs section: From the AWS CloudFormation portal, click CloudFormation ? UnravelEC2number ? Outputs. Confirm that you see four keys listed in this section:

For example:

Get the public IP address and private IP address of this EC2 instance.

You can do this through aws CLI or through the EC2 console, (https://console.aws.amazon.com/ec2/).

To use aws CLI, run the ec2 describe-instances command using the value of the UnravelAutoScalingGroupId key shown in the Outputs tab/section above.

 AUTOSCALING_GROUP=UnravelAutoScalingGroupId_value_from_Outputs_tab 
 aws ec2 describe-instances --filters "Name=tag:aws:autoscaling:groupName,Values=$AUTOSCALING_GROUP" |grep PublicIpAddress |head -1 
 aws ec2 describe-instances --filters "Name=tag:aws:autoscaling:groupName,Values=$AUTOSCALING_GROUP" |grep PrivateIpAddress |head -1 

To use the EC2 console, highlight this EC2 instance and look at its IP addresses in its Description tab.

For example: