BwUniCluster 2.0 User Access New: Difference between revisions

From bwHPC Wiki
Jump to navigation Jump to search
(Created page with "<!--{| style="border-style: solid; border-width: 1px" ! Navigation: bwHPC BPR / bwUniCluster |}--> bwUniClus...")
 
m (Redirected page to Registration/bwUniCluster)
Tag: New redirect
 
(14 intermediate revisions by 2 users not shown)
Line 1: Line 1:
#REDIRECT [[Registration/bwUniCluster]]
<!--{| style="border-style: solid; border-width: 1px"
! Navigation: [[BwHPC_Best_Practices_Repository|bwHPC BPR]] / [[BwUniCluster_User_Guide|bwUniCluster]]
|}-->
[[bwUniCluster_2.0|bwUniCluster 2.0]] is Baden-Württemberg's general purpose tier 3 high performance computing (HPC)
cluster co-financed by Baden-Württemberg's ministry of science, research and arts and the shareholders:

* Albert Ludwig University of Freiburg
* Eberhard Karls University, Tübingen
* Karlsruhe Institute of Technology (KIT)
* Heidelberg University (Ruprecht-Karls-Universität Heidelberg)
* Ulm University
* University of Hohenheim
* University of Konstanz
* University of Mannheim
* University of Stuttgart
* HAW BW e.V. (an association of university of applied sciences in Baden-Württemberg)
<br>
To '''log on''' [[bwUniCluster_2.0|bwUniCluster 2.0]] a user account is required. All members of the shareholder
universities can apply for an account.
<br>


{| style="width: 100%; border-spacing: 5px;"
| style="text-align:left; color:#000;vertical-align:top;" |__TOC__
|<br><br>[[File:bwUniCluster_17Jan2014_p044-rot_t10.10.00.jpg|center|border|250px|bwUniCluster wiring by Holger Obermaier, copyright: KIT (SCC)]] <span style="font-size:80%">bwUniCluster wiring © KIT (SCC)</span>
|}

= Registration =

Granting access and issuing a user account for '''bwUniCluster 2.0''' requires the registration at the KIT service website [https://bwidm.scc.kit.edu/ https://bwidm.scc.kit.edu] (step B). However, this registration depends on the '''bwUniCluster entitlement''' issued by your university (step A).
<br>

== Step A: bwUniCluster entitlement for registration ==
'''The entitlement is called bwUniCluster (not bwUniCluster 2.0)''' and each university issues the bwUniCluster entitlement '''only''' for their own respective members. Some have established on-line processes or provide downloads of the entitlement application forms. If there is no link behind the name of an institution in the following list, please contact the local IT support services:

* [[BwCluster_User_Access_Uni_Freiburg|Albert Ludwig University of Freiburg]]
* [https://bwunicluster.urz.uni-heidelberg.de/ Heidelberg University]
* [https://kim.uni-hohenheim.de/bwhpc-account University of Hohenheim]
* [http://www.scc.kit.edu/downloads/sdo/Antrag_Benutzernummer_bwUniCluster.pdf Karlsruhe Institute of Technology (KIT)]
* [[BWUniCluster_User_Access_Members_Uni_Konstanz|University of Konstanz]]
* [[BWUniCluster_User_Access_Members_Uni_Mannheim|University of Mannheim]]
* [https://www.hlrs.de/solutions-services/academic-users/bwunicluster-access/ University of Stuttgart]
* [http://www.zdv.uni-tuebingen.de/dienstleistungen/computing/anmeldung/bwunicluster.html Eberhard Karls University Tübingen]
* [[BWUniCluster_User_Access_Members_Uni_Ulm|Ulm University]]
* Hochschule Aalen
* Hochschule Albstadt-Sigmaringen
* Hochschule Esslingen
* Hochschule Furtwangen
* Hochschule Karlsruhe
* Hochschule Konstanz
* Hochschule Reutlingen
* Hochschule Rottenburg
* Hochschule Stuttgart (HfT)
* Hochschule Ulm
<br>

== Step B: Web Registration, service password and 2-factor authentication ==

After completing step A, i.e., after successfull issueing of the bwUniCluster entitlement, you have to register yourself for the service. To do so please visit [https://bwidm.scc.kit.edu/ https://bwidm.scc.kit.edu] and complete the following steps.

1. Select your home organization from the list on the main page and click '''Proceed''' or '''Fortfahren'''.

[[File:BwUniCluster 2.0 access login bwidm select institution.png|center|border|]]

2. You will be directed to the ''Identity Provider'' of your home organisation. Enter the user ID / username and password of your home organisation - this is usually the same password used for your e-mail account and other services - and click on '''Login''', '''Einloggen''' or something similar.

3. You will be redirected back to the registration website [https://bwidm.scc.kit.edu/ https://bwidm.scc.kit.edu/]. If you are logging into bwIDM for the first time, there will be a summary screen which shows the account details your home institution is providing to the central system. Please check that all data is valid and then click on '''Continue''' or '''Weiter'''.

4. Once you have successfully logged into the bwIDM system, you will be greeted by a home screen showing all state-wide services you have access to. There will be a box labelled "bwUniCluster". Click on '''Register''' or '''Registrieren''' to start the registration process.

[[File:BwUniCluster 2.0 access login bwidm service list.png|center|border|]]

5. Make sure that all requirements are met to register for the service by checking the '''Requirements''' box at the top. If the requirements are not met you might be able to correct the issure by following the instructions, in all other cases please contact the operations team through the [[http://www.support.bwhpc-c5.de/ Support channels]].

[[File:BwUniCluster 2.0 access login bwidm registration requirements.png|center|border|]]

6. Read the Terms of Use ('''Nutzungsbedingungen und -richtlinien'''), check the box besides '''I have read and accepted the terms of use''' and click on '''Register''' or '''Registrieren'''.

7. Set a service password for the bwUniCluster. Logging in with the password of your home organisation, like on the former bwUniCluster 1, is no longer possible. Please make sure to use a strong password which is different from any other password you are currently using or have used on other systems. You will also be asked to change the service password regularly.

[[File:BwUniCluster 2.0 access login bwidm service password.png]]



<!-- old description
** login with your home-organizational user account and user password,
** select service '''''bwUniCluster''''' (on the left side) and
** follow the instructions to complete the registration.
-->
<br/>

== Step C: <span style="color:red;font-size:100%;font-weight:bold">Amendment:</span> bwUniCluster questionnaire ==
Starting June 1st, 2015, usage of bwUniCluster mandatorily requires the
questionnaire

https://zas.bwhpc.de/shib/en/bwunicluster_survey.php

to be answered. The input is solely used for the
elaboration of future support activities and for planning future HPC
resources. From June 1st, 2015, login to bwUniCluster 2.0 is only permitted
to users who have already answered the questionnaire. '''''Exception''': For the first 14 days after the web registration login to bwUniCluster 2.0 is permitted without participation in the questionnaire.''
<br>
<br>

== Changing Password ==
Your bwUniCluster 2.0 '''password''' is the service password you set during the web registration (compare step 7 of chapter 1.2). At any time, you can set a new bwUniCluster 2.0 password via the registration website [https://bwidm.scc.kit.edu/ https://bwidm.scc.kit.edu] by carrying out the following steps:
# visit [https://bwidm.scc.kit.edu/ https://bwidm.scc.kit.edu] and select your home organization
# authenticate yourself via your home-organizational user id / username and your home-organizational password
# find on the left side '''bwUniCluster''' and select '''Set Service Password'''
# set new service, i.e. bwUniCluster, password, repeat it and click '''Save''' button.
# the page answers e.g. "Das Passwort wurde bei dem Dienst geändert" ("password has been changed")
# proceed to log in using the new password in the next step
<br>

== Contact ==
If you have questions or problems concerning bwUniCluster (2.0) registration, please [[Registration_Support_-_bwUniCluster|contact your local hotline]].
<br>

= Establishing network access =

Access to bwUniCluster 2.0 is limited to IP addresses from within the campus networks of the respective home institutions of our current users. If you are outside of one of these networks (e.g. in your home office instead of in your campus office), a VPN connection to your home institution has to be established first (see e.g. [1] for the KIT).

= Login =

After finishing the web registration and making sure that you have access to a network from which you have access to bwUniCluster 2.0 (e.g. by establishing a VPN connection), the HPC cluster is ready for your '''SSH''' based login. Available SSH applications are:

* built-in command under Linux and macOS using the application ''terminal''
* [http://mobaxterm.mobatek.net/ MobaXterm] under Windows

bwUniCluster 2.0 has four + two dedicated login nodes. The selection of the login node is done automatically and is based on a round-robin scheduling. Logging in another time the session might run
on the other login node.

Only the secure shell ''SSH'' is allowed to login. Other protocols like ''telnet'' or ''rlogin''
are not allowed for security reasons.

== Login applications: Linux and macOS ==

A connection to bwUniCluster 2.0 can be established by the command:

<pre>
$ ssh <UserID>@bwunicluster.scc.kit.edu # or
$ ssh <UserID>@uc2.scc.kit.edu # Login on a Cascade-Lake-node - or
$ ssh <UserID>@uc1e.scc.kit.edu # Login on a Broadwell-node
</pre>

If you are using ''openSSH'' (usually installed on Linux based systems) and you want to use a GUI-based application on bwUniCluster 2.0 you should use the
''ssh'' command with the option ''-X''

<pre>
$ ssh -X <UserID>@bwunicluster.scc.kit.edu # or
$ ssh -X <UserID>@uc2.scc.kit.edu # or
$ ssh -X <UserID>@uc1e.scc.kit.edu
</pre>

== Login applications: Windows ==

=== Hints for using MobaXterm ===

Note: The bwHPC-C5 support team strongly recommends to use [http://mobaxterm.mobatek.net/ MobaXterm] instead of ''PuTTY'' or ''WinSCP''. ''MobaXterm'' provides a X11 server allowing to start GUI based software.
Start ''MobaXterm'', fill in the following fields:
<pre>
Remote name : uc2.scc.kit.edu # or uc1e.scc.kit.edu
Specify user name : <UserID>
Port : 22
</pre>
After that click on 'ok'. Then a terminal will be opened and there you can enter your password.

=== Deprecated: Hints for using PuTTY ===
Start PuTTY, fill in at window ''PuTTY Configuration'' under category ''Session'' the following fields
<pre>
Host Name : <UserID>@uc2.scc.kit.edu # or <UserID>@uc1e.scc.kit.edu
Port : 22
Connection type : SSH
</pre>
and click on ''Open'', enter your password and accept adding ''host key''. Note that you can also name the configured session via ''Save'' and load it later via the given name.

=== Deprecated: Hints for using WinSCP ===

Start WinSCP, fill in the following fields:
<pre>
File Protocol : SCP
Host name : uc2.scc.kit.edu # or uc1e.scc.kit.edu
Port : 22
User name : <UserID>
</pre>
and click on 'Login' and enter your password. Note that you can also name the configured session via ''Save'' and load it later via the given name.

== About UserID / Username ==

'''<UserID>''' of the ssh command is a placeholder for your '''''username''''' at your home
organization together with a '''''prefix''''' as followed:

{| width=450px class="wikitable"
! Home organization !! <UserID>
|-
| Universität Freiburg || ''fr_''username
|-
| Universität Heidelberg || ''hd_''username
|-
| Universität Hohenheim || ''ho_''username
|-
| KIT || username ''(without any prefix)''
|-
| Universität Konstanz || ''kn_''username
|-
| Universität Mannheim || ''ma_''username
|-
| Universität Stuttgart || ''st_''username
|-
| Universität Tübingen || ''tu_''username
|-
| Universität Ulm || ''ul_''username
|-
| Hochschule Aalen || ''aa_''username
|-
| Hochschule Albstadt-Sigmaringen || ''as_''username
|-
| Hochschule Esslingen || ''es_''username
|-
| Hochschule Furtwangen || ''hf_''username
|-
| Hochschule Karlsruhe || ''hk_''username
|-
| HTWG Konstanz || ''ht_''username
|-
| Hochschule Reutlingen || ''hr_''username
|-
| Hochschule Rottenburg || ''ro_''username
|-
| Hochschule für Technik Stuttgart || ''hs_''username
|-
| Hochschule Ulm || ''hu_''username
|-
|}

== Allowed activities on login nodes ==

The login nodes of bwUniCluster 2.0 are the access point to the compute system and to your bwUniCluster 2.0 $HOME directory. The login nodes are shared with all the users of bwUniCluster 2.0. 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 postprocessing of your batch jobs.

To guarantee usability for all the users of bwUniCluster 2.0 <span style="color:red;font-size:100%;">'''you must not run your compute jobs on the login nodes'''</span>. Compute jobs must be submitted to the
[[bwUniCluster Batch Jobs|queueing 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 postprocessing of batch jobs must also be submitted to the [[bwUniCluster Batch Jobs|queueing system]].
<br>

= [[First_Steps_on_bwHPC_cluster|First steps on bwUniCluster]] =

First and some important steps on bwUniCluster 2.0 can be found [[First_Steps_on_bwHPC_cluster|here]].


= Deregistration =
If you plan to permanently leave the bwUniCluster 2.0, follow the deregister checklist:
# Transfer all your data in $HOME and workspace to your local computer/storage and after that clear off all your data
# Visit [https://bwidm.scc.kit.edu/ https://bwidm.scc.kit.edu]
#* Select your home organization from the list and click '''Proceed'''
#* Enter your home-organisational user ID / username and your home-organisational password and click '''Login''' button
#* You will be redirected back to the registration website [https://bwidm.scc.kit.edu/ https://bwidm.scc.kit.edu/]
#* <div>Select '''Registry Info''' of the service '''bwUniCluster''' (on the left hand side)<br>[[File:bwUniCluster_registration_sidebar.png|center|border|]]</div>
#* Click '''Deregister'''
Note that Step 2 will automatically unsubscribe you from the bwunicluster mail list.


----
[[Category:bwUniCluster_2.0|Access]][[Category:Access|bwUniCluster 2.0]]

Latest revision as of 16:12, 24 February 2022