Registration/Login: Difference between revisions

From bwHPC Wiki
Jump to navigation Jump to search
 
(8 intermediate revisions by 3 users not shown)
Line 8: Line 8:
If you are outside the BelWü network (e.g. at home), you must first establish a VPN connection to your home university or a connection to an SSH jump host at your home university.
If you are outside the BelWü network (e.g. at home), you must first establish a VPN connection to your home university or a connection to an SSH jump host at your home university.
|}
|}

After completing the [[Registration|web registration]], the HPC cluster is ready for your '''SSH''' based login.
The following options for SSH connections are recommended:

* '''Linux/MacOS:''' Use the <code>ssh</code> command (OpenSSH) in a terminal application.
* '''Windows:''' Use the [http://mobaxterm.mobatek.net/ MobaXterm] application. Alternatively, you can use virtual machines to run native Linux applications such as SSH. An easy way to use Linux on Windows is to install the "[https://docs.microsoft.com/en-us/windows/wsl/install Windows Subsystem for Linux]".


== Hostnames and Login to bwUniCluster/bwForClusters ==

For specific instructions on logging in to the cluster and host names, see the following guides:
* If you want to '''login''' to the bwUniCluster, please refer to <br /> &rarr; '''[[bwUniCluster 2.0 Login]]'''
* If you want to '''login''' to one of the bwForClusters, please refer to <br /> &rarr; '''[[BwForCluster_BinAC_Login|BINAC]]''' <br /> &rarr; '''[[BwForCluster_JUSTUS2_Login|JUSTUS 2]]''' <br /> &rarr; '''[[Helix/Login|Helix]]''' <br /> &rarr; '''[[BwForCluster_NEMO_Login|NEMO]]'''

== Username ==

All members of universities and colleges in Baden-Württemberg can use the bwHPC resources.
Prefixes are used to ensure that the usernames assigned by the home organization are unique within the state.
The username for the bwHPC clusters is the same as the one assigned by the university or college, but it is prefixed with two letters for the home institution.
For users from KIT, however, there is an exception on the bwUniCluster (see table).

The following lists contain all prefixes currently in use.
{| style="border:3px solid darkgray; margin: 5em auto 5em auto;"
|-
!style="width:280px; background-color:darkgray"| University
!style="width:60px; background-color:darkgray"| Prefix
!style="width:130px; background-color:darkgray"| Username bwUniCluster
!style="width:130px; background-color:darkgray"| Username bwForCluster
|-
| Universität Freiburg
| fr
| colspan="2" align="center"| fr_''<username>''
|-
| Universität Heidelberg
| hd
| colspan="2" align="center"| hd_''<username>''
|-
| Universität Hohenheim
| ho
| colspan="2" align="center"| ho_''<username>''
|-
| Karlsruhe Institute of Technology (KIT)
| ka
| style="color:red;" align="center"| ''<username>''
| style="color:red;" align="center"| ka_''<username>''
|-
| Universität Konstanz
| kn
| colspan="2" align="center"| kn_''<username>''
|-
| Universität Mannheim
| ma
| colspan="2" align="center"| ma_''<username>''
|-
| Universität Stuttgart
| st
| colspan="2" align="center"| st_''<username>''
|-
| Universität Tübingen
| tu
| colspan="2" align="center"| tu_''<username>''
|-
| Universität Ulm
| ul
| colspan="2" align="center"| ul_''<username>''
|}
{| style="border:3px solid darkgray; margin: 5em auto 5em auto;"
|-
!style="width:280px; background-color:darkgray"| [[Registration/HAW|HAW BW e.V.]]
!style="width:60px; background-color:darkgray"| Prefix
!style="width:260px; background-color:darkgray"| Username bwUniCluster/bwForCluster
|-
| Hochschule Aalen
| aa
| align="center"| aa_''<username>''
|-
| Hochschule Albstadt-Sigmaringen
| as
| align="center"| as_''<username>''
|-
| Hochschule Esslingen
| es
| align="center"| es_''<username>''
|-
| Hochschule Heilbronn
| hn
| align="center"| hn_''<username>''
|-
| Hochschule Karlsruhe
| hk
| align="center"| hk_''<username>''
|-
| Hochschule Konstanz (HTWG)
| ht
| align="center"| ht_''<username>''
|-
| Hochschule Mannheim
| mn
| align="center"| mn_''<username>''
|-
| Hochschule Offenburg
| of
| align="center"| of_''<username>''
|-
| Hochschule Reutlingen
| hr
| align="center"| hr_''<username>''
|-
| Hochschule Rottenburg
| ro
| align="center"| ro_''<username>''
|-
| Hochschule Stuttgart (HfT)
| hs
| align="center"| hs_''<username>''
|-
| Hochschule Ulm
| hu
| align="center"| hu_''<username>''
|}

Alternatively, you can log in to the registration service and verify your username online.
To do this, follow the next steps:

1. Select the cluster you want to know your username for: <br /> &rarr; [https://login.bwidm.de '''bwUniCluster 2.0'''] <br /> &rarr; [https://bwservices.uni-tuebingen.de '''BINAC'''] <br /> &rarr; [https://login.bwidm.de '''JUSTUS 2'''] <br /> &rarr; [https://bwservices.uni-heidelberg.de '''MLS&WISO'''] <br /> &rarr; [https://bwservices.uni-freiburg.de '''NEMO''']
2. Select your home organization from the list and click '''Proceed'''.

3. Enter your home-organisational user ID / username and your home-organisational password and click '''Login''' button.

4. You will be redirected back to the registration website.

5. Find the cluster entry and select '''Registry Info'''.
[[File:BwIDM-pw.png|center|frame|Check Registry Info.]]

6. Depending on the registration service, you will see one of the following entries. See '''Username for login''' or '''localUid''' for your username.
[[File:BwIDM-user.png|center|thumb|300px|Username for login.]]
[[File:BwIDM-uid.png|center|thumb|300px|Username for login in ''localUid''.]]


== SSH Clients ==
== SSH Clients ==


After completing the [[Registration|web registration]] and [[Registration/Password|setting a service password]] the HPC cluster is ready for your '''SSH''' based login.
Only the secure shell <code>ssh</code> is allowed for login.
* [[Registration/Login/Client| What Client to Use]]
The following clients are recommended for using the bwHPC clusters.


== Cluster Specific Information ==
For the <code><username></code>, see section "[[Registration/Login#Username|Username]]", for the <code><hostname></code>, see the cluster-specific instructions in section "[[Registration/Login#Hostnames_and_Login_to_bwUniCluster/bwForClusters|Hostnames and Login to bwUniCluster/bwForClusters]]".


Every cluster has its own documentation for login.
* If you want to '''login''' to the bwUniCluster, please refer to <br /> &rarr; '''[[bwUniCluster2.0/Login|bwUniCluster 2.0]]'''
* If you want to '''login''' to one of the bwForClusters, please refer to <br /> &rarr; '''[[BinAC/Login|BINAC]]''' <br /> &rarr; '''[[JUSTUS2/Login|JUSTUS 2]]''' <br /> &rarr; '''[[Helix/Login|Helix]]''' <br /> &rarr; '''[[NEMO/Login|NEMO]]'''


= Allowed Activities on Login Nodes =
=== Command Line SSH ===

Most Unix and Unix-like operating systems like Linux, macOS and *BSD come with a built-in SSH client provided by the OpenSSH project.
More recent versions of Windows 10 using the [https://docs.microsoft.com/en-us/windows/wsl/install Windows Subsystem for Linux] also come with a built-in OpenSSH client.

To use this client, simply open a command line terminal (the exact process differs on every operating system, but usually involves starting an application called '''Terminal''' or '''Command Prompt''') and enter the following command to connect to a cluster:

<pre>
$ ssh <username>@<hostname>
</pre>

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

<pre>
$ ssh -X <username>@<hostname>
</pre>

Windows users requiring X11 forwarding for graphical applications should use '''MobaXterm''' instead.


=== MobaXterm ===

The bwHPC support team recommends to use [http://mobaxterm.mobatek.net/ MobaXterm] instead of ''PuTTY'' or ''WinSCP'' on Windows.
''MobaXterm'' provides a built-in X11 server allowing to start GUI based software.

Select the session type ''ssh''.

Start ''MobaXterm'', fill in the following fields:
<pre>
Remote name : <hostname>
Specify user name : <username>
Port : 22
</pre>

Click 'OK'.
A terminal will be opened and there you can enter your credentials.

=== FileZilla ===

Many GUI applications that support SFTP transfers on Linux don't work well with 2-factor authentication, e.g. Nautilus and Dolphin don't support it.
A good alternative for Linux is FileZilla.

Start FileZilla, Select "File -> Site Manager..." from the main menu and set up a new connection with the following settings:

<pre>
Protocol: SFTP - SSH File Transfer Protocol
Host: <hostname>
Logon Typ: Interactive
User: <username>
</pre>

Then click on the "Connect" button.

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.

== Examples ==

* If you are a member of the University of Konstanz and your local username is <code>ab1234</code>, your username on any bwHPC cluster is <code>kn_ab1234</code>.

* If your local username for the university is <code>vwxyz1234</code> and you are a user from the University of Freiburg and you want to login to the bwUniCluster this would combine to the following SSH command:
ssh fr_vwxyz1234@bwunicluster.scc.kit.edu
Alternatively, you can also use <code>-l</code> for the user name:
ssh -l fr_vwxyz1234 bwunicluster.scc.kit.edu

* KIT users logging into bwUniCluster do not need to use a prefix, but if they are using a bwForCluster. If you are a KIT user and your username is <code>pxd27239</code>, your login names would be for the clusters:
** bwUniCluster: <code>pxd27239</code>
** bwForCluster: <code>ka_pxd27239</code>

=== Example login process for bwUniCluster 2.0 ===

After the connection has been initiated, a successful login process will go through the following three steps:

1. The system asks for a '''One-Time Password'''. Generate one using the Software or Hardware Token registered on the bwIDM system (see [[Registration/2FA]]) and enter it after the '''Your OTP:''' prompt.

2. The systems asks for your service password. Enter it after the '''Password:''' prompt.

3. You are greeted by the bwUniCluster 2.0 banner followed by a shell.

The result should look like this:

[[File:BwUniCluster 2.0 access login example.png|center|thumb|600px|Login example for bwUniCluster 2.0]]

== Allowed Activities on Login Nodes ==


{|style="background:#deffee; width:100%;"
{|style="background:#deffee; width:100%;"
Line 250: Line 32:
|}
|}


The login nodes of the bwHPC clusters are the access point to the compute system, your <code>$HOME</code> directory and your Workspaces.
The login nodes of the bwHPC clusters are the access point to the compute system, your <code>$HOME</code> directory and your workspaces.
These nodes are shared with all the users therefore, your activities on the login nodes are limited to primarily set up your batch jobs.
These nodes are shared with all the users therefore, your activities on the login nodes are limited to primarily set up your batch jobs.
Your activities may also be:
Your activities may also be:
* '''short''' compilation of your program code and
* '''short''' compilation of your program code and
* '''short''' pre- and post-processing of your batch jobs.
* '''short''' pre- and post-processing of your batch jobs.

= Additional Login Information =

Following sub-pages go into deeper detail about the following topics:
* [[Registration/Login/Username|How do I find out my cluster username?]]
* [[Registration/Login/Hostname|What are the hostnames of the login nodes of a cluster?]]
* Configuring your shell: [[.bashrc Do's and Don'ts]]
These pages are also referenced in the cluster-specific login documentations.

Latest revision as of 11:53, 5 November 2024

Login to the Clusters

Attention.svg

Access to the clusters (bwUniCluster/bwForCluster) is restricted to IP addresses of universities/colleges from Baden-Württemberg (BelWü network). If you are outside the BelWü network (e.g. at home), you must first establish a VPN connection to your home university or a connection to an SSH jump host at your home university.

SSH Clients

After completing the web registration and setting a service password the HPC cluster is ready for your SSH based login.

Cluster Specific Information

Every cluster has its own documentation for login.

Allowed Activities on Login Nodes

Attention.svg

To guarantee usability for all the users of clusters you must not run your compute jobs on the login nodes. Compute jobs must be submitted to the queuing system. Any compute job running on the login nodes will be terminated without any notice. Any long-running compilation or any long-running pre- or post-processing of batch jobs must also be submitted to the queuing system.

The login nodes of the bwHPC clusters are the access point to the compute system, your $HOME directory and your workspaces. These nodes are shared with all the users therefore, your activities on the login nodes are limited to primarily set up your batch jobs. Your activities may also be:

  • short compilation of your program code and
  • short pre- and post-processing of your batch jobs.

Additional Login Information

Following sub-pages go into deeper detail about the following topics:

These pages are also referenced in the cluster-specific login documentations.

Retrieved from "https://wiki.bwhpc.de/wiki/index.php?title=Registration/Login&oldid=13148"