***

## description: Getting Started with AWS AMI

# Getting Started on AWS

You can use the HEAVY.AI AWS AMI (Amazon Web Services Amazon Machine Image) to try HeavyDB and Heavy Immerse in the cloud. Perform visual analytics with the included New York Taxi database, or import and explore your own data.

Many options are available when deploying an AWS AMI. These instructions skip to the specific tasks you must perform to deploy a sample environment.

## Prerequisite

You need a security key pair when you launch your HEAVY.AI instance. If you do not have one, create one before you continue.

1. Go to the EC2 Dashboard.
2. Select **Key Pairs** under **Network & Security**.
3. Click **Create Key Pair**.
4. Enter a name for your key pair. For example, `MyKey`.
5. Click **Create**. The key pair PEM file downloads to your local machine. For example, you would find `MyKey.pem` in your `Downloads` directory.

## Launching Your Instance

1. Go to the [AWS Marketplace page for HEAVY.AI](https://aws.amazon.com/marketplace/seller-profile?id=f9f40dff-9943-4d95-8437-8414612724c6) and select the version you want to use. You can get overview information about the product, see pricing, and get usage and support information.
2. Click **Continue to Subscribe** to subscribe.
3. Read the Terms and Conditions, and then click **Continue to Configuration**.
4. Select the **Fulfillment Option**, **Software Version**, and **Region**.
5. Click **Continue to Launch**.
6. On the Launch this software page, select **Launch through EC2**, and then click **Launch**.
7. From the Choose and Instance Type page, select an available EC2 instance type, and click **Review and Launch**.
8. Review the instance launch details, and click **Launch**.
9. Select a **key pair**, or click **Create a key pair** to create a new key pair and download it, and then click **Launch Instances**.
10. On the Launch Status page, click the instance name to see it on your EC2 Dashboard Instances page.

## Using HEAVY.AI Immerse on Your AWS Instance

To connect to Heavy Immerse, you need your Public IP address and Instance ID for the instance you created. You can find these values on the Description tab for your instance.

To connect to Heavy Immerse:

1. Point your Internet browser to the public IP address for your instance, on port 6273. For example, for public IP `54.83.211.182`, you would use the URL `https://54.83.211.182:6273`.
2. If you receive an error message stating that the connection is not private, follow the prompts onscreen to click through to the unsecured website. To secure your site, see [Tips for Securing Your EC2 Instance](https://aws.amazon.com/articles/1233).
   1. Enter the **USERNAME** (admin), **PASSWORD** (Instance ID), and **DATABASE** (heavyai). If you are using the BYOL version, enter you license key in the key field and click **Apply**.
3. Click **Connect**.
4. On the **Dashboards** page, click **NYC Taxi Rides**. Explore and filter the chart information on the NYC Taxis Dashboard.

For more information on Heavy Immerse features, see [Introduction to Heavy Immerse](/immerse/introduction-to-immerse).

## Importing Your Own Data

Working with your own familiar dataset makes it easier to see the advantages of HEAVY.AI processing speed and data visualization.

To import your own data to Heavy Immerse:

1. Export your data from your current datastore as a comma-separated value (CSV) or tab-separated value (TSV) file. HEAVY.AI supports Latin-1 ASCII format and UTF-8. If you want to load data with another encoding (for example, UTF-16), convert the data to UTF-8 before loading it to HEAVY.AI.
2. Point your Internet browser to the public IP address for your instance, on port 6273. For example, for public IP `54.83.211.182`, you would use the URL `https://54.83.211.182:6273`.
3. Enter the **USERNAME** (admin) and **PASSWORD** ( `{instance ID}` ). If you are using the BYOL version, enter you license key in the key field and click **Apply**.
4. Click **Connect**.
5. Click **Data Manager**, and then click **Import Data**.
6. Drag your data file onto the table importer page, or use the directory selector.
7. Click **Import Files**.
8. Verify the column names and datatypes. Edit them if needed.
9. Enter a **Name** for your table.
10. Click **Save Table**.
11. Click **Connect to Table**.
12. On the **New Dashboard** page, click **Add Chart**.
13. Choose a chart type.
14. Add dimensions and measures as required.
15. Click **Apply**.
16. Enter a **Name** for your dashboard.
17. Click Save.

For more information, see [Loading Data](/tutorials-and-demos/loading-data).

## Accessing Your HEAVY.AI Instance Using SSH

Follow these instructions to connect to your instance using SSH from MacOS or Linux. For information on connecting from Windows, see [Connecting to Your Linux Instance from Windows Using PuTTY](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/putty.html).

1. Open a terminal window.
2. Locate your private key file (for example, MyKey.pem). The wizard automatically detects the key you used to launch the instance.
3. Your key must not be publicly viewable for SSH to work. Use this command to change permissions, if needed:
4. Connect to your instance using its Public DNS. The default user name is `centos` or `ubuntu`, depending on the version you are using. For example:

   ```
   ssh -i MyKey.pem centos@ec2-12-345-678-901.us-west-2.compute.amazonaws.com
   ```
5. Use the following command to run the heavysql SQL command-line utility on HeavyDB. The default user is `admin` and the default password is `{Instance ID}`:

   ```
   $HEAVYAI_PATH/bin/heavysql
   ```

   For more information, see [heavysql](/apis-and-interfaces/heavysql).