BTF AMI Instructions

BTF AMI Instructions

Table of Contents

Setting up the EC2 instance from AMI

1Open the AMI section of the EC2 images page

Open the AMI section of the EC2 images page and make sure it points to the Ohio region (https://us-east-2.console.aws.amazon.com/ec2/v2/home?region=us-east-2#Images:visibility=private-images;sort=name)

2Select the Nucleaus AMI image

Under private images, please select the Nucleaus AMI image (alpine-3.11.6-x86_64-nucleaus-btf-dfd060b), creation date: May 8, 2020.

3Launch the instance

Launch it as a t2.large instance so that it has at least 8 GB of RAM, and configure the storage to be 40 GB SSD.

4Wait for initialization

Wait for it to initialize.

Obtaining the Nucleaus BTF Appliance ID

1Access the SSH login screen

The BTF appliance ID is shown on the initial SSH login screen. For security purposes, the only way to access the login screen is through an actual SSH connection only. For this, you will need to generate and download a .pem key associated with your AWS account, assigned to the EC2 instance.

2Open SSH connection

Open Terminal, and open an SSH connection to your EC2 instance, like so:

SSH Command 
ssh -i your-key.pem ec2-user@your-instance-ip

Note: You will not be able to actually log into your instance, as the image is locked down, but the BTF Appliance ID will be displayed.

Adding your BTF Appliance into the Nucleaus Console

1Navigate to Appliances

Under the top right drop down menu with your name on it, click to expand, and click on Appliances.

2Create Appliance

Click the Create Appliance button and enter the Appliance ID from the SSH session and a descriptor in the dialog.

3Wait for connection

Give it a minute for the appliance to start sending "alive" signals to the console.

4Configure repository

Edit or create any repo, and under BTF Options, select the newly added appliance in the dropdown, and click Save.