Registration/bwForCluster/RV: Difference between revisions

From bwHPC Wiki
Jump to navigation Jump to search
(Added instructions for the error "This project is not currently renewed" when joining as coworker)
 
(20 intermediate revisions by 3 users not shown)
Line 1: Line 1:
= Step B: Apply for a Rechenvorhaben/Project =
= Step B: Apply for a Rechenvorhaben/Project =


Rechenvorhaben/Projects (RV) are required for assignment to a bwForCluster.
'''Rechenvorhaben/Projects (RV)''' are required for assignment to a bwForCluster.
The [https://www.bwhpc.de/bwhpc-domains.php research area] of the group as well as the software and hardware requirements are taken into account.
The [https://www.bwhpc.de/bwhpc-domains.php research area] of the group as well as the software and hardware requirements are taken into account.
A research group may decide to split its research among several RV if it sees the need to do so.
A research group may decide to split its research among several RV if it sees the need to do so.
However, this does not mean that another RV is assigned to another cluster.
However, this does not mean that another RV is assigned to another cluster.
A RV should be registered by a leader or senior scientist of a research group/collaboration.
A RV should be registered by a leader or senior scientist of a research group/collaboration.
Any number of co-workers can then join your RV to work with the cluster.
Any number of coworkers can then join your RV to work with the cluster.


To apply for a RV simply answer this simple question:
To apply for a RV simply answer this simple question:
Line 13: Line 13:
** '''No → [[Registration/bwForCluster/RV#Register_a_new_RV|Register a new RV]]'''
** '''No → [[Registration/bwForCluster/RV#Register_a_new_RV|Register a new RV]]'''


= Become Coworker of a RV =


{|style="background:#deffee; width:100%;"
== Register a new RV ==
|style="padding:5px; background:#cef2e0; text-align:left"|
[[Image:Attention.svg|center|25px]]
|style="padding:5px; background:#cef2e0; text-align:left"|
You can only sign up for an RV once.
If you are an inactive member of an RV, either because you de-registered yourself or a manager deactivated you, only an RV manager can reactivate you.
|}


{| style="width: 100%;"
The application form for a new RV will ask you to shortly describe your group's compute activities and the resources you need.
| The "RV responsible" will provide you with the following data on the RV:
* RV acronym
* RV password


If this information is lost, please let the "RV responsible" [[Registration/bwForCluster/RV#Renew_RV_Password|renew the password]] for the RV.
If you register your own RV, you will be:
# held accountable for the co-workers in the RV
# asked to provide information for the two reports required by the DFG for their funding of bwForClusters
# likely asked for a contribution to a future DFG grant proposal for a new bwForCluster in your area of research ("wissenschaftliches Beiblatt")


To become coworker of an RV, follow these simple steps:
Please follow the steps at [[Registration/bwForCluster/NewRV|'''Register a new RV''']].


1. Please visit the [https://zas.bwhpc.de/shib/en/bwforcluster_collaboration.php '''RV collaboration'''] web form at the [https://zas.bwhpc.de ZAS].
[[File:RV-collab.png|center|frame|RV collaboration.]]


2. Select your home organization from the list on the main page and click '''Proceed''' or '''Fortfahren'''.
== Become Coworker of a RV ==
[[File:BwIDM-login.png|center|400px|thumb|Select your home organization]]


3. You will be directed to the ''Identity Provider'' of your home organization.
{| style="width: 100%;"
Enter the username and password of your '''home organization''' (usually these credentials are also used for other services like email) and click '''Login/Einloggen'''.
| The "RV responsible" will provide you with the following data on the RV:
* acronym
* password


4. You will be redirected back to the RV collaboration form '''https://zas.bwhpc.de/shib/en/bwforcluster_collaboration.php'''.
If this information is lost, please let the "RV responsible" [[Registration/bwForCluster/NewRV#Renew_RV_Password|renew the password]] for the RV.


5. Enter '''RV Acronym''', '''RV Password''' and '''Institute''' into the form and check both "Terms of Use".
To become coworker of an RV, please login at
Click '''Send'''.
* [https://zas.bwhpc.de/shib/en/bwforcluster_collaboration.php '''RV collaboration''']
and provide acronym and password.
[[File:RV-collab.png|center|frame|Become Coworker of a RV.]]


You will be assigned to the RV as a new member.
6. You will be assigned to the RV as a new member.
<div style="padding-left:18px;">
[[Image:Attention.svg|left|15px]]
In case of the <span style="color:red;">error</span> "This project is not currently renewed", please ask the RV responsible to apply for a prolongation of the RV. As soon as the prolongation was accepted, you can join the RV.
</div>


After submitting the request you will receive an email from ZAS about the further steps.
After submitting the request you will receive an email from ZAS about the further steps.
The RV owner and any managers will be notified automatically.
RV owner and RV managers will be notified automatically.


| [[File:RV-formcol.png|center|400px|thumb|Collaboration Form for existing RV.]]
| [[File:RV-formcol.png|center|400px|thumb|Become Coworker of a RV.]]
|}
|}


== My RVs ==
= Register a new RV=


A RV should be registered by a leader or senior scientist of a research group/collaboration.
You will be:
* held accountable for the coworkers in the RV
* asked to provide information for the two reports required by the DFG for their funding of bwForClusters
* likely asked for a contribution to a future DFG grant proposal for a new bwForCluster in your area of research ("wissenschaftliches Beiblatt")

To apply for a new RV, follow these steps:

1. Please visit the [https://zas.bwhpc.de/shib/en/bwforcluster_proposal.php '''RV registration'''] web form at the [https://zas.bwhpc.de ZAS].
[[File:RV-reg.png|center|frame|Register a new RV.]]

2. Select your home organization from the list on the main page and click '''Proceed''' or '''Fortfahren'''.
[[File:BwIDM-login.png|center|400px|thumb|Select your home organization]]

3. 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'''.

4. You will be redirected back to the RV registration form '''https://zas.bwhpc.de/shib/en/bwforcluster_proposal.php'''.

5. Fill in all mandatory fields of the form and tick the two "Terms of use".
Detailed information on the individual fields can be found in the section [[Registration/bwForCluster/RV#Registration_Form_Details|Registration Form Details]].
Click '''Preview'''.

6. If the information is correct, click '''Submit''', otherwise you can customize your application.

7. Go to section [[Registration/bwForCluster/RV#Registration_Response|Registration Response]] for the next steps.

Please note that for your convenience you can also switch to the [https://zas.bwhpc.de/shib/bwforcluster_proposal.php German version] of the web form.
The submitter of the RV will be assigned the role "RV responsible" (see [[Registration/bwForCluster/RV#Roles_in_a_RV|Roles in a RV]]).


== Registration Form Details ==

The web form consists of the following fields.
Note that the fields - name, given name, organization, mail, and EPPN - are auto-filled and can not be changed.
These are your credentials as given by your home organization.

{| style="width:100%;border:3px solid darkgray; margin: 1em auto 1em auto;"
|-
! style="width:20%;padding:2px;margin:3px; background:#AAA; font-size:100%; font-weight:bold; border:1px solid #BBBBBB; text-align:left; color:#000; padding:0.2em 0.4em;"| Field
! style="padding:2px;margin:3px; background:#AAA; font-size:100%; font-weight:bold; border:1px solid #BBBBBB; text-align:left; color:#000; padding:0.2em 0.4em;" | Explanation
|rowspan="15"| [[File:RV-form.png|center|400px|thumb|Registering a new RV.]]
|-
!scope="column" {{Lightgray_small}}| RV Title
|scope="column" {{Tab element}} | Define a short title of your planned compute activities, maximum of 255 characters including spaces.
|-
!scope="column" {{Lightgray_small}}| RV Description
|scope="column" {{Tab element}} | Write a short abstract about your planned compute activities (maximum of 2048 characters including spaces). Research groups that contributed to the DFG grant proposal (Art. 91b GG) of the corresponding bwForCluster only need to give reference to that particular proposal.
|-
!scope="column" {{Lightgray_small}}| Scientific field
|scope="column" {{Tab element}} | Tick one or several scientific fields. Once all bwForClusters are up and running the full list of given scientific fields are supported and hence for RV applicable. If your RV does not match any given scientific field, please state your scientific field in the given text box. Grayed out scientific fields indicate that the corresponding bwForCluster(s) is/are not operational yet.
|-
!scope="column" {{Lightgray_small}}| Field of activity
|scope="column" {{Tab element}} | Define if your RV is primarily for research and/or teaching. If not applicable, use text box.
|-
!scope="column" {{Lightgray_small}}| Parallel paradigm
|scope="column" {{Tab element}} | State what parallel paradigm your code or application uses. Multiple ticks are allowed. Further information can be provided via text box. If you are not sure about it, please state the software you are using.
|-
!scope="column" {{Lightgray_small}}| Programming language
|scope="column" {{Tab element}} | State the programming language(s) of your code or application.
|-
!scope="column" {{Lightgray_small}}| Numerical methods
|scope="column" {{Tab element}} | State the numerical or "calculation" methods your code or application utilizes. If you do not know, write "unknown".
|-
!scope="column" {{Lightgray_small}}| Software packages
|scope="column" {{Tab element}} | State all software package you will or want to use for your RV. Also include compiler, MPI and numerical packages (e.g. MKL, FFTW).
|-
!scope="column" {{Lightgray_small}}| Estimated requested computing resources
|scope="column" {{Tab element}} | Roughly estimate how many CPU hours are required to finish your RV. To calculate "CPU hours" multiply "elapsed parallel computing time" with "number of CPU core" per job.
''Example: Your code uses 4 CPU cores and has a wall time of 1h. This makes 4 CPU hours.''
|-
!scope="column" {{Lightgray_small}}| Planned maximum number of parallel used CPU cores per job
|scope="column" {{Tab element}} | Give an upper limit of how many CPU cores per job are required. Please cross-check with your statement about parallel paradigm.
''Obviously, a sequential code can only use 1 CPU core per job.''
|-
!scope="column" {{Lightgray_small}}| Estimated maximal memory requirements per CPU core
|scope="column" {{Tab element}} | Give an upper limit of how much RAM per CPU core your jobs require. Please give a value in Gigabytes.
|-
!scope="column" {{Lightgray_small}}| Estimated requested persistent disk space for the RV
|scope="column" {{Tab element}} | State how much disk space in total you need for your RV. Please give a value in Gigabytes.
''Example: If your RV has 4 more coworker and each of you produces until the end of your RV 20 Gigabyte of output, your maximum disk space is 100 Gigabyte.''
|-
!scope="column" {{Lightgray_small}}| Estimated maximal temporary disk space per job
|scope="column" {{Tab element}} | State how much space your intermediate files require during a job run. Please give a value in Gigabytes.
''Example: Your final output of your job is 0.1 Gigabyte, but during your job 10 temporary files, each with a size of 1 Gigabyte, are written to disk, hence your correct answer is 10 Gigabyte.''
|-
!scope="column" {{Lightgray_small}}| Institute
|scope="column" {{Tab element}} | State the full name of your Institute.
|-
|}


== Registration Response ==

After submitting you will get an email from the ZAS confirming your submission.
With this email you are given an unique
* RV acronym
* RV password

Please keep the password enclosed.
With RV acronym and password, [[Registration/bwForCluster/RV#Become_Coworker_of_a_RV| coworkers ]] can already associate themselves to the RV.
If this information is lost, please [[Registration/bwForCluster/RV#Renew_RV_Password|renew the password]] for the RV.

The cluster assignment team assigns a bwForCluster to your RV based on your submitted data, including the [https://www.bwhpc.de/bwhpc-domains.php research area] as well as the software and hardware requirements.
The ZAS notifies you in an email about your assigned bwForCluster and provides website details for [[Registration/bwForCluster/Service| Step C]].

= My RVs =

{|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"|
If you de-register from a RV, only a RV responsible or manager can activate (register) you again.
|}
You can see your RV memberships at [https://zas.bwhpc.de/shib/en/info_rv.php '''My RVs'''].
You can see your RV memberships at [https://zas.bwhpc.de/shib/en/info_rv.php '''My RVs'''].
[[File:RV-my.png|left|frame|My RVs.]]
[[File:RV-my.png|center|frame|My RVs.]]


= Renew RV Password =

If you lose the RV password or want to create a new one, you can simply renew it:

1. Login to [https://zas.bwhpc.de/shib/en/info_rv.php '''My RVs'''] first.
[[File:RV-my.png|center|frame|My RVs.]]

2. Select the RV acronym for your RV.

3. Scroll down and click '''Renew password'''.
[[File:RV-pw.png|center|thumb|400px|Renew RV password.]]

= Duration of an RV =

A RV is valid for '''one year'''.
After that, the RV responsible must apply for an extension of the RV for it to be renewed for another year.


= Roles in a RV =

{|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"|
Once a member is inactive, only a RV responsible or manager can re-activate this member.
|}
The RV Responsible can assign managers to activate and deactivate coworkers.
RV responsible and RV managers can check the list of RV members at [https://zas.bwhpc.de/shib/en/info_rv.php '''My RVs'''] by selecting the RV acronym.
After a role change, click '''Save changes''' at the end of the members list.
[[File:RV-my.png|center|frame|My RVs.]]

{| style="width:100%;border:3px solid darkgray; margin: 1em auto 1em auto;"
|-
! style="width:20%;padding:2px;margin:3px; background:#AAA; font-size:100%; font-weight:bold; border:1px solid #BBBBBB; text-align:left; color:#000; padding:0.2em 0.4em;"| Role
! style="padding:2px;margin:3px; background:#AAA; font-size:100%; font-weight:bold; border:1px solid #BBBBBB; text-align:left; color:#000; padding:0.2em 0.4em;" | Explanation
|rowspan="4"| [[File:RV-member.png|center|400px|thumb|Roles in a RV.]]
|-
!scope="column" {{Lightgray_small}}| RV responsible
|scope="column" {{Tab element}} | Registers and extends the RV. Can renew the RV password. Can deactivate and reactivate RV managers and coworkers. Can promote coworkers to managers and vice versa.
|-
!scope="column" {{Lightgray_small}}| RV manager
|scope="column" {{Tab element}} | RV coworker with elevated rights to deactivate and reactivate other RV coworkers.
|-
!scope="column" {{Lightgray_small}}| RV coworker
|scope="column" {{Tab element}} | Typical user who has registered her/himself via RV acronym and password.
|-
|}

== Change the RV Responsible ==

{|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"|
Only a RV Responsible or a ZAS administrator can appoint a new RV Responsible.
|}

First, you need to make sure that the person you want to appoint new responsible is a member of the project/RV.

1. Login to [https://zas.bwhpc.de/shib/en/info_rv.php '''My RVs'''] first.
[[File:RV-my.png|center|frame|My RVs.]]

2. Go to the project/RV where you are a RV Responsible and want to appoint a new RV Responsible.

3. Scroll down and click '''Handoff'''.
[[File:Rv-hand1.png|center|thumb|400px|Change RV Responsible.]]

4. Select "New RV responsible" from the drop-down menu and check "Agreement".
Click "Preview: Handover RV" to continue.
[[File:Rv-hand2.png|center|thumb|800px|Change RV Responsible.]]

5. To confirm your selection and the change of RV Responsible, click "Confirm RV handover".
[[File:Rv-hand3.png|center|thumb|800px|Change RV Responsible.]]

----

<p style="text-align:right;">[[Registration/bwForCluster/Service | Go to step C]]</p>

Latest revision as of 13:59, 14 November 2024

Step B: Apply for a Rechenvorhaben/Project

Rechenvorhaben/Projects (RV) are required for assignment to a bwForCluster. The research area of the group as well as the software and hardware requirements are taken into account. A research group may decide to split its research among several RV if it sees the need to do so. However, this does not mean that another RV is assigned to another cluster. A RV should be registered by a leader or senior scientist of a research group/collaboration. Any number of coworkers can then join your RV to work with the cluster.

To apply for a RV simply answer this simple question:

Become Coworker of a RV

Attention.svg

You can only sign up for an RV once. If you are an inactive member of an RV, either because you de-registered yourself or a manager deactivated you, only an RV manager can reactivate you.

The "RV responsible" will provide you with the following data on the RV:
  • RV acronym
  • RV password

If this information is lost, please let the "RV responsible" renew the password for the RV.

To become coworker of an RV, follow these simple steps:

1. Please visit the RV collaboration web form at the ZAS.

RV collaboration.

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

Select your home organization

3. 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.

4. You will be redirected back to the RV collaboration form https://zas.bwhpc.de/shib/en/bwforcluster_collaboration.php.

5. Enter RV Acronym, RV Password and Institute into the form and check both "Terms of Use". Click Send.

6. You will be assigned to the RV as a new member.

Attention.svg

In case of the error "This project is not currently renewed", please ask the RV responsible to apply for a prolongation of the RV. As soon as the prolongation was accepted, you can join the RV.

After submitting the request you will receive an email from ZAS about the further steps. RV owner and RV managers will be notified automatically.

Become Coworker of a RV.

Register a new RV

A RV should be registered by a leader or senior scientist of a research group/collaboration. You will be:

  • held accountable for the coworkers in the RV
  • asked to provide information for the two reports required by the DFG for their funding of bwForClusters
  • likely asked for a contribution to a future DFG grant proposal for a new bwForCluster in your area of research ("wissenschaftliches Beiblatt")

To apply for a new RV, follow these steps:

1. Please visit the RV registration web form at the ZAS.

Register a new RV.

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

Select your home organization

3. 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.

4. You will be redirected back to the RV registration form https://zas.bwhpc.de/shib/en/bwforcluster_proposal.php.

5. Fill in all mandatory fields of the form and tick the two "Terms of use". Detailed information on the individual fields can be found in the section Registration Form Details. Click Preview.

6. If the information is correct, click Submit, otherwise you can customize your application.

7. Go to section Registration Response for the next steps.

Please note that for your convenience you can also switch to the German version of the web form. The submitter of the RV will be assigned the role "RV responsible" (see Roles in a RV).


Registration Form Details

The web form consists of the following fields. Note that the fields - name, given name, organization, mail, and EPPN - are auto-filled and can not be changed. These are your credentials as given by your home organization.

Field Explanation
Registering a new RV.
RV Title Define a short title of your planned compute activities, maximum of 255 characters including spaces.
RV Description Write a short abstract about your planned compute activities (maximum of 2048 characters including spaces). Research groups that contributed to the DFG grant proposal (Art. 91b GG) of the corresponding bwForCluster only need to give reference to that particular proposal.
Scientific field Tick one or several scientific fields. Once all bwForClusters are up and running the full list of given scientific fields are supported and hence for RV applicable. If your RV does not match any given scientific field, please state your scientific field in the given text box. Grayed out scientific fields indicate that the corresponding bwForCluster(s) is/are not operational yet.
Field of activity Define if your RV is primarily for research and/or teaching. If not applicable, use text box.
Parallel paradigm State what parallel paradigm your code or application uses. Multiple ticks are allowed. Further information can be provided via text box. If you are not sure about it, please state the software you are using.
Programming language State the programming language(s) of your code or application.
Numerical methods State the numerical or "calculation" methods your code or application utilizes. If you do not know, write "unknown".
Software packages State all software package you will or want to use for your RV. Also include compiler, MPI and numerical packages (e.g. MKL, FFTW).
Estimated requested computing resources Roughly estimate how many CPU hours are required to finish your RV. To calculate "CPU hours" multiply "elapsed parallel computing time" with "number of CPU core" per job.

Example: Your code uses 4 CPU cores and has a wall time of 1h. This makes 4 CPU hours.

Planned maximum number of parallel used CPU cores per job Give an upper limit of how many CPU cores per job are required. Please cross-check with your statement about parallel paradigm.

Obviously, a sequential code can only use 1 CPU core per job.

Estimated maximal memory requirements per CPU core Give an upper limit of how much RAM per CPU core your jobs require. Please give a value in Gigabytes.
Estimated requested persistent disk space for the RV State how much disk space in total you need for your RV. Please give a value in Gigabytes.

Example: If your RV has 4 more coworker and each of you produces until the end of your RV 20 Gigabyte of output, your maximum disk space is 100 Gigabyte.

Estimated maximal temporary disk space per job State how much space your intermediate files require during a job run. Please give a value in Gigabytes.

Example: Your final output of your job is 0.1 Gigabyte, but during your job 10 temporary files, each with a size of 1 Gigabyte, are written to disk, hence your correct answer is 10 Gigabyte.

Institute State the full name of your Institute.


Registration Response

After submitting you will get an email from the ZAS confirming your submission. With this email you are given an unique

  • RV acronym
  • RV password

Please keep the password enclosed. With RV acronym and password, coworkers can already associate themselves to the RV. If this information is lost, please renew the password for the RV.

The cluster assignment team assigns a bwForCluster to your RV based on your submitted data, including the research area as well as the software and hardware requirements. The ZAS notifies you in an email about your assigned bwForCluster and provides website details for Step C.

My RVs

Attention.svg

If you de-register from a RV, only a RV responsible or manager can activate (register) you again.

You can see your RV memberships at My RVs.

My RVs.


Renew RV Password

If you lose the RV password or want to create a new one, you can simply renew it:

1. Login to My RVs first.

My RVs.

2. Select the RV acronym for your RV.

3. Scroll down and click Renew password.

Renew RV password.

Duration of an RV

A RV is valid for one year. After that, the RV responsible must apply for an extension of the RV for it to be renewed for another year.


Roles in a RV

Attention.svg

Once a member is inactive, only a RV responsible or manager can re-activate this member.

The RV Responsible can assign managers to activate and deactivate coworkers. RV responsible and RV managers can check the list of RV members at My RVs by selecting the RV acronym. After a role change, click Save changes at the end of the members list.

My RVs.
Role Explanation
Roles in a RV.
RV responsible Registers and extends the RV. Can renew the RV password. Can deactivate and reactivate RV managers and coworkers. Can promote coworkers to managers and vice versa.
RV manager RV coworker with elevated rights to deactivate and reactivate other RV coworkers.
RV coworker Typical user who has registered her/himself via RV acronym and password.

Change the RV Responsible

Attention.svg

Only a RV Responsible or a ZAS administrator can appoint a new RV Responsible.

First, you need to make sure that the person you want to appoint new responsible is a member of the project/RV.

1. Login to My RVs first.

My RVs.

2. Go to the project/RV where you are a RV Responsible and want to appoint a new RV Responsible.

3. Scroll down and click Handoff.

Change RV Responsible.

4. Select "New RV responsible" from the drop-down menu and check "Agreement". Click "Preview: Handover RV" to continue.

Change RV Responsible.

5. To confirm your selection and the change of RV Responsible, click "Confirm RV handover".

Change RV Responsible.

Go to step C