Skip to content

Lab 3: Launch Remote Desktop Session

The goal of this module is to start a remote desktop session from which you will run applications and submit jobs into the cluster. You will use the cluster's management console to start and monitor the session.

Step 1: Subscribe to AWS FPGA Developer AMI

This workshop requires a subscription to the AWS FPGA Developer AMI in AWS Marketplace. This is the AMI you added to the /apps/soca/$SOCA_CONFIGURATION/cluster_manager/settings/queue_mapping.yml file in the previous lab. It will be used to boot the remote desktop instance in AWS and contains software required later in the workshop.

  1. Return to the AWS console for your temporary AWS account.

  2. Click here to open the page for the AWS FPGA Developer AMI in AWS Marketplace, and then choose Continue to Subscribe.

  3. Review the terms and conditions for software usage, and then choose Accept Terms.

    When the subscription process is complete, exit out of AWS Marketplace without further action. Do not click Continue to Configure; the workshop CloudFormation templates will deploy the AMI for you.

  4. Click here to verify the subscription within the Marketplace dashboard. You should see the FPGA Developer AMI in the list of subscriptions.

    Marketplace Subscriptions

Step 2: Log into web UI

  1. Select the root stack named "mod-xxxxxxxx" again, and click Outputs.

  2. The Outputs tab provides various bits of information about the provisioned environment. Click on the link to the right of WebUserInterface to log into the Web UI

    Note

    Your web browser will warn you about a certificate problem with the site. To open the webpage, you must authorize the browser to trust the self-signed security certificate.

  3. Log in using the web UI using credentials you provided in the CloudFormation template username and password parameters.

Step 3: Register the FPGA Dev AMI for DCV sessions

  1. Click AMI Management on the left sidebar under the ADMIN section.

    AMI Management

  2. In the AMI ID field, paste ami-03f32123533983fdb, select Linux - Centos7 under Operating System, type 100 in the Root Disk Size (in GB) field, and finally type FPGA Dev AMI in the AMI Label field.

    AMI Management

  3. Finally click on Register AMI in SOCA

Step 4: Launch remote desktop server

Follow these instructions to start a full remote desktop experience in your new cluster:

  1. Click Linux Desktop on the left sidebar.

    Linux Desktop

  2. Type 100 in the Storage Size field.

  3. Select FPGA Dev AMI from the Software Stack dropdown list.

  4. Choose 2D - Medium (8 vCPUs - 32GB ram) from the Session Type dropdown list.

  5. Click Launch my Session #1

After you click Launch my session, a new job is submitted into the queue that will instruct AWS to provision a server with 8 vCPUs and 32GB of memory and install all desktop required packages including Gnome.

You will see an message asking you to wait up to 20 minutes before being able to access your remote desktop, but it should take around 10 minutes to deploy the remote desktop server.

Note

You can monitor the deployment of the remote desktop server by observing the status of the CloudFormation stack with a name that ends in -Desktop1-<username>. If after 5 minutes the status of the stack is not CREATE_COMPLETE, please raise your hand for assistance.

Let's move on to the next step while we wait for the desktop instance to launch. Click Next.