Skip to content

Latest commit

 

History

History
201 lines (179 loc) · 8.08 KB

Connecting_to_AWS_lab.md

File metadata and controls

201 lines (179 loc) · 8.08 KB
Raw

Connecting to AWS

Introduction

This lab guides you through the steps involved in connecting to an AWS EC2 F1 instance, and starting and stopping the instance.

Objectives

After completing this lab, you will be able to:

  • Connect to an AWS EC2 F1 instance using the provided credentials
  • Start an instance
  • Start a RDP (Remote Desktop Protocol) session
  • Close the RDP session
  • Stop the instance

Steps

Each registered participant has been allocated a pre-configured EC2 F1 instance and should have received an email with the following details:

  • Account ID,
  • IAM username,
  • Link to access a pre-configured EC2 F1 instance

Login into the AWS and starting an F1 instance

  1. Start a web browser session
  2. Either click on the provided link to open up an AWS login page OR enter https://console.aws.amazon.com/ec2 to open a login page
    If you had used the link then you should see a login page similar to shown here:

    Login page accessed through the provided link

    If you had not used the link you may be directed to the AWS standard login page

    Entering credentials manually

    Enter xilinx-aws-f1-developer-labs in the Email address field and click Next to see the login page similar to shown in figure titled: Login page accessed through the provided link
  3. Enter userxx in the IAM user name field and enter the provided password in the Password field
  4. Click Sign In
  5. In the top right corner, using the drop-down button, select a region with F1 instances, such as N. Virginia (US East) or instructor indicated region

    Selecting a region

    If you select different region other then where the accounts are created for then you may not see your instance as well as the source files which are pre-loaded for the workshop.
  6. Click on the EC2 link on the dashboard or if not visible, then click on the Services drop-down button and then click on EC2

    Accessing EC2 service

  7. Click on the Instances link on the left panel

    Accessing Instances

    You may see several instances
  8. Enter your username in the filter field just below the Launch Instance button and hit enter

    Filtering your instance

  9. Making sure that your instance is selected, click on the Actions > Instance State > Start

    Starting an instance

  10. Click on the Yes, Start button
  11. Click on the refresh button(alt tag) to see the updated status to Running

    Running state

  12. Make a note of the Public DNS and IPv4 Public IP which will be used by PuTTy and Remote Desktop (RDP)

    Assigned IP to the running instance

Interacting with the Instance using RDP

You can communicate with the instance using command line through PuTTY or Git Bash, and using GUI through remote desktop (RDP) connection.

  1. Start a remote desktop session
  2. Enter the IPv4 address
  3. Click on the Show Options

    Entering the IPv4 address

  4. Select the Display tab and select True Color (24 bit) and click Connect

    Selecting resolution and connecting

  5. A certificate warning will be displayed. Click Yes to open the RDP session
  6. Enter centos as the username and enter the provided password and click OK

    Entering username and password

  7. Right-click on the desktop and select Open Terminal to open a window
  8. You should enter the following commands in any newly opened terminal window to source the environments 
       cd ~/aws-fpga	  
   source sdaccel_setup.sh	  
   source $XILINX_SDX/settings64.sh

Stopping the Instance and Signing Out

It is important to shut down the instance in order to stop billing meter. You do not need to execute this command in this lab as you will continue the session for the subsequent labs

  1. Type the following command to terminate the RDP session and shutdown the instance

       sudo shutdown now

  2. Check the browser window, you will see status as either Stopping or Stopped. Click on the refresh button to see the status update

    Instance Status

  3. Once the instance is stopped, sign out by clicking on the drop-down button on the top bar and selecting Sign Out

    Signing out

Conclusion

In this lab, you learned how to connect to an AWS EC2 F1 instance, interact with the instance using RDP connection, how to stop the instance, and sign out.

Start the next lab: 2. Makefile Flow

Appendix: Interacting with the Instance using Putty

  1. Start PuTTY program
  2. Enter centos@<public_dns_entry> in the Host Name field and 22 in the Port field
    Make sure that SSH is selected as the Connection type

    Session settings in PuTTY

  3. Expand SSH under the Connection in the left panel and click Auth
  4. Click on the Browse… button, browse to where the private key has been stored
    If you don't have the private key file (as in workshop) you can skip this step
  5. Click Open

    Selecting private key file

  6. Click Yes
    The PuTTY window will open. It will ask for the password (in case of the workshop). Enter the provided password

    The PuTTY window showing the connection

  7. Set password for the RDP connection by entering sudo passwd <your choice of password> command. You will use the same password in the RDP connection.
  8. Enter exit to close the session