Connecting to the cluster

The cluster is accessible via SSH at esrumhead01fl.unicph.domain. This is the Esrum "head" node, the entry-point to the cluster, where you will be queuing your analyses using the Slurm job management system, as described on the Running jobs using Slurm pages.

Additionally, the two RStudio servers are accessible at https://esrumweb01fl/rstudio/ and https://esrumweb02fl/rstudio/. See the RStudio page for more information.

However, to connect to any of these, you must

  1. Have been granted access by the Data Analytics team. If that is not the case, then please see the Applying for access page before continuing

  2. Be connected to the official UCPH VPN. See below for more information.

  3. Follow the instructions for your operating system to configure an SSH client:

Connecting on Windows

To connect to Esrum you will first have to connect to the UCPH VPN. For information about connecting to the VPN when using Windows, see the support pages on KUnet in Danish and English.

Windows users will additionally need to install an SSH client in order to be able to connect to the Esrum head node. Options include MobaXterm, Putty, Windows Subsystem for Linux (WSL), and many more.

The following demonstrates how to connect using MobaXterm, but you are welcome to use any SSH client that you prefer. If using WSL, then see the Connecting on Linux section.

Configuring MobaXterm

  1. Install and open MobaXterm.

  2. Click left-most button, labeled Session, on the toolbar.

    ../../_images/mobaxterm_01.png
  3. Click on the left-most button, labeled SSH, in the resulting Session settings dialog

    ../../_images/mobaxterm_02.png
  4. Under Basic SSH settings

    1. Write esrumhead01fl.unicph.domain under Remote Host

    2. Click the checkbox next to Specify username and enter your UCPH username as shown.

    3. Select SCP (enhanced speed) on the SSH-browser type drop-down menu. This is required for file-uploads to work.

    ../../_images/mobaxterm_03.png
  5. Click on the Bookmark settings tab and

    1. Write Esrum or a name you prefer under Session Name

    2. Optionally click the Create a desktop shortcut to this session button. This will create a shortcut on your desktop that connects to Esrum.

    ../../_images/mobaxterm_04.png
  6. Click OK and you should automatically connect to the server. If not, then see Reconnecting with MobaXterm below. The first time you connect to Esrum (or any other server), you will be asked if you want to proceed. Simply press Accept:

    ../../_images/mobaxterm_05.png

    Warning

    If you receive this question again later, then stop and double-check that you are connected via the UCPH VPN, as the message could indicate that you are not actually connecting to Esrum!

  7. You should now be able to log in to the server using your UCPH account password, and using the NetIQ app to approve the login.

    ../../_images/mobaxterm_06.png
  8. For security reasons we recommend that you decline when asked if you want to save your password.

Reconnecting with MobaXterm

To connect again another time, either use the desktop shortcut (if you created it), double-click on Esrum in the list of sessions on the left side of MobaXterm, select Esrum from the list that appears when clicking on the Sessions button on the main menu, or click on Esrum in the list of Recent sessions.

../../_images/mobaxterm_07.png

Accessing network drives via MobaXterm

In order to access your UCPH network drives (H:, N:, and S:) via Esrum, you must disable logins using Kerberos (GSSAPI). To do so, open the Configuration dialog as shown:

../../_images/mobaxterm_08.png

Select the SSH tab and then untick the GSSAPI Kerberos checkbox as shown. Finally, click the OK button to close the options page:

../../_images/mobaxterm_09.png

Connecting on OSX

To connect to Esrum you will first have to connect to the UCPH VPN. For information about connecting to the VPN using OSX, see the support pages on KUnet in Danish and English.

Tip

While we recommend using the official UCPH VPN client for connecting to the VPN, as described in the documentation on KUnet, it is also possible to use the command-line openconnect as described in the Connecting on Linux section below.

Connecting to Esrum using ssh

Once connected to the VPN, you can connect to the cluster using the terminal command ssh, replacing abc123 with your UCPH username in the following command:

$ ssh abc123@esrumhead01fl.unicph.domain

You will likely be informed that the the authenticity of host ... can't be established. This is expected the first time you connect (see below), and you should simply type yes and press enter to continue. Once you've done so, you can enter your UCPH account password, and approve the connection via the NetIQ app.

$ ssh abc123@esrumhead01fl.unicph.domain
The authenticity of host 'esrumhead01fl.unicph.domain (10.84.4.168)' can't be established.
ED25519 key fingerprint is SHA256:QslJ02Z/4CrFJ2pKA64lU8WTS8Y+8pGO+748bTkrFhY.
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added 'esrumhead01fl.unicph.domain' (ED25519) to the list of known hosts.
abc123@esrumhead01fl.unicph.domain's password: *********
     __
    /  \
   _\__/  Welcome to esrumhead01fl
  (_)     University of Copenhagen
_____O______________________________________
Supported by UCPH IT  it.ku.dk/english

    Documentation is available at https://cbmr-data.github.io/esrum/
        For assistance contact Data Analytics at cbmr-esrum@sund.ku.dk,
    in #data-analytics at https://cbmr.slack.com/archives/C06TF9LGD47
        or find us in room 07-8-29 (Unit 8E) at the Maersk Tower.

Last login: Tue Apr 22 13:52:08 2025 from 10.203.180.30
$

Warning

If you get a warning about the authenticity of Esrum at a later date, then please double-check that you are connected to the UCPH VPN. This message could mean that you are connecting to an entirely different server!

It is recommended to add an entry for the cluster to your .ssh/config file, replacing abc123 with your UCPH username:

$ cat ~/.ssh/config
Host esrum esrumhead01fl esrumhead01fl.unicph.domain
    HostName esrumhead01fl.unicph.domain
    User abc123

This allows you to connect to the server using the names esrum, esrumhead01fl, or esrumhead01fl.unicph.domain, and without having to specify your username:

$ ssh esrum
abc123@esrumhead01fl.unicph.domain's password:
     __
    /  \
   _\__/  Welcome to esrumhead01fl
  (_)     University of Copenhagen
_____O______________________________________
Supported by UNICPH IT  it.ku.dk/english

Last login: Fri Oct 13 01:35:00 1980 from 127.0.0.1
$

Note

Note that the cluster does not support authentication through a public SSH key and that you therefore have to enter your password when connecting to the server.

Connecting on Linux

The official instructions for connecting to the VPN under Linux (in Danish and English) are written under the assumption that you are using KDE5. If that is not the case, or if you prefer a command-line solution, then you can also connect using openconnect, replacing abc123 with your UCPH username:

$ sudo openconnect -u abc123 vpn.ku.dk
POST https://vpn.ku.dk/
Connected to 130.225.226.54:443
SSL negotiation with vpn.ku.dk
Connected to HTTPS on vpn.ku.dk with ciphersuite (TLS1.2)-(RSA)-(AES-256-CBC)-(SHA1)
XML POST enabled
Please enter your username and password.
Password: ****************
POST https://vpn.ku.dk/
Please enter the TOTP code generated on your device
Response: ****
POST https://vpn.ku.dk/
Got CONNECT response: HTTP/1.1 200 OK
CSTP connected. DPD 30, Keepalive 20
Established DTLS connection (using GnuTLS). Ciphersuite (DTLS1.2)-(ECDHE-RSA)-(AES-256-GCM).
Configured as 10.203.179.174, with SSL connected and DTLS connected
Session authentication will expire at Wed May  7 09:19:45 2025

Depending on how you have configured multifactor authentication for UCPH, you will have to authenticate the login using one of the following methods:

  • If using NetIQ, open the app on your phone and approve the login.

  • If asked, enter the time based one-time password (TOTP) generated by the app you have enrolled

Note

It may be possible to authenticate using additional methods, such as Yubikeys, but we currently cannot offer a guide to using those with openconnect.

You will likely have to install openconnect first, in which case please refer to the documentation for the Linux distro you are using. OSX users can install openconnect using Homebrew.

Once you are connected to the VPN, you can follow the instructions in the Connecting to Esrum using ssh section above for connecting to Esrum itself.

Troubleshooting

If you have not already been granted access to the server, then please see the Applying for access page before continuing!

Timeout while connecting to the cluster

You may experience timeout errors when you attempt to connect to Esrum.

On Linux, this typically results in an Operation timed out message:

$ ssh abc123@esrumhead01fl.unicph.domain
ssh: connect to host esrumhead01fl.unicph.domain port 22: Operation timed out

On Windows, using MobaXterm, it may result in a connection timed out message:

../../_images/connecting_mobaxterm_timeout.png

Firstly verify that you are correctly connected to the UCPH VPN. This is required to connect to Esrum. See the Connecting to the cluster page for more information.

If you are still unable to connect to Esrum after verifying that you are correctly connected to the UCPH network, then please try to visit either our Project Manager or our Cohort Catalog.

If you are able to visit either of the Project Manager or Cohort Catalog pages, then you most likely do not have proper permissions to connect to Esrum. Please contact us and we will provide further guidance.

If you are unable to connect to the VPN or to either of the above pages while connected to the VPN, then there may be other problems with your account. We recommend that you either contact us for assistance or, if you prefer, that you submit a ticket to the UCPH-IT Serviceportal, using the Research Applications Counseling and Support / Forskningsapplikationer Rådgivning og support ticket category.

File uploads using MobaXterm never start

Please make sure that your session is configured to use the SCP (enhanced speed) browser type. See step 4 in the Configuring MobaXterm section.

Network-folders in ~/ucph are not available

Please make sure that you have disabled use of GSSAPI Kerberos as described in the Configuring MobaXterm section. Similarly, if using Linux or OSX, then you cannot be authenticating using a Kerberos ticket.