Connect to the AMI Instance#

Before you log in, make sure that:

  • The AMI instance is running

  • PuTTY (or other SSH terminal software) is installed

  • The NICE DCV Client is installed

  • Your Key Pair is created

Follow the instructions below depending on the OS you are running and the instance type:

Using PuTTY to Connect to Linux Instances

  1. Copy the Public IP Address of your instance. You can find this by:

    1. Clicking the checkbox next to your instance to select it.

    2. In the information panel below the table, find the Public IPv4 address and copy it.

  2. Open up PuTTY

    1. In the Host Name (or IP Address) input, paste your instances Public IPv4 address.

    2. Expand Connection > SSH > Auth > Credentials. Browse to the location of your Key Pair, and select it.

    3. Select Open in the PuTTY dialog to connect.

  3. When you are connected to the AMI, change the password. The password must be changed for NICE DCV to connect in a later step.

    1. Change the password for the Ubuntu account in order to use the Amazon DCV client. Use the following command to change the password: sudo passwd ubuntu.

      Note

      The password needs to be set via SSH each time a new instance is created, this is by design for security.

    2. Enter a new password.

    3. Check your session is running by using the following command: sudo dcv list-sessions. (There should be a ‘console’ session running.)

Using EC2 to Connect to Windows Instances

  1. Select your instance from the EC2 page and from the toolbar select Connect.

  2. On the Connect to instance page select the RDP Client tab.

  3. Set your username and then select Get password.

  4. Upload your private key file associated with the instance and select Decrypt password

  5. Use this username and password to log in when you connect with the DCV Client.

Using EC2 to Connect for Mac Instances

  1. Create your Key Pair as .pem format.

  2. Set appropriate permissions to the key by:

    1. Opening Terminal at the location of the .pem file

    2. Running the command chmod go-rw <my_key_pair>.pem

  3. Copy the Public IP Address of your instance from the instance table on EC2.

  4. Now connect using the ssh command ssh -i <my_key_pair>.pem ubuntu@<public_ip> using the copied IPv4 address.

  5. Once connected, set new password using sudo passwd ubuntu.

Connect to the Instance with DCV Client#

  1. Open the locally installed NICE DCV Client and enter the Public IP Address of your instance in this format https://<public IPv4>:8443), followed by clicking Connect.

    1. If you see the Server Identity Check message, click Trust and Connect.

    2. Log in by entering the username ubuntu and the password that was set in a previous step, followed by clicking Login.

    3. The Ubuntu desktop GUI will now be displayed in the NICE DCV window.

You have now logged in and your AWS instance is ready for use.