If you’re new to AWS Portal we recommend starting here. If you’re new to Deadline we recommend starting here.

Connecting to an Infrastructure From a Windows Machine

If you are connecting to the Gateway instance from a Windows machine use the following steps.

  • Install PuTTY
    Download and install PuTTY from the PuTTY download page. If you already have an older version of PuTTY installed, we recommend that you download the latest version. Be sure to install the entire suite.

Converting Your Private Key Using PuTTYgen

AWS Portal Link creates the DashKey in a private key format (.pem) which PuTTY does not natively support. PuTTY has a tool named PuTTYgen, which can convert keys to the required PuTTY format (.ppk). You must convert your private key into this format (.ppk) before attempting to connect to the Gateway instance using PuTTY.

To convert the DashKey

  1. Start PuTTYgen as Administrator (for example, from the Start menu, choose All Programs > PuTTY > PuTTYgen, Right Click > Run as administrator).

  2. Under Type of key to generate, choose RSA.

    ../../_images/RSAPutty.png

    If you’re using an older version of PuTTYgen, choose SSH-2 RSA.

  3. Choose Load. By default, PuTTYgen displays only files with the extension .ppk. To locate your .pem file, select the option to display files of all types. Then navigate to the directory with the DashKey that you found earlier.

  4. Select the DashKey file, and then choose Open. Choose OK to dismiss the confirmation dialog box.

  5. Choose Save private key to save the key in the format that PuTTY can use. PuTTYgen displays a warning about saving the key without a passphrase. Choose Yes.

  6. Specify the DashKey. PuTTY automatically adds the .ppk file extension.

The DashKey is now in the correct format for use with PuTTY. You can now connect to your Gateway instance using PuTTY’s SSH client.

Starting a PuTTY Session

Use the following procedure to connect to the Gateway instance using PuTTY. You need the DashKey.ppk file that you created earlier for the DashKey.

To start a PuTTY session

  1. Start PuTTY as Administrator (from the Start menu, choose All Programs > PuTTY > PuTTY, Right Click > Run as administrator).

  2. In the Category pane, choose Session and complete the following fields:

    1. In the Host Name box, enter ec2-user@public_dns_name_or_ipv4_address.

    2. Under Connection type, select SSH.

    3. Ensure that Port is 22.

    ../../_images/PuttyExample.png

  3. (Optional) You can configure PuTTY to automatically send ‘keepalive’ data at regular intervals to keep the session active. This is useful to avoid disconnecting from your instance due to session inactivity. In the Category pane, choose Connection, and then enter the required interval in the Seconds between keepalives field. For example, if your session disconnects after 10 minutes of inactivity, enter 180 to configure PuTTY to send keepalive data every 3 minutes.

  4. In the Category pane, expand Connection, expand SSH, and then choose Auth. Complete the following:

    1. Choose Browse.

    2. Select the DashKey.ppk file that you generated earlier, and then choose Open.

    3. (Optional) If you plan to start this session again later, you can save the session information for future use. Choose Session in the Category tree, enter a name for the session in Saved Sessions, and then choose Save.

    4. Choose Open to start the PuTTY session.

    ../../_images/PuttyAuthExample.png

  5. If this is the first time you have connected to this instance, PuTTY displays a security alert dialog box that asks whether you trust the host you are connecting to.

  6. Choose Yes. A window opens and you are connected to your Gateway instance.