Difference between revisions of "Users"

From Mufasa (BioHPC)
Jump to navigation Jump to search
Line 11: Line 11:
::: This enables the person to fully exploit Mufasa's computational resources, which requires using [[System#The SLURM job scheduling system|SLURM]].
::: This enables the person to fully exploit Mufasa's computational resources, which requires using [[System#The SLURM job scheduling system|SLURM]].


For this, a request must be made [[Users#Requesting user creation and/or registration|as explained below]].
Creation of new users on Mufasa can be done by [[Roles|Job Administrators]] or by specially designated users within each research group. For this, a request must be made [[Users#Requesting user creation and/or registration|as explained below]].


== Requesting user creation and/or registration ==
== Requesting user creation and/or registration ==
Line 44: Line 44:


The person cited within brackets is the faculty who is in charge of Mufasa for each group.
The person cited within brackets is the faculty who is in charge of Mufasa for each group.
In the [[Users#Creating a new Linux user|command for user creation described below]], <code><research_group></code> must be one among <code>cartcas</code>, <code>biomech</code>, <code>nearmrs</code>, <code>nearnes</code>, <code>bio</code>.
== Creating a new Linux user ==
Creation of new users on Mufasa can be done by [[Roles|Job Administrators]] or by specially designated users within each research group.
User creation is done with command
<pre style="color: lightgrey; background: black;">
sudo  /opt/share/sbin/add_user.sh -u <username> -g users,<research_group>
</pre>
where <code><username></code> and <code><research_group></code> are chosen as explained in [[Users#Usernames|Usernames]] and [[Users#Group names|Group names]] respectively.
For instance, in order to create a user on Mufasa for a person named Mario Rossi belonging to research group CartCasLab, the following command will be used:
: <code>sudo  /opt/share/sbin/add_user.sh -u mrossi -g users,cartcas</code>
At first login, new users will be asked to change the password initially assigned to them. For security reason, it is important that such first login occurs as soon as possible after user creation.
= Providing a user with access to SLURM =
New users are not able to [[User Jobs#Executing jobs on Mufasa|execute jobs via SLURM]] until they are properly registered to SLURM's accounting system. This operation must necessarily be performed by  [[Roles|Job Administrators]].
See [[Users#Requesting user creation and/or registration|Requesting user creation and/or registration]] for details.

Revision as of 12:02, 24 June 2022

Only Mufasa users (i.e., people with a user account on Mufasa) can access the machine and interact with it.


Creating new Mufasa users

For a person to become a Mufasa user, two steps are required:

Step 1 - a new Linux user must be created for the person on Mufasa
This enables the person to access Mufasa and to execute basic activities, such as uploading data or code to their /home directory.
Step 2 - the new Linux user must be registered to SLURM's accounting system
This enables the person to fully exploit Mufasa's computational resources, which requires using SLURM.

Creation of new users on Mufasa can be done by Job Administrators or by specially designated users within each research group. For this, a request must be made as explained below.

Requesting user creation and/or registration

To request the creation of a new Linux user and/or its registration to SLURM's accounting system, a person belonging to the academic staff in charge of Mufasa should write to Giulio Fontana.

The request needs to specify what follows:

  • name and surname of the person that the Linux user is associated to
  • email of the person
  • user category, which can be either student (for M.Sc. students) or a researcher (for everyone else, including Ph.D. students)
  • what research group the person belongs to, among those listed in Group names
  • [only when a Linux user for the person already exists on Mufasa] username

User and groups on Mufasa

This section explains user and group policy on Mufasa, and the procedure to create new users and associate them to groups.

Usernames

Mufasa usernames have the form xyyy (all lowercase), where x is the first letter of the first name of the person, and yyy is their complete surname. For instance, a person called Mario Rossi will be assigned username mrossi.

If multiple users with the same surname and first letter of the first name exist, those created after the very first one are given usernames including a two-digit counter: mrossi, mrossi01, mrossi02 and so on.

Group names

On Linux machines such as Mufasa, users belong to groups. On Mufasa, groups are used to identify the research group that a specific user is part of. Assigment of Mufasa's users to groups follow these rules:

The person cited within brackets is the faculty who is in charge of Mufasa for each group.