Service Unit Account and Monitoring Usage

The Supercomputing Institute keeps track of machine usage using Service Units. Service Units awarded to a group can be used on either Calhoun (SGI Altix XE 1300 Linux Cluster), IBM BladeCenter Linux Cluster, SGI Altix shared-memory system, IBM Power4 or Netfinity Cluster systems. There are two allocation types to help a PI distribute SUs to their group, either make them available to all members of the group (Group Allocation) or assign certain amounts to individual users (User Allocation). The default setting is for group allocation. If you wish to change your allocation type, or have questions about accounting and monitoring usage, send email to help@msi.umn.edu.

You can monitor your usage by using the command acctinfo. Run by a member of a research group, the command acctinfo summarizes usage by that member on various machines.  We can set up acctinfo so that the PI, or the PI and a named group member, can view usage by every member of the entire group.  You can also get usage information from the previous allocation period.

 More information is below.

Allocation Type
More about acctinfo
Example output of acctinfo
Command Line Options for acctinfo

Allocation Type

There are two types of allocation ceilings as specified by a Principal Investigator: User and Group.

More about acctinfo

Users and Principal Investigators can see their combined usage for the current allocation period with the command acctinfo. Usage is also available for the previous allocation period using the --previous option.

The output is in a few different formats depending on the type of allocation ceiling that is set up (User or Group), depending on whether or not the person running the command is the PI, and the report format specified by the PI. Each report format is outlined below.

By default users with zero usage are not included in the report. To see all the members of your group use the option --allusers.

Report Formats

PI Only
Only the PI can see the usage of each individual member of the group. All other group members can only see their usage and the group totals. This is the default.
PI and Principal User
Only the PI and the group's principal user can see the usage of each individual member of the group. All other group members can only see their usage and the group totals.
All
All group members can see the group's individual and total usage.
To change the acctinfo report for your group please contact help@msi.umn.edu.

Along with SU usage acctinfo will report the percentage of usage remaining, days remaining in the allocation period and the percentage of days remaining in the allocation period.

Your group's fairshare targets and fairshare usage are also reported. For more info see: www.msi.umn.edu/user_support/fairshare.html.


Examples

 Accounting summary for the period from Jan 1, 2004 through Apr 15, 2004.
  
 Info for group caesar:
 Data reflects jobs ending before 14 Apr 2004.
 All units are in SUs

 GROUP    ALLOCATION    REMAINING   TYPE
 -------- ---------- ------------
 caesar         2500      1521.89   user ceiling
 -------- ---------- ------------

 The group caesar has 61% of its allocation remaining.
 58 days remain in the allocation period, which is 32% of the
 allocation period.


 USER     USER ALLOC     USED SP  USED ALTIX     USED NF    USED REG   REMAINING
 -------- ---------- ----------- ----------- ----------- ----------- -----------
 julius       500.00        0.02        0.00        0.00        0.00      499.98
 petrovi     2000.00      894.26        0.00        0.00       83.83     1021.91
 -------- ---------- ----------- ----------- ----------- ----------- -----------
 TOTALS      2500.00      894.28        0.00        0.00       83.83     1521.89

 Your group's fairshare target is 2.24%.
 Your group's fairshare usage on this particular system is 3.89%. 
 Fairshare is used in the calculation of job priority.
 If you have exceeded your fairshare target, your jobs will have a lower priority.
 For more info see
     www.msi.umn.edu/user_support/fairshare.html

Fairshare is used in the calculation of job priority. If you have exceeded your fairshare target, your jobs will have a lower priority. For more info see

www.msi.umn.edu/user_support/fairshare.html


Command Line Options

--allusers
Will include all members of the group including users with zero usage or allocation. By default users with zero usage are not reported.

--previous
Report the usage from the previous accounting period. Accounting periods run January 1 to June 30 and July 1 to December 31.