> For the complete documentation index, see [llms.txt](https://niagads.gitbook.io/vcpa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://niagads.gitbook.io/vcpa/step-2-create-your-tracking-database-instance/option-1-setup-sample-tracking-database-using-public-ami-recommended.md).

# Option 1: Setup sample tracking database using Public AMI (recommended)

Using public AMI to setup the tracking database is easier, as the Starcluster is already pre-installed. Below are the step-by-step guide:

#### 1) click "**EC2 Dashboard**" on your right. Then click "Launch instance" in blue to launch AMI 

![Launch instance](https://2340481123-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LDqjkDfgAQAY9Hn5Vg6%2F-LDrKRjDlaYpOqRftBmo%2F-LDrKdaFtOm3_vgrYU5l%2Fami1.png?alt=media\&token=b020a903-dac4-4e49-9e8c-97e5134f8e2a)

#### 2) Click "**Community AMIs**" on the left panel, then type in "ami-acc840d3" in the search box. Then click select.

![Community AMIs(ami-acc840d3)](https://2340481123-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LDqjkDfgAQAY9Hn5Vg6%2F-LDwW6R8OnasguHwNjyK%2F-LDwWEpntskZ98OVfg1M%2Fami2.png?alt=media\&token=05bc7d1b-64f5-42df-b5f6-fe511b4c3e8c)

#### 3) Next, choose the appropriate instance - we recommend using t2.micro for the tracking database of VCPA; as this is only used for hosting the database and submitting jobs. Click "**Next: Configure Instance Details**" on the bottom right hand corner to proceed.

![Instance Type](https://2340481123-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LDqjkDfgAQAY9Hn5Vg6%2F-LDrKRjDlaYpOqRftBmo%2F-LDrL32pBlw08U19nYRV%2Fami3.png?alt=media\&token=556d4886-581a-4e86-adb7-0d879a4f3922)

#### 4) Click "**Next: Add Storage**" on the bottom right hand corner to proceed.

![Configure Instance Details](https://2340481123-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LDqjkDfgAQAY9Hn5Vg6%2F-LDrKRjDlaYpOqRftBmo%2F-LDrLBAJsiY0l6K7XQxA%2Fami4.png?alt=media\&token=47ba8be0-b56e-4c56-965c-a3a11748735e)

#### 5) Click "**Next: Add Tags**" on the bottom right hand corner to proceed.

![Storage](https://2340481123-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LDqjkDfgAQAY9Hn5Vg6%2F-LDrKRjDlaYpOqRftBmo%2F-LDrLSkO7l_meI11DUQJ%2Fami5.png?alt=media\&token=9ba133b7-6de6-432e-91cf-2712af7050ed)

#### 6) Click "**Next: Configure Security Group**" on the bottom right hand corner to proceed.

![Tags](https://2340481123-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LDqjkDfgAQAY9Hn5Vg6%2F-LDrKRjDlaYpOqRftBmo%2F-LDrLcm-wiYTQ0rdwyY0%2Fami6.png?alt=media\&token=6793907a-c10a-4dab-9c45-7209688cc79d)

#### 7) Then open the **public web port.** Users need to configure the security group like "**SSH**" and "**HTTP**". Click "Review and Launch" on the bottom right hand corner to proceed.

![Configure Security Group](https://2340481123-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LDqjkDfgAQAY9Hn5Vg6%2F-LDrKRjDlaYpOqRftBmo%2F-LDrLlivHYeA1lsD35OH%2Fami7.png?alt=media\&token=595224e0-7b4c-4fe4-8064-89c768c4cb78)

#### 8) Click "**Launch**" on the bottom right hand corner to proceed.

![Review Instance Launch](https://2340481123-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LDqjkDfgAQAY9Hn5Vg6%2F-LDrKRjDlaYpOqRftBmo%2F-LDrM2fnFGKb0sDHvCmY%2Fami8.png?alt=media\&token=759ff8c2-f3c2-4739-9f78-acf460e4e2f6)

#### 9) Finally, users can view the the Public DNS/ Public IP information. An example is shown in the "**right box**" in the figure below:

![](https://2340481123-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LDqjkDfgAQAY9Hn5Vg6%2F-LDrKRjDlaYpOqRftBmo%2F-LDrMDD5FD2MULA_3iV2%2Fami10.png?alt=media\&token=6c2f6a45-0886-4a2b-bbfc-7150b9ae916e)

#### Users can then use this DNS/IP information to view the webpage of the tracking database by this *`URL: DNS/v1/projects`*, where users need to specify their own DNS/IP information. See figure below for an example:

![URL: DNS/v1/projects](https://2340481123-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LDqjkDfgAQAY9Hn5Vg6%2F-LDrKRjDlaYpOqRftBmo%2F-LDrMS7wu4vJaqhe1ixk%2Fami11.png?alt=media\&token=5776032c-ddd0-44cc-b726-249ff5fe0772)

Alternatively, users can also view the webpage of the tracking database by the URL: "[http://IP/v1/projects](http://ip/v1/projects)", where IP is the public IP information.

{% hint style="success" %}
**After the server / instance is setup, users need to login to this tracking database server to configure the projects / samples information and submit jobs. Details will be discussed in Steps 3-6 of the gitbook documentation.**
{% endhint %}

#### **1) Please fill in your \[your\_ssh\_key.pem], \[DNS/Public\_IP].**

```
  $ssh -i ~/.ssh/[your_ssh_key.pem] ubuntu@[DNS/Public_IP]
  Are you sure you want to continue connecting (yes or no)? yes
  Welcome to Ubuntu 16.04.4 LTS (GNU/Linux 4.4.0-1052-aws x86_64)
```

#### **2) Please add your** **\[AWS\_ACCESS\_KEY\_ID], \[AWS\_SECRET\_ACCESS\_KEY].**

```
 $ sudo nano /var/www/seq-processing/.env
```