How to start a session and connect to a User Interface server

User Interface (UI) servers and networks

To submit jobs, check their status, test scripts, etc. you need to login on a User Interface (UI) server using SSH. Different clusters have different UIs; see here for a List of UIs First make sure you have an account. If you are new, please follow these instructions to request an account.

  • If you are inside certain RUG/UMCG subnets you can connect to UIs directly (see instructions below).
  • If you are outside the UMCG/RUG network you need an automated double hop via our proxy, which is documented here: TransparentMultiHopSSH
    Using a proxy command as opposed to key forwarding is preferred whenever possible.

Account prefixes

Users and groups have different prefixes:

  • For UMCG accounts: use an umcg- prefix
  • For LifeLines accounts: use an ll- prefix

For users on Mac OS X, Linux or Unix

  • Open a Terminal/Shell:
    • On Mac OS X: A terminal/shell is already part of the OS by default. Optionally you may want to install the XQuartz X server for graphical apps running on a cluster UI.
      Open the Terminal application, which is located in Applications -> Utilities ->
    • On Linux / Unix: A terminal/shell is already part of the OS by default and usually you also already have an X window server installed for graphical apps. Consult your distro documentation for details.
  • To connect for example as UMCG user your_account to UI type at the prompt
    ssh -X
  • Do not use ssh with agent forwarding (-A) by default as it is less secure.
    The only use case where agent forwarding is required is when you login from computer A to computer B and next need to copy data using scp/rsync from computer B to computer C. You cannot accomplish this with a ProxyCommand as described in TransparentMultiHopSSH. When you login for example with
    ssh -A -X
    and cannot ssh from there to the next server, you may have to add your private key to the SSH agent. To check which private keys are available to your SSH agent you can list them with ssh-add -l on your local computer:
    ssh-add -l
        The agent has no identities.
    then add your private key with ssh-add like this:
        Identity added: /path/to/your/home/dir/.ssh/id_rsa (/path/to/your/home/dir/.ssh/id_rsa)
    your private key should now be listed when you check with ssh-add -l:
    ssh-add -l
        2048 b6:dd:bf:1f:bc:25:88:d3:12:f4:62:1c:0b:9a:f1:4b /path/to/your/home/dir/.ssh/id_rsa (RSA)

For users on Windows

You will need to install a terminal application first and we suggest you give PuTTY or MobaXterm a try. Instructions for the latter to connect to the Peregrine cluster UI are here.

To connect for example as UMCG user your_account with prefix prefix to UI using PuTTY:

  • In a PuTTY Configuration window supply the hostname, as account name prefix-your_account and don't forget to add your private key file in Connection -> SSH -> Auth -> Private key file for authentication.
  • Click connect...
Last modified 10 months ago Last modified on 2016-10-24T14:59:08+02:00