Skip to content

PuTTY & MobaXterm Guide

This guide shows you how to connect to the AMD Accelerator Cloud (AAC) environment using MobaXterm or PuTTY with a private key.

Prerequisites

See Bare metal prerequisites for access to the AAC environment. For this guide you also need:

  • Your private key file
  • MobaXterm or PuTTY installed on your computer

Using MobaXterm

Step 1: Open MobaXterm

  • Launch MobaXterm from your desktop or start menu.

Step 2: Create a new session

  • Click the Session icon in the top left corner.
  • Select SSH from the session options.

Step 3: Configure SSH settings

MobaXterm session page

  • Remote host: Enter the hostname of the AAC environment (e.g., aac1.amd.com).
  • Specify username: Enter your username (e.g.,testuser ) as shown in above. This will be provided by AMD team upon your onboard completion.

Step 4: Use your private key

  • Check the box labeled Use private key.
  • Click the ... button next to the private key field.
  • Navigate to and select your private key file.

Step 5: Start the session

  • Click OK to save your session settings.
  • Double-click the session you just created to connect.

Step 6: Verify connection

  • Once connected, you should see a terminal window where you can run commands on the AAC environment.

Using PuTTY

Step 1: Open PuTTY

  • Launch PuTTY from your desktop or start menu.

Step 2: Configure host name

  • In the Host Name field, enter the hostname of the AAC environment (e.g. aac1.amd.com).
  • Ensure Port is set to 22 (default for SSH).

PuTTY session configuration page

Step 3: Set up SSH key authentication

PuTTY SSH key authentication settings

  • In the left sidebar, navigate to Connection > SSH > Auth.
  • Click on "Browse" under "Private key file for authentication."
  • Locate and select your private key file (convert .pem to .ppk if necessary using PuTTYgen).

Step 4: Go back to Session

  • Return to the Session category in the left sidebar.

Step 5: Connect

PuTTY session open and connected

  • Click "Open" to start the session.

Step 6: Log in

  • A terminal window will open. Enter your username when prompted.

Important note

When accessing the Jump Host, please be aware that no custom port (other than the standard port 22) has been provided as part of your login instructions. This means that your initial login will route you through the Jump Host.

However, if a custom port (other than 22) is mentioned in your instructions, it implies that you are being directed to access the GPU node directly rather than through the jump host.