From 4be8c489bd32b42eb34fb51538be8fb63ed2b465 Mon Sep 17 00:00:00 2001
From: Don Lipari <lipari1@llnl.gov>
Date: Mon, 9 Feb 2009 23:16:29 +0000
Subject: [PATCH] Added the fair-share portion of the job priority page

---
 doc/html/AllocationPies.gif | Bin 0 -> 26135 bytes
 doc/html/ExampleUsage.gif   | Bin 0 -> 33966 bytes
 doc/html/UsagePies.gif      | Bin 0 -> 24376 bytes
 doc/html/job_priority.shtml | 271 ++++++++++++++++++++++++++++++++++++
 4 files changed, 271 insertions(+)
 create mode 100644 doc/html/AllocationPies.gif
 create mode 100644 doc/html/ExampleUsage.gif
 create mode 100644 doc/html/UsagePies.gif

diff --git a/doc/html/AllocationPies.gif b/doc/html/AllocationPies.gif
new file mode 100644
index 0000000000000000000000000000000000000000..4a3d6cf858443b5a03ec1da58a3ed736cd597038
GIT binary patch
literal 26135
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

literal 0
HcmV?d00001

diff --git a/doc/html/ExampleUsage.gif b/doc/html/ExampleUsage.gif
new file mode 100644
index 0000000000000000000000000000000000000000..692cd5a125c7b56d8937b42f0caadfba0225fd44
GIT binary patch
literal 33966
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
Y$|fnf)Baf5x$CmquDkETJ8nP#J2<%(2LJ#7

literal 0
HcmV?d00001

diff --git a/doc/html/UsagePies.gif b/doc/html/UsagePies.gif
new file mode 100644
index 0000000000000000000000000000000000000000..512e08363d46835f5724cb16aaba58e8923b98ee
GIT binary patch
literal 24376
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%0A2@`=0sD+&2#q_yERlXXO%)@*#QgKVR_(
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
DGbqFd

literal 0
HcmV?d00001

diff --git a/doc/html/job_priority.shtml b/doc/html/job_priority.shtml
index 44b5e0ddc38..f5357a91361 100644
--- a/doc/html/job_priority.shtml
+++ b/doc/html/job_priority.shtml
@@ -82,6 +82,277 @@ Job_priority =
 <a name=fairshare>
 <h2>Fair-share Factor</h2></a>
 
+<P> The fair-share component to a job's priority influences the order to which a user's queued jobs are scheduled to run based on the portion of the computing resources they have been allocated and the resources their jobs have already consumed.  The fair-share factor does not involve a fixed allotment, whereby a user's access to a machine is cut off once that allotment is reached.</P>
+
+<P> Instead, the fair-share factor serves to prioritize queued jobs such that those jobs charging accounts that are under-serviced are scheduled first, while jobs charging accounts that are over-serviced are scheduled when the machine would otherwise go idle.</P>
+
+<P> SLURM's fair-share factor is a floating point number between 0.0 and 1.0 that reflects the shares of a computing resource that a user has been allocated and the amount of computing resources the user's jobs have consumed.  The higher the value, the higher is the placement in the queue of jobs waiting to be scheduled.</P>
+
+<P> The computing resource is currently defined to be computing cycles delivered by a machine in the units of processor*seconds.  Future versions of the fair-share plug-in may additionally include a memory integral component.</P>
+
+<h3> Normalized Shares</h3>
+
+<P> The fair-share hierarchy represents the portions of the computing resource that have been allocated to multiple projects.  These allocations are assigned to an account.  There can be multiple levels of allocations made as allocations of a given account are further divided to sub-accounts:</P>
+
+<div class="figure">
+  <img src=AllocationPies.gif width=400 ><BR>
+  Figure 1. Machine Allocation
+</div>
+
+<P> The chart above shows the resources of the machine allocated to four accounts, A, B, C and D.  Furthermore, account A's shares are further allocated to sub accounts, A1 through A4.  Users are granted permission (through sacctmgr) to submit jobs against specific accounts.  If there are 10 users given equal shares in Account A3, they will each be allocated 1% of the machine.</P>
+
+<P> A user's normalized shares is simply</P>
+
+<PRE>
+S =	(S<sub>user</sub> / S<sub>sibblings</sub>) *
+	(S<sub>account</sub> / S<sub>sibbling-accounts</sub>) *
+	(S<sub>parent</sub> / S<sub>parent-sibblings</sub>) * ...
+</PRE>
+
+Where:
+
+<DL>
+<DT> S
+<DD> is the user's normalized share, between zero and one
+<DT> S<sub>user</sub>
+<DD> are the number of shares of the account allocated to the user
+<DT> S<sub>sibblings</sub>
+<DD> are the total number of shares allocated to all users permitted to charge the account (including Suser)
+<DT> S<sub>account</sub>
+<DD> are the number of shares of the parent account allocated to the account
+<DT> S<sub>sibbling-accounts</sub>
+<DD> are the total number of shares allocated to all sub-accounts of the parent account
+<DT> S<sub>parent</sub>
+<DD> are the number of shares of the grandparent account allocated to the parent
+<DT> S<sub>parent-sibblings</sub>
+<DD> are the total number of shares allocated to all sub-accounts of the grandparent account
+</DL>
+
+<h3> Normalized Usage</h3>
+
+<P> The total number of processor*seconds that a machine is able to deliver over a fixed time period (for example, a day) is a fixed quantity.  The processor*seconds allocated to every job are tracked and saved to the SLURM database in real-time.  If one only considered usage over a fixed time period, then calculating a user's normalized usage would be a simple quotient:</P>
+
+<PRE>
+	U<sub>N</sub> = U<sub>user</sub> / R<sub>available</sub>
+</PRE>
+
+Where:
+
+<DL>
+<DT> U<sub>N</sub>
+<DD> is normalized usage, between zero and one
+<DT> U<sub>user</sub>
+<DD> is the processor*seconds consumed by all of a user's jobs in a given account for over a fixed time period
+<DT> R<sub>available</sub>
+<DD> is the total number of processor*seconds a machine can deliver during that same time period
+</DL>
+
+<P> However significant, real-world usage quantities span multiple time periods.  Rather than treating usage over a number of weeks or months with equal importance, SLURM's fair-share priority calculation places more importance on the most recent resource usage and less importance on usage from the distant past.</P>
+
+<P> The SLURM usage metric is based off a half-life formula that favors the most recent usage statistics.  Usage statistics from the past decrease in importance based on a single decay factor, D:</P>
+
+<PRE>
+	U<sub>H</sub> = U<sub>current_period</sub> +
+	     ( D * U<sub>last_period</sub>) + (D * D * U<sub>period-2</sub>) + ...
+</PRE>
+
+Where:
+
+<DL>
+<DT> U<sub>H</sub>
+<DD> is the historical usage subject to the half-life decay
+<DT> U<sub>current_period</sub>
+<DD> is the usage charged over the current measurement period
+<DT> U<sub>last_period</sub>
+<DD> is the usage charged over the last measurement period
+<DT> U<sub>period-2</sub>
+<DD> is the usage charged over the second last measurement period
+<DT> D
+<DD> is a decay factor between zero and one that delivers the half-life decay defined by the <i>PriorityDecayHalfLife</i> setting in the slurm.conf file.  Without accruing additional usage, a user's U<sub>H</sub> usage will decay to 1/2 value after a time period of <i>PriorityDecayHalfLife</i> seconds.
+</DL>
+
+<P> In practice, the <i>PriorityDecayHalfLife</i> could be a matter of seconds or days as appropriate for each site.  The measurement period is nominally 5 minutes.  The decay factor, D, is assigned the value that will achieve the half life decay rate specified by the <i>PriorityDecayHalfLife</i> parameter.</P>
+
+<P> The historical resources a machine has available is similarly aggregated with the same decay factor:</P>
+
+<PRE>
+	R<sub>H</sub> = R<sub>current_period</sub> +
+	    ( D * R<sub>last_period</sub>) + (D * D * R<sub>period-2</sub>) + ...
+</PRE>
+
+Where:
+
+<DL>
+<DT> R<sub>H</sub>
+<DD> is the historical resources available subject to the same half-life decay as the usage formula.
+<DT> R<sub>current_period</sub>
+<DD> the resources available over the current measurement period
+<DT> R<sub>last_period</sub>
+<DD> the resources available over the last measurement period
+<DT> R<sub>period-2</sub>
+<DD> the resources available over the second last measurement period
+</DL>
+
+<P> A user's normalized usage that spans multiple time periods then becomes:</P>
+
+<PRE>
+	U = U<sub>H</sub> / R<sub>H</sub>
+</PRE>
+
+
+<h3>Simplified Fair-Share Formula</h3>
+
+<P> The simplified formula for calculating the fair-share factor for usage that spans multiple time periods and subject to a half-life decay is:</P>
+
+<PRE>
+	F = (S - U + 1) / 2
+</PRE>
+
+Where:
+
+<DL compact>
+<DT> F
+<DD> is the fair-share factor
+<DT> S
+<DD> is the normalized shares
+<DT> U
+<DD> is the normalized usage factoring in half-life decay
+</DL>
+
+<P> The fair-share factor will therefore range from zero to one, where one represents the highest priority for a job.  A fair-share factor of 0.5 indicates that the user's jobs have used exactly the portion of the machine that they have been allocated.  A fair-share factor of above 0.5 indicates that the user's jobs have consumed less than their allocated share while a fair-share factor below 0.5 indicates that the user's jobs have consumed more than their allocated share of the computing resources.</P>
+
+<h3>The Fair-share Factor Under An Account Hierarchy</h3>
+
+<P> The method described above presents a system whereby the priority of a user's job is calculated based on the portion of the machine allocated to the user and the historical usage of all the jobs run by that user under a specific account.</P>
+
+<P> Another layer of "fairness" is necessary however, one that factors in the usage of other users drawing from the same account.  This allows a job's fair-share factor to be influenced by the computing resources delivered to jobs of other users drawing from the same account.</P>
+
+<P> If there are two members of a given account, and if one of those users has run many jobs under that account, the job priority of a job submitted by the user who has not run any jobs will be negatively affected.  This ensures that the combined usage charged to an account matches the portion of the machine that is allocated to that account.</P>
+
+<P> In the example below, when user 3 submits their first job using account C, they will want their job's priority to reflect all the resources delivered to account B.  They do not care that user 1 has been using up a significant portion of the cycles allocated to account B and user 2 has yet to run a job out of account B.  If user 2 submits a job using account B and user 3 submits a job using account C, user 3 expects their job to be scheduled before the job from user 2.</P>
+
+<div class="figure">
+  <img src=UsagePies.gif width=400 ><BR>
+  Figure 2. Usage Example
+</div>
+
+<h3>The SLURM Fair-Share Formula</h3>
+
+<P> The SLURM fair-share formula has been designed to provide fair scheduling to users based on the allocation and usage of every account.</P>
+
+<P> The actual formula used is a refinement of the formula presented above:</P>
+
+<PRE>
+	F = (S - U<sub>E</sub> + 1) / 2
+</PRE>
+
+<P> The difference is that the usage term is effective usage, which is defined as:</P>
+
+<PRE>
+	U<sub>E</sub> = U<sub>Achild</sub> +
+		  ((U<sub>Eparent</sub> - U<sub>Achild</sub>) * S<sub>child</sub>/S<sub>all_siblings</sub>)
+</PRE>
+
+Where:
+
+<DL>
+<DT> U<sub>E</sub>
+<DD> is the effective usage of the child user or child account
+<DT> U<sub>Achild</sub>
+<DD> is the actual usage of the child user or child account
+<DT> U<sub>Eparent</sub>
+<DD> is the effective usage of the parent account
+<DT> S<sub>child</sub>
+<DD> is the shares allocated to the child user or child account
+<DT> S<sub>all_siblings</sub>
+<DD> is the shares allocated to all the children of the parent account
+</DL>
+
+<P> This formula only applies with the second tier of accounts below root.  For the tier of accounts just under root, their effective usage equals their actual usage.</P>
+
+<P> Because the formula for effective usage includes a term of the effective usage of the parent, the calculation for each account in the tree must start at the second tier of accounts and proceed downward:  to the children accounts, then grandchildren, etc.  The effective usage of the users will be the last to be calculated.</P>
+
+<P> Plugging in the effective usage into the fair-share formula above yields a fair-share factor that reflects the aggregated usage charged to each of the accounts in the fair-share hierarchy.</P>
+
+<h3>Example</h3>
+
+<P> The following example demonstrates the effective usage calculations and resultant fair-share factors.</P>
+
+<P> The machine's computing resources are allocated to accounts A and D with 40 and 60 shares respectively.  Account A is further divided into two children accounts, B with 30 shares and C with 10 shares.  Account D is further divided into two children accounts, E with 25 shares and F with 35 shares.</P>
+
+<P> Note:  the shares at any given tier in the Account hierarchy do not need to total up to 100 shares.  This example shows them totaling up to 100 to make the arithmetic easier to follow in your head.</P>
+
+<P> User 1 is granted permission to submit jobs against the B account.  Users 2 and 3 are granted one share each in the C account.  User 4 is the sole member of the E account and User 5 is the sole member of the F account.</P>
+
+<P> Note:  accounts A and D do not have any user members in this example, though users could have been assigned.</P>
+
+<P> The shares assigned to each account make it easy to determine normalized shares of the machine's complete resources.  Account A has .4 normalized shares, B has .3 normalized shares, etc.  Users who are sole members of an account have the same number of normalized shares as the account.  (E.g., User 1 has .3 normalized shares).  Users who share accounts have a portion of the normalized shares based on their shares.  For example, if user 2 had been allocated 4 shares instead of 1, user 2 would have had .08 normalized shares.  With users 2 and 3 each holding 1 share, they each have a normalized share of  0.05.</P>
+
+<P> Users 1, 2, and 4 have run jobs that have consumed the machine's computing resources.  User 1's actual usage is 0.2 of the machine; user 2 is 0.25,  and user 4 is 0.25.</P>
+
+<P> The actual usage charged to each account is represented by the solid arrows.  The actual usage charged to each account is summed as one goes up the tree.  Account C's usage is the sum of the usage of Users 2 and 3; account A's actual usage is the sum of its children, accounts B and C.</P>
+
+<div class="figure">
+  <img src=ExampleUsage.gif width=400 ><BR>
+  Figure 3. Fair-share Example
+</div>
+
+<UL>
+<LI> User 1 normalized share: 0.3
+<LI> User 2 normalized share: 0.05
+<LI> User 3 normalized share: 0.05
+<LI> User 4 normalized share: 0.25
+<LI> User 5 normalized share: 0.35
+</UL>
+
+<P> As stated above, the effective usage is computed from the formula:</P>
+
+<PRE>
+	U<sub>E</sub> = U<sub>Achild</sub> +
+		  ((U<sub>Eparent</sub> - U<sub>Achild</sub>) * S<sub>child</sub>/S<sub>all_siblings</sub>)
+</PRE>
+
+<P> The effective usage for all accounts at the first tier under the root allocation is always equal to the actual usage:</P>
+
+Account A's effective usage is therefore equal to .45.  Account D's effective usage is equal to .25.
+
+<UL>
+<LI> Account B effective usage: 0.2 + ((0.45 - 0.2) * 30 / 40) = 0.3875
+<LI> Account C effective usage: 0.25 + ((0.45 - 0.25) * 10 / 40) = 0.3
+<LI> Account E effective usage: 0.25 + ((0.25 - 0.25) * 25 / 60) = 0.25
+<LI> Account F effective usage: 0.0 + ((0.25 - 0.0) * 35 / 60) = 0.1458
+</UL>
+
+<P> The effective usage of each user is calculated using the same formula:</P>
+
+<UL>
+<LI> User 1 effective usage: 0.2 + ((0.3875 - 0.2) * 1 / 1) = 0.3875
+<LI> User 2 effective usage: 0.25 + ((0.3 - 0.25) * 1 / 2) =  0.275
+<LI> User 3 effective usage: 0.0 + ((0.3 - 0.0) * 1 / 2) =  0.15
+<LI> User 4 effective usage: 0.25 + ((0.25 - 0.25) * 1 / 1) = 0.25
+<LI> User 5 effective usage: 0.0 + ((.1458 - 0.0) * 1 / 1) =  0.1458
+</UL>
+
+<P> Using the SLURM fair-share formula,</P>
+
+<PRE>
+	F = (S - U<sub>E</sub> + 1) / 2
+</PRE>
+
+<P> the fair-share factor for each user is:</P>
+
+<UL>
+<LI> User 1 fair-share factor: (.3 - .3875 + 1) / 2 =  0.45625
+<LI> User 2 fair-share factor: (.05 - .275 + 1) / 2 =  0.3875
+<LI> User 3 fair-share factor: (.05 - .15 + 1) / 2 =  0.45
+<LI> User 4 fair-share factor: (.25 - .25 + 1) / 2 =  0.5
+<LI> User 5 fair-share factor: (.35 - .1458 + 1) / 2 =  0.6021
+</UL>
+
+<P> From this example, once can see that users 1,2, and 3 are over-serviced while user 5 is under-serviced.  Even though user 3 has yet to submit a job, his/her fair-share factor is negatively influenced by the jobs users 1 and 2 have run.</P>
+
+<P> Based on the fair-share factor alone, if all 5 users were to submit a job charging their respective accounts, user 5's job would be granted the highest scheduling priority.</P>
+
 <!-------------------------------------------------------------------------->
 <p style="text-align:center;">Last modified 9 February 2009</p>
 
-- 
GitLab