Part 2 - Connect to the Developer Desktop

Remote Desktop Protocol

You can use any remote desktop client you like to connect to the developer desktop. Here, we will use Microsoft Remote Desktop in Mac OS, Remote Desktop Connection in Windows 10, and Remmina in Linux to connect to the remote Windows machine.

Download Connection File

To connect the developer desktop using your remote desktop client, you need to download an RDP connection file for the remote machine from the EC2 Console.

In the AWS Console, navigate to EC2. Search EC2

In the EC2 Console, click the “Running instances” link to view the instances deployed in your account. Running instances

One of the running instances is a Windows remote machine named “Developer Desktop”, which is your remote developer desktop. Check the checkbox before the instance name to select the instance, and click “Connect.”

Select instance

A dialog window will pop up. In this dialog box, please keep the Connection method as “A standalone RDP client” and click “Download Remote Desktop File.” Then an RDP connection file will be downloaded to your local machine.

Download connection file

The following contents are connection instructions for different operating systems. You can jump to the instructions for your system via these links: MacOS, Windows10, Linux (Ubuntu).

Connect

MacOS

Click this link to download the Microsoft Remote Desktop for macOS.

Check the downloaded RDP connection file in the finder. After installing your remote desktop application, you will see the icon for the connection file is the icon of your remote desktop application. Please double click this connection file.

After you double click your connection file, a warning dialog window will pop up, which tells you your connection may not be secure. This dialog window showed up because the identity of the EC2 instance (your developer desktop) is not verified. However, since the developer desktop you are trying to connect is built by us, we can trust it. Please click “Continue.”

Warning about Cert

Then, a dialog window will ask you to provide the username and password for connection. Please enter Administrator as the username and DeepDiveW0rkshop+TheStrong1 as the password. Click the “Continue.”

dialog window to enter username/password

Now you can connect to your developer desktop.

Windows

The Remote Desktop Connection application is pre-installed in the Windows 10 system, so you don’t need to download any application. Check the downloaded RDP connection file in the file explorer. You will see the the icon for the connection file is the icon of the Remote Desktop Connection application. Please double click this connection file.

After you double click your connection file, a warning dialog window will pop up which tells you your connection can’t be identified. This dialog window shows up because the identity of the EC2 instance (your developer desktop) is not verified. However, since the developer desktop you are trying to connect is built by us, we can trust it. Please click the “Connect” button.

Warning about Cert

After that, a dialog window will ask you to enter the password. Enter DeepDiveW0rkshop+TheStrong1 as the password.

dialog window to enter username/password

Now you can to connect to your developer desktop.

Linux (Ubuntu)

Follow the instructions on the official website of Remmina to download and install it.

Check the downloaded RDP connection file you downloaded. You will see the the icon for the connection file is the icon of Remmina. Please double click this connection file.

If you see any warning given by your remote desktop application in this step, you can continue to connect without worrying about security issues. The instance you are trying to connect to is built by us, so it is safe.

Then, a dialog window will ask you to provide the domain, username and password for connection. Here, you only need to provide the username and password, since the domain info is included in the connection file. So, please enter Administrator as the username and DeepDiveW0rkshop+TheStrong1 as the password. Click the “OK” button.

dialog window to enter username/password

Now you can connect to your developer desktop.

Initial preparation

  1. When you log into the your developer desktop for the first time, a side bar may pop up and ask you whether you want your PC to be discoverable on that network. Please choose No for this question. Otherwise, the RDP will lose the connection.

Windows ask discoverable

  1. Open a browser window in your developer desktop. Copy the URL of this workshop and paste it into the browser of your remote machine so that the website is open in your developer desktop.

  2. Open a new tab in the browser in the developer desktop and enter the value of “AWS Management Console login link” in your cheat sheet. (If you forget to copy this value to your cheat sheet, refer to step 4 of the previous part.) Then, you can visit the AWS Management Console in your developer desktop.

Visit AWS console in the EC2 instance


Visit AWS console in the EC2 instance

  1. Copy your cheat sheet to your developer desktop. You can drag the file into the developer desktop or just copy it as if you are copying a file to another folder.

  2. After completing step 2-4, you are able to access all the resources you need in the developer desktop so that you don’t need to go back and forth between your local machine and the developer desktop. (If you don’t use AWS accounts generated by Event Engine, you may need to go to the AWS login page to log into your AWS account in the developer desktop.) If everything looks good, let’s move on to the next part!