BwUniCluster3.0/Login/Client

SSH Clients

Only Secure Shell (SSH) is permitted for login to the bwHPC clusters. On order to establish a SSH connection, the users need a SSH client installed on their device. The following clients are suitable for connecting to the bwHPC clusters.

Pre-installed SSH Clients

All common operation systems, such as Microsoft Windows, Linux, Mac OS or other Unix-like operating systems come with a built-in SSH client, most likely provided by the OpenSSH project.

To use this client, simply open a command line terminal. Depending on your operating system, the required application is called Terminal, Console, PowerShell, Windows-Terminal or similar. Inside this terminal, enter the following command to connect to a cluster:

$ ssh <username>@<hostname>

• <username> is your local username including the prefix (cf. Login Username)
• <hostname> is the hostname of the cluster you want to connect to (cf. Login Hostnames)

For KIT user "ab1234" who wants to connect to bwUniCluster 3.0, this would yield:

$ ssh ka_ab1234@uc3.scc.kit.edu

For a more detailed explanation on how to do SSH login, please refer to Login Examples.

File Transfer

All native SSH clients already come with a remote file copy application: scp.
For a more detailed explanation on how to do data transfers with scp, please refer to Data_Transfer/SCP.

X11 Forwarding

If you are on a Linux or Unix system and want to use a GUI-based application, you can use the -X option for the ssh command to set up X11 forwarding:

$ ssh -X <username>@<hostname>

If you want to use X11 forwarding on Microsoft Windows, please refer to MobaXterm.

Alternative SSH Clients

Using Microsoft Windows, some handy features of Unix-based operating systems are lacking, such as X11 forwarding or file transfer tools like rsync. Therfore, we suggest to have a look at the following tools.

MobaXterm

If the built-in SSH functionalities on Windows are not sufficient, the bwHPC support team recommends to use MobaXterm.
MobaXterm provides a built-in X11 server allowing to start GUI based software. It also supports graphical file transfer via drag & drop, although we explicitly advise against this, especially when transferring more than a few files.

Installation

MobaXterm can either be installed or used as portable software without installation. Please refer to MobaXterm Home Edition.

Set up a SSH session

Please have a look at the "SSH client" tab in the MobaXterm live demo.

The steps to define a SSH session are the following:

1. Click the "Session" button in the top task bar or "Sessions">"New Session" in the menu
2. Select the session type "SSH" in the Session settings
3. Fill in the following fields:
   Remote host: <hostname>
Specify username: <username>
Port  : 22
4. Click OK

Start a SSH session

After setting up a SSH session, you can connect to the respective server by double-clicking the entry in the "Sessions" list or by right-clicking and "Execute" the entry.

A terminal will be opened, here you can enter your credentials, TOTP and service password.

Now your are logged in to the login node of the respective server.

Set up a file transfers

Files can be transferred between the local system and the cluster by navigating to the respective folders in the split file view and then either dragging files and folders between the views or by clicking on a file/folder with the right mouse button and then selecting "Upload" or "Download" from the menu.

Necessary Configuration for File Transfers

When using File transfer with MobaXterm version 23.6 the following configuration change has to be made: In the settings in the tab "SSH", change the option "SSH engine" from "<new>" to "<legacy>". Then restart MobaXterm

Windows Subsystem for Linux

After installing a linux system with WSL you can use the instructions for linux.

More recent versions of Windows 10 and Windows 11 using the Windows Subsystem for Linux (WSL) also come with a built-in OpenSSH client.