This is a guide for establishing an SSH connection to either Shannon or Aegis, two servers that we have at UVA as workstations.

Step-by-step guide

  1. Before Connecting
    1. If you're on UVA campus and connected to Eduroam, skip this step
    2. If you're not on UVA campus, please install and set up the UVA Anywhere VPN. Once set up, please connect to it.
  2. Connecting

    1. In a terminal, type either 

      1. ssh <user>@aegis.phys.virginia.edu
      2. ssh <user>@shannon.phys.virginia.edu
    2. <user> corresponds to which account on the computers that you would like to use. This can include "dustin, ptgroup, uvaspin, etc". 
    3. You will be asked for a password. Please type in the standard group password.
    4. Success!
  3. Using
    1. To use, please create your directory in the 'documents' directory. Please copy all of your working files to this directory. 
    2. Currently, the SLURM manager is set up for the ptgroup account. When typing up a slurm job, list the partition as ptgroup. 
    3. Once you have your SLURM file created, alongside the script that you want to run, type:
      1. sbatch <slurm_script_name>.slurm <your additional arguments> 
    4. To run a .sh file, all you need to do is:
      1. ./<jobscript_name>.sh <your additional arguments>

If you are having trouble understanding or writing SLURM scripts, please review this tutorial by Johns Hopkins University.

Note: the SLURM manager on Aegis is set up to allow email notifications. If you include your email in the SLURM scripts, you will receive an email notification once it is finished (or if it failed). If you are running parallel SLURM scripts, DO NOT INCLUDE IT UNLESS YOU WANT A BARRAGE OF EMAILS.