AMI launch

Scott Sievert edited this page Feb 21, 2018 · 2 revisions

The purpose of this guide is take users with no prior experience in Amazon's AWS/EC2 cloud infrastructure from zero to running experiments with NEXT on an EC2 machine.

There are five steps:

For the first three steps, Amazon also provide their own getting started guide, so users seeking further detail on EC2-specific topics should look there.

Quickstart guide for users familiar with EC2

  • Create (or otherwise possess):
  • An AWS account
  • An AWS access key ID, AWS secret key (needed after NEXT starts)
  • A named AWS keypair
  • Start an EC2 machine with the following specifications:
  • Amazon machine image (AMI) with the ID specified here
  • Machine type c3.8xlarge or better
  • At least 100 GB of storage
  • Ports 80 and 8000 open to the world (or to only the IPs of every computer you want to allow, if you know these in advance and care about this)

Create an Amazon AWS account

  1. Go to http://aws.amazon.com/ and click Sign Up.

  2. Follow the on-screen instructions until you are logged into the AWS console.

Create an access key

  1. Go to the Security Credentials in the dropdown under your name.

    Imgur

  2. Click on the Access Keys (Access Key ID and Secret Access Key) tab.

    Imgur

  3. Click the create new access key button. In the corresponding pop-up, click show access keys. Write your Access Key ID and Secret Access Key down or save them to a secure location for later reference.

Start NEXT on EC2

  1. Go to the AWS EC2 console. If you are somewhere in the console, return to the main page by clicking the orange cube at the top left and then click "EC2" on the main menu page (should be around the top left).

  2. Click on the Launch Instance button

    Imgur

  3. Select Oregon as the region in which to launch (otherwise the AMI can't be found)

    Imgur

  4. Select Community AMIs on the left-side panel and use the search box to search for the AMI ID show below. Once you find it, click Select on the right.

    Imgur

    • Be sure to find the AMI with the ID ami-36a00c56. This AMI pulls the latest release of NEXT.
  5. Select a machine type to suit your needs. Active learning experiments require a lot of computation resources. We recommend at least type c4.8xlarge which has 32 cores and 60GB of memory if you plan on running an experiment that has a large number of participants. Then click Next: Configure Instance Details.

    Imgur

  6. If money is no object for you, click Next: Add storage. Otherwise, there is a potentially cheaper option accessible from this screen, but with several caveats. To read about this and its potential ramifications, click here. Click on Next: Add Storage

    Imgur

  7. Expand the root volume to at least 100 GB by locating the box under "Size (GiB)" and placing in there a value at least 100. Then click Next: Tag instance

    Imgur

  8. Give your instance a name (what name you choose isn't particularly important, but make it different from any other instances you have created). Then click Next: Configure Security Group

    Imgur

  9. Click Add Rule twice. In the Port Range boxes for the two new rules, enter 80 in the first, and 8000 in the second. Make sure the Source says Anywhere (unless you know what you are doing, in which case populate the sources with the subnet you wish to grant access). Then click Review and Launch. Of you left your source as "Anywhere" a warning may appear about your permissions. This is expected and not problematic.

    Imgur

  10. Click Launch. In the dialog that appears, select Create a new key pair. Name this key pair and download it. Do not lose or share the downloaded file! Once you have downloaded it, click Launch Instances.
    Imgur Imgur

  11. Click View Instances button.

  12. Locate the instance by name in the list of instances that comes up and click it. This will bring up the instance details in the lower panel. In particular, the text after Public DNS is the URL of the machine. Copy this and paste it into a new browser tab to see your NEXT dashboard. This may take up to 20 minutes to come online after the instance indicates a status of "Running".

Imgur

  1. If your dashboard is not coming up and you have waited a good 20 minutes, right-click your instance in the instance list on the AWS console and select Reboot

Imgur