Getting started

Basic Linux requirements

Please note that all of our HPC systems are running under Linux, so a basic knowledge of the Linux command line is essential. There are numerous excellent tutorials around the web for a first introduction to Linux and its shell and we think one of them can be found in the

UNIX/Linux tutorial for Beginners

of the University of Surrey.

Remote access

For security reasons, our cluster systems are behind a firewall and are accessible only from inside the University's domain IPs. If you want to access the systems from outside, you need to set up a VPN connection. See the ZID instructions for setting up a VPN client for various operating systems.

By default, the VPN client will route all traffic through the University network, making your client effectively part of the UIBK network. All your IP connections will appear to originate from within UIBK in this case. This also means that while your VPN client is connected, you will have no access to your local network, and you may have performance degradation when using external data services.

If you prefer not to lose local connectivity, use the Split Tunnel VPN setup by appending the string _split or _splithpc to your user ID, i.e. connect to the VPN using the user ID cXXXyyyy_split or cXXXyyyy_splithpc. The _split suffix will allow access to all services behind the UIBK firewall; _splithpc additionally enables connections to MACH2 and VSC. Connections to all other destinations will be directly from your device (i.e. will not be tunneled).

Login procedure

Depending on your account use the appropriate login node (also referred to as head-node or master-node) of one of the following systems:

Cluster Login node RSA key fingerprint
LCC2 RSA+MD5: 41:29:44:5c:d7:6f:5e:7f:e6:a9:88:54:31:55:74:c3
RSA+SHA256: EiayacBDHshsdTY34l1XTP9RFl7Yu9JKutns4IzXlfE
ECDSA+MD5: 44:ec:e0:1e:60:b0:9f:64:77:c4:64:ab:a9:42:77:85
ECDSA+SHA256: 8dd5neYtEPDNOBjItpEcneQKhpTFfUnxpuphqUbU0HA
LEO3 RSA+MD5: f8:dc:6a:66:de:01:b3:4e:3a:a8:9e:91:be:04:37:56
RSA+SHA256: EEkzNr713KOpFt0iS08QMO7PfPi7Iq2rGVNPQ6PB92E
ECDSA+MD5: bb:e1:a7:c4:e2:02:f4:74:97:ec:d7:0e:5e:92:61:83
ECDSA+SHA256: 7rdiOQzhMWGyyObR7GK2gwglfLdBba9R8/+Ro4F3Wu0
LEO3E RSA+MD5: 74:c9:c1:8f:b6:33:b6:68:04:58:60:f4:e7:85:65:0a
RSA+SHA256: +ypOrFlsBuS4K0RXIm1XtgLZhqgo7GG6buO/o2PE3JE
ECDSA+MD5: 16:4e:af:09:cc:11:7a:21:4b:7c:e4:97:1f:d6:33:0a
LEO4 RSA+MD5: e2:64:9a:76:d8:7e:8a:73:ba:73:0e:28:99:a3:98:80
RSA+SHA256: OJYnbi0UOCKLq0Ozvd8Pl/C7OTogvCpAFL9OvrtPdlg
ECDSA+MD5: 81:bb:38:13:72:80:72:b3:1a:74:03:09:73:80:2e:bb
ECDSA+SHA256: zbQjBpnExheR4KZWTMbATw+926jGu+0deXtIBYuNMQs
ED25519+MD5: 0e:2c:35:5b:f4:7f:7f:59:0b:09:f9:57:d4:24:ef:4f
ED25519+SHA256: 6tZAMbFqSWOj2WC2Fh0pgfNhXFbhJSXySf3xYX9ypoA
MACH 37:73:78:35:fe:9a:25:fb:fe:b6:c7:e6:a0:12:bc:e3

Linux workstation

How to connect

Access to each of the systems listed above is provided via SSH. In Linux, login to the head node of your choice by executing the following command in your local shell:

ssh -l username cluster-name

At first login, the login node's SSH public RSA key is not registered on your computer yet. If you get the following warning, compare the given fingerprint with the table above before continuing:

The authenticity of host 'login.node (IP)' can't be established.
RSA key fingerprint is ... .
Are you sure you want to continue connecting (yes/no)?

To enable X11 forwarding, necessary for programs with graphical user interfaces such as graphical editors or the graphical interfaces of Matlab, the TotalView debugger, etc. simply add the -X option (uppercase X) to the command line above:

ssh -X -l username login-node

Some useful settings

On your Linux client workstation, upon first using ssh, a directory $HOME/.ssh will be created automatically. Here you may create a configuration file $HOME/.ssh/config with various defaults. We consider the following to be particularly useful:

Setting What it does
ForwardX11 yes Automatically enables X11 forwarding, so no need to use the -X command line option
TCPKeepAlive yes
ServerAliveInterval 100
Long distance connections have a tendency to break. These two options appear to mitigate this problem.

Windows workstation

To access a Linux server from a Windows workstation, you need a terminal emulator that supports the SSH protocol and an X-Windows server. We recommend the following:

PuTTY as SSH client and terminal emulator

Install the PuTTY client to establish a remote connection to our HPC systems and to provide you with a terminal (command line interface) to the login node on your Windows system. When opening PuTTY, simply enter the fully qualified domain name of the desired login node into the "Host Name"-field and klick the "Open" button. You are then asked to enter username and password and are subsequently provided with the Linux command line. If you do not get PuTTY's login session dialog box automatically, select the 'Session' panel from its left-hand selection menu.

If you are connecting for the first time, you are presented with an RSA fingerprint and asked for its authenticity. To play it safe, compare the given fingerprint with the table above before continuing.

Further usage instructions can be found at this ZID page. PuTTY is also available via the University's free software download area.

Installing a local X server

In order to open X Windows applications, such as graphical editors or the graphical interfaces of Matlab, the TotalView debugger, etc. remotely on your local Windows PC, you need to have a local X server installed. We remommand to install the XMing X Server, which can be obtained in its newest version from the University's software download area by all University employees. An outdated Public Domain release of Xming can be found at Since this version is defective (e.g. dysfunctional clipboard integration), we definitely recommend to use the new Xming version available in the ZID software download area.

In any case, for good display quality, you also need the Xming fonts, which can be downloaded from the same location.

When you create a shortcut for starting the Xming server, the following command line options have turned out to be usefu in the "Properties / Shortcut / Target" setting:

"C:\Program Files\Xming\Xming.exe" :0 -resize -clipboard -multiwindow -nolisten inet6 -dpi 150
X will respond to Windows display resolution changes
Enable integration between X11 clipboard and Windows clipboard. Necessary for Copy/Paste between Windows programs and X11 clients.
Run in multiwindow mode. Uses Windows as X11 window manager.
-nolisten inet6
Disable IPV6
-dpi nnn
DPI setting. Affects scaling of fonts. Start with your monitor's resolution and adjust if necessary until satisfied.
Enabling X11 forwarding with PuTTY

X Windows applications called from whichever terminal emulator you use, will only work on your Windows PC if X11 forwarding via ssh was enabled, and of course, only if the X server of your choice is up and running. In case of Exceed, a corresponding active program button in the Windows taskbar will indicate a running X server.

Proceed with the following simple steps to configure X11 forwarding in PuTTY:

  • Select the 'Connection->SSH->X11' panel from the left -hand selection menu.
  • Enter into the 'X display location' dialog box. (Usually the Windows X display server will install itself as display number 0 on your local machine; if necessary consult your specific X server's manual.)
  • Check the 'enable X11 forwarding' check box.

Now open your desired SSH session and enter e.g. xclock on the command line to test your X11 enabled connection.

OS X Workstation

The OpenSSH client should be preinstalled. Install the XQuartz X Server, then follow the instructions for Linux workstations.

Please note: when XQuartz is not running, it should normally be started automatically at the first connection with ssh -X. Users have reported that this autostart capability may be disabled after an OS upgrade. In this case, either start the X Server manually or reinstall XQuartz.

Change your password

Change your password by issuing


on the command line. After having typed your current password you have to input your new password twice.

Note: Your password should at least be 8 characters long, contain upper and lower case letters, as well as numbers or symbols, to be considered reasonably secure.

File transfer

To transfer your files from and to our systems, we recommend the following methods:

Linux workstation

Use the command line scp program to transfer your files. To upload a file to a destination on a HPC system, use a command similar to the following:

scp SourceFile username@login-node:directory/TargetFile

You can omit the specification of TargetFile if you want to leave the file's name unchanged. Conversely, to transfer a file from a HPC system to your local current directory, issue

scp username@login-node:directory/TargetFile SourceFile


  • Use scp -r ... to copy entire directories recursively, but be very careful, as scp resolves symbolic links to their destination and blindly copies every file it finds this way across the network!
  • To avoid the above problem with symbolic links, or if speed is an issue, use rsync instead of scp, especially when you need to update small differences in large datasets, which exist on both ends.

Windows workstation

Use the open source free SFTP client WinSCP for file transfer from and to a Windows system and see the ZID's howto for a quick introduction to WinSCP usage.

WinSCP is also available via the University's free software download area.

Important Usage Note: If a file upload results in a quota overflow, the WinSCP client will give you a misleading error message "Received SSH2_MSG_CHANNEL_DATA for nonexistent channel 0". One likely reason for exceeding quota is that you you are trying to upload large amounts of data to $HOME instead of $SCRATCH

Nach oben scrollen