The purpose of this page is to illustrate the different components controlling authentication and job submission in the O2 cluster.
There are four main components: Unix account, Unix groups, Slurm accounts and Slurm associations.
Note that the term "HMS Account" is equivalent to what was formerly called "eCommons ID"
Unix account/user
used for O2 login access (your HMS Account)
Any user must have a unix account in order to access the O2 cluster. The unix account is the "identity" of the user, and it is involved in the authentication process when connecting to the cluster. Some key informations are also associated with the unix account such as the default linux shell to be used or the $HOME path. You can use the command getent passwd $USER to see more about your unix account.
O2 authentication is based on the HMS Accounts, formerly known as Ecommons Accounts. Therefore your unix account name is the same as your HMS Account name and your password for the O2 unix account is the same as your HMS Account password.
Unix group
Each unix account is in at least one unix group. This "personal user group" has the same name as the unix account.
A unix account may also be a member of other unix groups to provide access to shared storage space or special computational resources on O2.
To see which groups are associated with your unix account, run the command groups.
Slurm Account
Slurm accounts are different than Unix accounts and are used to track cluster utilization, control access to resources, and enforce limits for groups of users (unix accounts).
Each Lab or Core that uses O2, at HMS or Affiliated Institutions, is assigned a unique Slurm account. Typically the Slurm account name is composed of the PI's last name and his/her HMS account username, like park_pjp8 (or less often just park).
The PI is responsible for the cluster utilization done by all the users associated with his/her Slurm account.
Slurm Association
In order to use O2 and submit jobs to the Slurm scheduler any user (unix account) must be associated with at least one Slurm Account. Typically each user will have a Slurm association with the Slurm Account assigned to his/her Lab/PI.
If a user is working for multiple Labs he/she might have multiple associations with the corresponding Slurm accounts. Each user is also assigned a "default account" which is used by default when submitting jobs if an account is not explicitly requested with the flag "--account=". A simple way to see your association is to run the command sshare -u $USER -U, the first column reports the Slurm account associations.
For example, the following user is associated with two SLURM accounts (i.e., rccg and lab1).
$ sshare -u $USER -U
Account User RawShares NormShares RawUsage EffectvUsage FairShare
-------------------- ---------- ---------- ----------- ----------- ------------- ----------
rccg ab123 1 0.000241 0 0.000000 1.000000
lab1 ab123 1 0.000241 21252 0.000066 0.968913
If the user wants to submit jobs using the lab1 SLURM account, then
From the command line:
srun --account=lab1 -t 30:00 [….other job arguments]
sbatch --account=lab1 [..other job parameters..]
In an sbatch script:
#SBATCH --account=lab1