LSF Version 7.3 - Administering Platform LSF

Hierarchical User-based Fairshare
308 Administering Platform LSF
SHARE_INFO_FOR: Partition1/
USER/GROUP SHARES PRIORITY STARTED RESERVED CPU_TIME RUN_TIME
group1 40 1.867 5 0 48.4 17618
group2 20 0.775 6 0 607.7 24664
SHARE_INFO_FOR: Partition1/group2/
USER/GROUP SHARES PRIORITY STARTED RESERVED CPU_TIME RUN_TIME
user1 8 1.144 1 0 9.6 5108
user2 2 0.667 0 0 0.0 0
others 1 0.046 5 0 598.1 19556
Configuring hierarchical fairshare
To define a hierarchical fairshare policy, configure the top-level share assignment
in
lsb.queues or lsb.hosts, as usual. Then, for any group of users affected by the
fairshare policy, configure a share tree in the
UserGroup section of lsb.users. This
specifies how shares assigned to the group, collectively, are distributed among the
individual users or subgroups.
If shares are assigned to members of any group individually, using
@, there can be
no further hierarchical fairshare within that group. The shares are assigned
recursively to all members of all subgroups, regardless of further share distributions
defined in
lsb.users. The group members and members of all subgroups compete
for resources according to FCFS policy.
You can choose to define a hierarchical share tree for some groups but not others.
If you do not define a share tree for any group or subgroup, members compete for
resources according to FCFS policy.
Configure a share tree
1 Group membership is already defined in the UserGroup section of lsb.users.
To configure a share tree, use the
USER_SHARES column to describe how the
shares are distributed in a hierachical manner. Use the following format.
Begin UserGroup
GROUP_NAME GROUP_MEMBER USER_SHARES
GroupB (User1 User2) ()
GroupC (User3 User4) ([User3, 3] [User4, 4])
GroupA (GroupB GroupC User5) ([User5, 1] [default, 10])
End UserGroup
User groups must be defined before they can be used (in the GROUP_MEMBER
column) to define other groups.
Enclose the share assignment list in parentheses, as shown, even if you do
not specify any user share assignments.
An
Engineering queue or host partition organizes users hierarchically, and divides
the shares as shown. It does not matter what the actual number of shares assigned
at each level is.