Registration/bwForCluster/Helix: Difference between revisions

From bwHPC Wiki
Jump to navigation Jump to search
(Created page with "= Registration for bwForCluster Helix = {|style="background:#deffee; width:100%;" |style="padding:5px; background:#cef2e0; text-align:left"| Image:Attention.svg|center|25px...")
 
(Added troubleshooting and set new password sections)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
__FORCETOC__
⚫
= Registration for bwForCluster Helix =


== Prerequisites ==
⚫
{|style="background:#deffee; width:100%;"
⚫
|style="padding:5px; background:#cef2e0; text-align:left"|
[[Image:Attention.svg|center|25px]]
|style="padding:5px; background:#cef2e0; text-align:left"|
You can return to the registration website at any time, in order to review your registration details, change/reset your service password or de-register from the service by yourself.
|}


After having completed steps A+B please visit the '''[https://bwservices.uni-heidelberg.de bwForCluster Helix registration page]'''.
Steps A + B in the [[Registration/bwForCluster | registration process]] must be finished.


⚫
== Registration Steps ==
Do the following steps to complete registration:


# Visit the bwForCluster Helix '''[https://bwservices.uni-heidelberg.de registration page bwServices]'''.
⚫
1. Select your home organization from the list on the main page and click '''Proceed''' or '''Fortfahren'''.
[[File:BwIDM-login.png|center|600px|thumb|Select your home organization]]
#: [[File:bwServices_chooseHomeOrganisation.png|right|300px|thumb|Select your home organization]]
⚫
# '''Select your home organization''' from the list on the main page and click Proceed/Fortfahren. You will be directed to the ''Identity Provider'' of your home organization.

2. You will be directed to the ''Identity Provider'' of your home organization.
# Enter the '''username and password''' of your home organization (usually these credentials are also used for other services like email) and click Login/Einloggen.
⚫
# When you log in to bwServices for the first time, an overview will appear, with the account information that your home institution submits to the system. Please verify that all data is valid and then click ''Continue/Weiter''.
Enter the username and password of your '''home organization''' (usually these credentials are also used for other services like email) and click '''Login/Einloggen'''.
# You will be redirected back to the bwServices main page. It shows all the statewide services you have access to. Click '''Register/Registrieren''' under the field labeled ''bwForCluster Helix''.

⚫
#: [[File:BwIDM-reg.png|center|frame|Register for Helix]]
3. You will be redirected back to the registration page '''https://bwservices.uni-heidelberg.de'''.
⚫
# bwForCluster Helix uses a '''2-factor authentication''' (2FA) mechanism to increase security.
⚫
When you log in to bwServices for the first time, an overview will appear, with the account information that your home institution submits to the system.
⚫
#: If you have never registered a 2FA token on bwIDM, the following error message will appear:
Please verify that all data is valid and then click '''Continue/Weiter'''.
⚫
#: [[File:Bwidm-3-red.png|center|600px|thumb|Second factor missing.]]

⚫
#: Use this '''[https://bwservices.uni-heidelberg.de/user/twofa.xhtml link]''' or select '''My Tokens''' in the main menu.
4. After you have successfully logged into the bwServices, you will be greeted by a welcome screen that displays all the statewide services you have access to.
⚫
#: To register a new token, please follow these '''[[Registration/2FA|instructions]]'''.
There you will find a field labeled '''bwForCluster Helix'''.
⚫
#: Please complete this step before continuing.
Click '''Register/Registrieren''' to start the registration process.
⚫
# Read the Terms of Use / Nutzungsbedingungen, place a check mark next to ''I have read and accepted the terms of use'' and click ''Register/Registrieren''.
⚫
[[File:BwIDM-reg.png|center|frame|Register for Helix]]
⚫
# '''Set a service password''' for bwForCluster Helix and click ''Save/Speichern''.
{|style="background:#ffeaef; width:100%;"
⚫
#: Be sure to use a secure password that is different from any other passwords you currently use or have used on other systems.
|style="padding:5px; background:#ffeaef; text-align:left"|
⚫
[[File:BwIDM-passwd.png|center|600px|thumb|Set service password]]
⚫
{|style="background:#deffee; width:70%; margin: auto;"
⚫
|style="padding:5px; background:#cef2e0; text-align:left"|
[[Image:Attention.svg|center|25px]]
[[Image:Attention.svg|center|25px]]
|style="padding:5px; background:#ffeaef; text-align:left"|
|style="padding:5px; background:#cef2e0; text-align:left"|
The service password is your private password for accessing the bwForCluster Helix. Don't ever share it with anyone!
If you do not meet all the necessary requirements for a service, this will be shown on the registry page.
In this case please contact the service desk of your home organisation.
In some cases further information is given and should be executed or provided in your support ticket.
|}
|}


== Registration Website bwServices ==
⚫
5. bwForCluster Helix uses a '''2-factor authentication''' (2FA) mechanism to increase security.
The registration website '''[https://bwservices.uni-heidelberg.de bwServices]''' offers the following functionality:
⚫
If you have never registered a 2FA token on bwIDM, the following error message will appear:
* Register for the service
⚫
[[File:Bwidm-3-red.png|center|600px|thumb|Second factor missing.]]
* Set or change your service password
* Review your registration details
* Triggers an update of your user information upon login.
* De-register from the service


=== Troubleshooting with the Help of bwServices ===
⚫
Use this '''[https://bwservices.uni-heidelberg.de/user/twofa.xhtml link]''' or select '''My Tokens''' in the main menu.
When encountering connection issues with a service, the bwServices website is a good starting point for troubleshooting:
⚫
To register a new token, please follow these '''[[Registration/2FA|instructions]]'''.
* '''Issue:''' No access to state services like the bwHPC clusters or SDS@hd because of an expired contract or inactive student id.
⚫
Please complete this step before continuing.
** You can see that this is the issue when the login to bwServices via your identity provider is not possible.
* '''Issue:''' Your id at your home organization was (re)activated a short time ago but this change didn't get through to the bwHPC cluster or SDS@hd service.
** The login to bwServices triggers an update of your user information. Some minutes later, the connection to the service should work.
* '''Issue:''' Some prerequisites like entitlement ownership or RV membership are not met (anymore).
** You can see the concrete issue and advice on how to move forward when looking at the registry info of the service on the bwServices website.
* '''Issue:''' When trying to connect to the service, the service password is not accepted.
** At bwServices a [[#Setting_a_New_Service_Password | new password]] can be set for the service.


=== Setting a New Service Password ===
⚫
6. Read the Terms of Use ('''Nutzungsbedingungen und -richtlinien'''), place a check mark next to '''I have read and accepted the terms of use''' and click '''Register/Registrieren'''.


At any time, you can set a new service password via [https://bwservices.uni-heidelberg.de/ bwServices] by carrying out the following steps:
⚫
7. Set a service password for Helix and click '''Save/Speichern'''.
# Visit [https://bwservices.uni-heidelberg.de/ bwServices] and select your home organization.
⚫
Be sure to use a secure password that is different from any other passwords you currently use or have used on other systems.
# Authenticate yourself via your home-organizational user id / username and your home-organizational password.
⚫
[[File:BwIDM-passwd.png|center|600px|thumb|Set service password]]
# Find your service and select '''Set Service Password'''.
{|style="background:#deffee; width:100%;"
# Set new service password, repeat it and click the '''Save''' button.
|style="padding:5px; background:#cef2e0; text-align:left"|
# The page answers e.g. "password has been changed".
[[Image:Attention.svg|center|25px]]
|style="padding:5px; background:#cef2e0; text-align:left"|
Setting a service password is mandatory for access to any bwForCluster.
|}

Latest revision as of 10:52, 8 October 2025


Prerequisites

Steps A + B in the registration process must be finished.

Registration Steps

  1. Visit the bwForCluster Helix registration page bwServices.
    Select your home organization
  2. Select your home organization from the list on the main page and click Proceed/Fortfahren. You will be directed to the Identity Provider of your home organization.
  3. Enter the username and password of your home organization (usually these credentials are also used for other services like email) and click Login/Einloggen.
  4. When you log in to bwServices for the first time, an overview will appear, with the account information that your home institution submits to the system. Please verify that all data is valid and then click Continue/Weiter.
  5. You will be redirected back to the bwServices main page. It shows all the statewide services you have access to. Click Register/Registrieren under the field labeled bwForCluster Helix.
    Register for Helix
  6. bwForCluster Helix uses a 2-factor authentication (2FA) mechanism to increase security.
    If you have never registered a 2FA token on bwIDM, the following error message will appear:
    Second factor missing.
    Use this link or select My Tokens in the main menu.
    To register a new token, please follow these instructions.
    Please complete this step before continuing.
  7. Read the Terms of Use / Nutzungsbedingungen, place a check mark next to I have read and accepted the terms of use and click Register/Registrieren.
  8. Set a service password for bwForCluster Helix and click Save/Speichern.
    Be sure to use a secure password that is different from any other passwords you currently use or have used on other systems.
Set service password
Attention.svg

The service password is your private password for accessing the bwForCluster Helix. Don't ever share it with anyone!

Registration Website bwServices

The registration website bwServices offers the following functionality:

  • Register for the service
  • Set or change your service password
  • Review your registration details
  • Triggers an update of your user information upon login.
  • De-register from the service

Troubleshooting with the Help of bwServices

When encountering connection issues with a service, the bwServices website is a good starting point for troubleshooting:

  • Issue: No access to state services like the bwHPC clusters or SDS@hd because of an expired contract or inactive student id.
    • You can see that this is the issue when the login to bwServices via your identity provider is not possible.
  • Issue: Your id at your home organization was (re)activated a short time ago but this change didn't get through to the bwHPC cluster or SDS@hd service.
    • The login to bwServices triggers an update of your user information. Some minutes later, the connection to the service should work.
  • Issue: Some prerequisites like entitlement ownership or RV membership are not met (anymore).
    • You can see the concrete issue and advice on how to move forward when looking at the registry info of the service on the bwServices website.
  • Issue: When trying to connect to the service, the service password is not accepted.

Setting a New Service Password

At any time, you can set a new service password via bwServices by carrying out the following steps:

  1. Visit bwServices and select your home organization.
  2. Authenticate yourself via your home-organizational user id / username and your home-organizational password.
  3. Find your service and select Set Service Password.
  4. Set new service password, repeat it and click the Save button.
  5. The page answers e.g. "password has been changed".
Retrieved from "https://wiki.bwhpc.de/wiki/index.php?title=Registration/bwForCluster/Helix&oldid=15324"