hpc documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== DARWIN account requests ======

===== UD allocations =====

<note important>Each Principle Investigator (PI) must have an active UD allocation (Startup, Education or Research) to be able to make any type of account request for DARWIN. If you do not have an active allocation, then you can submit a request with the [[https://dsi.udel.edu/core/computational-resources/darwin/|Data Science Institute (DSI) for DARWIN]].</note>

For all UD allocations, the Principle Investigator (PI) of their allocation(s) may add or remove an account on DARWIN by submitting a [[https://services.udel.edu/TDClient/32/Portal/Requests/ServiceDet?ID=23|Research Computing High Performance Computing (HPC) Clusters Help Request]] and click on the green **Request Service** button and complete the form including DARWIN Account Request in the short description, selecting How to use it? for the type of information you are looking for, and indicate which allocation (''workgroup -q workgroups'') and all of the users' full name and email addresses (UD community members and/or Guests) to add or remove in the description.

<note>**UD community members:** Full name and UDelNet ID\\
**Guests:** Full name and email address (preferably a university, institution or organization; not personal)</note>
==== UD allocation accounts ====

The cluster's resources are organizationally identified by node types available to cluster allocation workgroups. A
//workgroup// is assigned after an allocation has been submitted by a PI and approved based on the node type resources requested. Each PI is the
administrative point of contact for its workgroup.

For each workgroup, the PI is responsible for establishing and enforcing group-use policies for his/her workgroup users. 

<note important> The PI of an allocation can request to add or remove access for a user on their workgroup by submitting a [[https://services.udel.edu/TDClient/32/Portal/Requests/ServiceDet?ID=23|Research Computing High Performance Computing (HPC) Clusters Help Request]] and click on the green **Request Service** button and complete the form including DARWIN Account Request in the short description, selecting How to use it? for the type of information you are looking for, and in the description indicate which allocation (''workgroup -q workgroups'') and all of the users' full name and email addresses to add or remove.

  * **UD community members:** UDelNet ID and full name
  * **Guests:** Full name and email address (preferably a university, institution or organization; not personal)

</note>

If you are a UD community member, your UD allocation username and password are the same as your UDelNet ID
and password. You may change your UDelNet ID or password on the [[https://www.udel.edu/myudsettings|My UD Settings page]], but it is only synced at 12:15AM EST daily on DARWIN, so basically the next day. In the meantime, you may continue to use the old password on DARWIN until the update occurs.

If you are not a UD community member, IT will create a username having the form //hpcguest//<<//uid//>>, and
an initial password sent to you as a PDF when your account is created. The <<//uid//>> is based on a unique, 4-digit numerical identifier IT assigns to you. You can [[https://www.hpc.udel.edu/user/password.php|change your password]] via [[http://www.hpc.udel.edu|UD IT HPC]] page by clicking on the ''login'' button at the top of the page and enter your //hpcguest//<<//uid//>> and current password. The new password will immediately take effect on HPC systems.

Your password should always comply with UD's [[http://www1.udel.edu/security/bestpractices/passwords.html|password
recommendations]].

^Command   ^Function ^
| ''hpc-user-info -a'' <<//username//>> |Display info about a user |
| ''hpc-user-info -h''            |Display complete syntax |

For example,
<code bash>
[traine@login01.darwin ~]$ hpc-user-info -a traine
full-name = Student Training
last-name = Student Training
home-directory = /home/1201
email-address = traine@udel.edu
</code>


==== UD allocation groups ====

The allocation groups of which you are a member determine which computing nodes, job queues, and
storage resources you may use. Each group has a unique descriptive group name (//gname)//. There are
two categories of group names: //class// and //workgroup//.

**//The class category//**:** **All users belong to the group named //everyone//. Members of the UD
community also belong to the group named //ud-user//. Non-UD users are members of the group named
//hpc-guests//. Other group names currently include //facstaff// and //students//.

**//The workgroup category//**: Each workgroup has a unique group name (e.g., //nanotech//
or the Principal Investigator's (PI) UDelnetID) for each allocation. The PI and users are members of that allocation group (workgroup). To see the usernames of all members of the workgroup, type the ''hpc-group-info -a'' <<//allocation_workgroup//>> command.

Use the command ''groups'' to see all of your groups. The example below is for user ''traine''

<code bash>
$ groups
everyone ud-users students it_css
</code>

For example, the command below will display the complete information about the workgroup ''it_css'' and its members.

<code bash>
$ hpc-group-info -a it_css
name = it_css
gid-number = 1002
description = John Huffman
member = traine; Student Training; traine@UDel.Edu
member = trainf; Faculty Training; trainf@UDel.Edu
</code>

The output of this command represents (''description = ''//PI//), along with every member in the [[abstract:darwin:app_dev:compute_env#using-workgroup-and-directories|workgroup]] and their account information (Username, Full Name, Email Address).

===== ACCESS (XSEDE) allocations =====

For ACCESS allocations on DARWIN, a PI may use the [[https://allocations.access-ci.org/|ACCESS Allocations portal]] to add or remove accounts for an active allocation on DARWIN as long as the person you want to add has an [[https://access-ci.org/|ACCESS user portal]] account. If the person doesn’t have an ACCESS portal user account, then they need to visit the [[https://identity.access-ci.org/new-user|ACCESS User Registration]] to create one. The person will need to share their ACCESS user portal account with the PI to be added. Please keep in mind it may take //up to 10 business days// to process an account request on DARWIN for ACCESS users.

==== ACCESS (XSEDE) allocation accounts ====

An ACCESS user on DARWIN will be assigned a username having the form **xsedeu**//uid//. The //uid// is based on a unique, 4-digit numerical identifier assigned to you. An email with the subject "''[darwin-users] New DARWIN ACCESS (XSEDE) account information''" will be sent to the ACCESS user once their account is ready on DARWIN. Please keep in mind it may take //up to 10 business days// to process an account request on DARWIN for ACCESS users. Passwords are **not** set for ACCESS accounts on DARWIN, so you must set a password using the password reset web application at [[https://idp.hpc.udel.edu/access-password-reset/|https://idp.hpc.udel.edu/access-password-reset/]].

The application starts by directing the client to the CILogon authentication system where the "ACCESS CI (XSEDE)" provider should be selected.  If successful (and the client has an account on DARWIN), the application next asks for an email address to which a verification email should be sent; the form is pre-populated with the email address on-record on DARWIN for the client's account.  The client has 15 minutes to follow the link in that email message to choose a new password.  The form displays information regarding the desired length and qualifications of a valid password.  If the new password is acceptable, the client's DARWIN password is set and SSH access via password should become available immediately.

<WRAP center round tip 60%>
ACCESS users on DARWIN can use the [[https://idp.hpc.udel.edu/access-password-reset/|password reset web application]] to reset a forgotten password, too.
</WRAP>

^Command   ^Function ^
| ''hpc-user-info -a'' <<//username//>> |Display info about a user |
| ''hpc-user-info -h''            |Display complete syntax |

For example,
<code bash>
$ hpc-user-info -a xsedeu1201
full-name = Student Training
last-name = Student Training
home-directory = /home/1201
email-address = traine@udel.edu
clusters = DARWIN
</code>

==== ACCESS (XSEDE) allocation groups ====

The allocation groups of which you are a member determine which computing nodes, job queues, and
storage resources you may use. Each group has a unique descriptive group name (//gname)//. There are
two categories of group names: //class// and //workgroup//.

**//The class category//**: All users belong to the group named //everyone//.

**//The workgroup category//**: Each workgroup has a unique group name (e.g., //xg-tra180011//) assigned for each allocation. The PI and users are members of that allocation group (workgroup). To see the usernames of all members of the workgroup, type the ''hpc-group-info -a'' <<//allocation_workgroup//>> command.

Use the command ''groups'' to see all of your groups. The example below is for user ''xsedeu1201''

<code bash>
$ groups
everyone xg-tra180011
</code>

For example, the command below will display the complete information about the workgroup ''xg-tra180011'' and its members.

<code bash>
$ hpc-group-info -a xg-tra180011
name = xg-tra180011
gid-number = 1120
description = Student Training
member = xsedeu1201; Student Training; traine@udel.edu
</code>

The output of this command represents (''description = ''//PI//), along with every member in the [[abstract:darwin:app_dev:compute_env#using-workgroup-and-directories|workgroup]] and their account information (Username, Full Name, Email Address).