Both queue-level and host partition fairshare use the following syntax to define how shares are assigned to users or user groups.
[user, number_shares]
Enclose each user share assignment in square brackets, as shown. Separate multiple share assignments with a space between each set of square brackets.
Specify users of the queue or host partition. You can assign the shares:
to a single user (specify user_name)
to users in a group, individually (specify group_name@) or collectively (specify group_name)
to users not included in any other share assignment, individually (specify the keyword default) or collectively (specify the keyword others)
By default, when resources are assigned collectively to a group, the group members compete for the resources according to FCFS scheduling. You can use hierarchical fairshare to further divide the shares among the group members.
When resources are assigned to members of a group individually, the share assignment is recursive. Members of the group and of all subgroups always compete for the resources according to FCFS scheduling, regardless of hierarchical fairshare policies.
Specify a positive integer representing the number of shares of cluster resources assigned to the user.
The number of shares assigned to each user is only meaningful when you compare it to the shares assigned to other users, or to the total number of shares. The total number of shares is just the sum of all the shares assigned in each share assignment.
[User1, 1] [GroupB, 1]Assigns 2 shares: 1 to User1, and 1 to be shared by the users in GroupB. Each user in GroupB has equal importance. User1 is as important as all the users in GroupB put together. In this example, it does not matter if the number of shares is 1, 6 or 600. As long as User1 and GroupB are both assigned the same number of shares, the relationship stays the same.
[User1, 10] [GroupB@, 1]If GroupB contains 10 users, assigns 20 shares in total: 10 to User1, and 1 to each user in GroupB. Each user in GroupB has equal importance. User1 is ten times as important as any user in GroupB.
[User1, 10] [User2, 9] [others, 8]If there are 3 users in total, the single remaining user has all 8 shares, and is almost as important as User1 and User2.
If there are 12 users in total, then 10 users compete for those 8 shares, and each of them is significantly less important than User1 and User2.
[User1, 10] [User2, 6] [default, 4]The relative percentage of shares held by a user will change, depending on the number of users who are granted shares by default.
If there are 3 users in total, assigns 20 shares: 10 to User1, 6 to User2, and 4 to the remaining user. User1 has half of the available resources (10 shares out of 20).
If there are 12 users in total, assigns 56 shares: 10 to User1, 6 to User2, and 4 to each of the remaining 10 users. User1 has about a fifth of the available resources (10 shares out of 56).