Difference between revisions of "Users"

From Mufasa (BioHPC)
Jump to navigation Jump to search
Line 3: Line 3:
This page explains [[Users#Creating new users|how to create new users]] and [[Users#Users and groups|what is user policy]] on Mufasa.
This page explains [[Users#Creating new users|how to create new users]] and [[Users#Users and groups|what is user policy]] on Mufasa.


= Creating new users =
= Creating new Mufasa users =
In order to provide a physical person with the possibility of running jobs on Mufasa, two things are required:
 
* a new Linux user must be created for the person
 
* the new Linux user must be registered in the accounting system of SLURM
 
The first passage only enables the person to interact with Mufasa via SSH and to execute basic activities, such as loading data and code in their <code>/home</code> directory. The second is needed to allow the person to fully exploit Mufasa's computational resources, which requires using [[System#The SLURM job scheduling system|The SLURM job scheduling system]].
 
== Creating a new Linux user ==
 
Creation of new Linux users is done either by [[Roles|Job Administrators]] or by specially designated users within each research group. The quickest way is to [[Special:Emailuser/GiulioFontana|drop an email to Giulio Fontana]].
Creation of new Linux users is done either by [[Roles|Job Administrators]] or by specially designated users within each research group. The quickest way is to [[Special:Emailuser/GiulioFontana|drop an email to Giulio Fontana]].


Line 19: Line 29:


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.
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 new users 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 in SLURM's ''accounting system''.


= Users and groups =
= Users and groups =

Revision as of 13:32, 18 February 2022

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

This page explains how to create new users and what is user policy on Mufasa.

Creating new Mufasa users

In order to provide a physical person with the possibility of running jobs on Mufasa, two things are required:

  • a new Linux user must be created for the person
  • the new Linux user must be registered in the accounting system of SLURM

The first passage only enables the person to interact with Mufasa via SSH and to execute basic activities, such as loading data and code in their /home directory. The second is needed to allow the person to fully exploit Mufasa's computational resources, which requires using The SLURM job scheduling system.

Creating a new Linux user

Creation of new Linux users is done either by Job Administrators or by specially designated users within each research group. The quickest way is to drop an email to Giulio Fontana.

Mufasa users who have the power to create new users do so with command

sudo  /opt/share/sbin/add_user.sh -u <user> -g users,<group>

where <user> is the username of the new user and <group> is one among the groups described in Users and groups, i.e. cartcas, biomech, nearmrs, nearnes, bio.

For instance, in order to create a user on Mufasa for a person named Mario Rossi belonging to CartCasLab, the following command will be used:

sudo /opt/share/sbin/add_user.sh -u mrossi -g users,cartcas

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 new users with access to SLURM

New users are not able to Execute jobs via SLURM until they are properly registered in SLURM's accounting system.

Users and groups

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.

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:

  • All users corresponding to people belong to group users
  • Additionally, each user must belong to one and only one of the following groups (within brackets is the name of the faculty who is in charge of Mufasa for each group):