Platform LSF Administration Guide Version 6.2

Chapter 16
Fairshare Scheduling
Administering Platform LSF
277
User Share Assignments
Both queue-level and host partition fairshare use the following syntax to define how
shares are assigned to users or user groups.
Syntax
[
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.
◆ user
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.
◆ number_shares
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.
Examples ◆ [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]
Assigns 27 shares: 10 to User1, 9 to User2, and 8 to the remaining users, as a
group.
User1 is slightly more important than User2. Each of the remaining users
has equal importance.