In order to run the SDAccel AWS F1 Developer Labs, you will need the following:
An AWS account (expand for details)
If you do not already have an Amazon Web Services (AWS) account, create one here: https://aws.amazon.com/
Access to AWS F1 instances (expand for details)
AWS users need to request access to use F1 instances. Here are the steps to do so:
- Open the Service Limit Increase form: http://aws.amazon.com/contact-us/ec2-request
- Make sure your account name is correct
- Submit a 'Service Limit Increase' for 'EC2 Instances'
- Select the region where you want to access F1 instances: US East (N.Virginia), US West (Oregon) or EU (Ireland)
- Select 'f1.2xlarge' as the primary instance type
- Set the 'New limit value' to 1 or more
- Fill the rest of the form as appropriate and click 'Submit'
Requests are typically processed in 24 to 48 hours.
The following steps explain how to launch an EC2 F1 instance starting from the FPGA Developer AMI and setting it up to connect via a remote desktop client.
- Navigate to the AWS Marketplace
- Click on Continue to Subscribe
- Accept the EULA and click Continue to Configuration
- Select version v1.8.x and a region with F1 instances: US East (N.Virginia), US West (Oregon) or EU (Ireland)
- Click on Continue to Launch
- Select Launch through EC2 in the Choose Action drop-down and click Launch
- Select f1.2xlarge Instance type
- At the top of the console, click on 4. Add Storage
- Set size of the Root Device to
100GiB
- At the top of the console, click on 6. Configure Security Groups
- Click Add Rule ( Note : Add a new rule dont modify existing rule )
- Select Custom TCP Rule from the Type pull-down menu
- Type
8443
in the Port Range field - Select Anywhere from the Source pull-down
- Click Review and Launch. This brings up the review page.
- Click Launch to launch your instance.
- Select a valid key pair and check the acknowledge box at the bottom of the dialog
- Select Launch Instances. This brings up the launch status page
- When ready, select View Instances at the bottom of the page
- When the status of the newly launched instance switches to green (Running), you are ready to connect to it.
- In the AWS EC2 dashboard, select your instance to display its information in the bottom pane
- Copy or write down the IPv4 Public IP address of the instance.
- Using that IP address, connect to your instance using SSH (Linux) or PuTTY (Windows)
ssh -i <AWS key pairs.pem> centos@<IPv4 Public IP of EC2 instance> 22
putty -i <AWS key pairs.ppk> -ssh centos@<IPv4 Public IP of EC2 instance> 22
- An ASCII art message welcomes you to your instance
Follow steps 1-3 from last section to get the IPv4 Public IP address of the instance. Then refer to the following instructions to connect using PuTTY: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/putty.html
The FPGA Developer AMI doesn't include a GUI Desktop, but you can set it up by running the following steps:
-
Install NICE DCV pre-requisites
sudo yum -y install kernel-devel sudo yum -y groupinstall "GNOME Desktop" sudo yum -y install glx-utils
-
sudo rpm --import https://s3-eu-west-1.amazonaws.com/nice-dcv-publish/NICE-GPG-KEY wget https://d1uj6qtbmh3dt5.cloudfront.net/2019.0/Servers/nice-dcv-2019.0-7318-el7.tgz tar xvf nice-dcv-2019.0-7318-el7.tgz cd nice-dcv-2019.0-7318-el7 sudo yum -y install nice-dcv-server-2019.0.7318-1.el7.x86_64.rpm sudo yum -y install nice-xdcv-2019.0.224-1.el7.x86_64.rpm sudo systemctl enable dcvserver sudo systemctl start dcvserver
-
Setup Password
sudo passwd centos
-
Change firewall settings
- Disable firewalld to allow all connections
sudo systemctl stop firewalld sudo systemctl disable firewalld
-
Create a virtual session to connect to
NOTE: You will have to create a new session if you restart your instance.
dcv create-session --type virtual --user centos centos
-
Connect to the DCV Remote Desktop session
-
Using a web browser
-
Make sure that you are using a supported web browser.
-
Use the secure URL, Public IP address, and correct port (8443) to connect. For example:
https://111.222.333.444:8443
NOTE: When you connect make sure you use the
https
protocol to ensure a secure connection.
-
-
Using the NICE DCV Client
-
Download and install the DCV Client
-
Use the Public IP address, and correct port (8443) to connect
-
-
-
Logging in should show you your new GUI Desktop