Sync mode of global fair share policy

The global fair share policy has a property called sync mode. Sync mode controls which share accounts in the global fair share participating queues can become global share accounts. There are two sync modes: all-mode and partial-mode.

If a global fair share policy is configured as all-mode, all share accounts of each participating queue will become global share accounts.
Figure 1. Global fair share tree
Global fair share tree

This diagram illustrates an all-mode global fair share policy. In the illustration, all share accounts in each participating queues are global.

If a global fair share policy is configured as partial-mode, which share accounts can become global share accounts, is controlled by fair share tree configuration of each participating queue. In participating queues, only the share accounts who meet all the following conditions can become global share accounts:
  • In lsb.users, FS_POLICY parameter is configured for the share accounts.
  • The name of the global fair share policy, which the queue participates into, is a member of FS_POLICY.
The following diagram illustrates a partial-mode global fair share policy. In this illustration only the global nodes are global share accounts.
Figure 2. Partial-mode global fair share policy
Partial-mode global fair share policy

Configure all-mode global fair share policy

Just set SYNC_MODE to all explicitly for the global fair share policy in lsb.globalpolicies: 
Begin GlobalFairshare
Name = policy1
PARTICIPANTS = queue1@cluster1 queue1@cluster2
SYNC_MODE = all
End GlobalFairshare

Configure partial-mode global fair share policy

Using Figure 2, as an example. The following steps show how to configure such a partial-mode global fair share policy (assume that fair share tree of queue1@cluster1 and queue1@cluster2 have been configured):
  1. Set SYNC_MODE to partial for the policy:
    Begin GlobalFairshare
Name = policy1
PARTICIPANTS = queue1@cluster1 queue1@cluster2
SYNC_MODE = partial
End GlobalFairshare
  2. In each participating cluster, ensure that the share accounts OrgA and OrgB are global by setting the global fair share policy name policy1 into the FS_POLICY parameter in the lsb.users file:
    Begin UserGroup
GROUP_NAME  GROUP_MEMBER         USER_SHARES            FS_POLICY
ProjectA    (user1 user2)        ([default,10])         ()
ProjectB    (user3 user4)        ([default,10])         ()
OrgB        (ProjectA ProjectB)  ([default,10])         ()
top         (OrgA OrgB)          ([OrgA,40] [OrgB,60])  (policy1)
End UserGroup