3. Connecting to Artemis HPC

Overview

Teaching: 5 min
Exercises: 5 min
Questions
  • How can you scale up beyond your local machine?

Objectives
  • Refresh how to connect to Artemis HPC

Connect to Artemis

If you followed the Setup instructions, then you should already have the required software installed. If not, please go do this now!

Connect via SSH in a terminal (recommended)

Fire up your terminal emulator and connect to Artemis HPC via SSH. When you use Artemis for your research, these will be your Unikey and Unikey password; however, for this training course we’ll be using training accounts, which are:

  • Username: ict_hpctrain<N>, with N from 1-20 (replace <N> with your assigned number)
  • Password: will be written on the whiteboard!
ssh -X ict_hpctrain<N>@hpc.sydney.edu.au

or, if using XQuartz on a Mac

ssh -Y ict_hpctrain<N>@hpc.sydney.edu.au

The -X or -Y flags tell ssh to enable X-forwarding, which lets GUI programs on Artemis serve you graphical windows back on your local machine.

An iTerm2 terminal window on Mac


If connecting for the first time on this machine, you may get the following output, requesting authorisation to connect to a new host server:

The authenticity of host 'hpc.sydney.edu.au (10.250.96.203)' can't be established.
RSA key fingerprint is SHA256:qq9FPWBcyvvOWOMdFs8uZES0tF3SVzJsNx1cdn56GSE.
Are you sure you want to continue connecting (yes/no)?

Enter ‘yes’. You will then be asked for your password: type it and press ‘enter’, and you should then be logged in!

Access granted!


Connecting via an SSH GUI (common for Windows users)

If you’re on Windows, and followed the Setup guide, then you will likely be connecting through an X-window or shell client program, like ‘X-Win32’ or ‘PuTTY’. Following the instructions in the Setup guide:

  • Open your installed program
  • Select the “Artemis” session you configured earlier
  • Click ‘Launch’ (X-Win32) or ‘Open’ (PuTTY)

If this is the first time connecting to Artemis, you will be asked to authorise it as a trusted host server; click ‘Accept’ (X-Win32) or ‘Yes’ (PuTTY).

Unknown host challenges: X-Win32 (top), PuTTY (bottom)


  • If using ‘X-Win32’, enter your password and once entered, a terminal window connected to Artemis should open.

  • If using ‘PuTTY’, enter your username, and then your password in the terminal window that appears. You should now be logged in to Artemis.

Access granted! X-Win32 (top) cuts the welcome messages, PuTTY (bottom)



Key Points

  • Several methods and tools to connect to a remote machine

  • Get access to more resources than your local computer