Skip to content

Lab 2: Configure Remote Desktop

While the cluster you deployed in the previous lab is running in the background, we'll configure your pre-built cluster to use a specific Amazon Machine Image (AMI) for booting the remote desktop server. As you saw in the architecture diagram, the DCV remote desktop will be your portal into the computing environment. This AMI provides the CentOS 7.5 Linux operating system and the applications you'll use later in the workshop.

  1. Obtain IP address of scheduler server

    1. In the AWS console, navigate to the CloudFormation page.

    2. Select the root stack named "mod-xxxxxxxxxxxx", where 'x' is a randomized alpha-numeric string, and click Outputs.

    3. The Outputs tab provides various bits of information about the provisioned environment. Copy the value to the left of ConnectionString. We'll use this command to SSH into the scheduler instance.

  2. Connect to the instance over SSH

    1. For macOS, paste the SSH command into a terminal on the Mac. Be sure to use the full path to the private key you downloaded earlier. See the steps here in the AWS Connecting to Your Linux Instance using SSH page if you need assistance.
    2. For Windows, follow the instructions in the AWS Connect to your instance using PuTTY docs.
  3. Once logged in, as sudo, open the file /apps/soca/cluster_manager/settings/queue_mapping.yml using your favorite text editor.

    Example: sudo vi /apps/soca/cluster_manager/settings/queue_mapping.yml

  4. Change the the highlighted values in the file to match the example below.


    We strongly recommend that you do not copy and paste this entire block into the file. Instead, please edit the value of each highlighted line individually.

        queues: ["high", "normal", "low"]
        instance_ami: "ami-05d709335d603daac"
        instance_type: "c5.large"
        ht_support: "false"
        root_size: "100"
        base_os: "centos7"
        #scratch_size: "100"
        #scratch_iops: "3600"
        #efa_support: "false"
        # .. Refer to the doc for more supported parameters
        queues: ["desktop"]
        instance_ami: "ami-05d709335d603daac"
        instance_type: "c5.2xlarge"
        ht_support: "false"
        root_size: "100"
        base_os: "centos7"
  5. Save the changes to the file.

Keep this SSH session open; you will come back to it later. Click the Next to move on to the next module.