Disk Quota and Usage Command

The HPCMP provides powerful computational resources for solving complex, time-consuming calculations. Due to the large number of users and the tremendous amount of data being processed, the systems' local file storage areas are valuable commodities that must be closely managed for the benefit of all. The ability for users to easily report their storage usage and any corresponding quotas is a valuable tool in daily job preparation and system monitoring.

Under this Baseline Configuration policy, each HPCMP center shall maintain a command named show_storage. This command allows users to easily identify their quota and usage information for the shared storage areas provided on all user-accessible systems: 1) the home file system ($HOME) 2) the scratch file system ($WORKDIR) and, 3) the Center-Wide file system ($CENTER).

The show_storage command produces two reports. The default report shows quota and usage information for the storage areas in which the user owns data on this system. The second report, produced by the -s flag, shows quota and usage information for the storage areas in which the user owns data for all systems at the local center. Since the Center-Wide file system is available on all systems at a center, the quota and usage information for $CENTER is always shown, regardless of which report is displayed.

Centers may choose to enhance and/or restrict the command's reporting capabilities through the use of additional command-line options.

Default Report Format:

$ show_storage

                 CENTER_NAME User Disk Quota Information
                 As of #### hours TZ DD Month YYYY

System     Location     Disk Usage     Disk Quota  File Usage  File Quota
=========  ========  =============  =============  ==========  ==========
systemA    HOME              35953          51200       12345           -
systemA    WORKDIR               1              -           1           -
utilserv   CENTER         42778300      102400000     1088733           -

Optional Report Format (-s):

$ show_storage -s

                 CENTER_NAME User Disk Quota Information
                 As of #### hours TZ DD Month YYYY

System     Location     Disk Usage     Disk Quota  File Usage  File Quota
=========  ========  =============  =============  ==========  ==========
systemA    HOME              35953          51200       12345           -
systemA    WORKDIR               1              -           1           -
systemB    HOME               9143          51200          99       10000
systemB    WORKDIR           18315              -         326           -
utilserv   HOME                775          10240          54           -
utilserv   WORKDIR          339056          51200        6650           -
utilserv   CENTER         42778300      102400000     1088733           -

The command output shall contain the following information, for both the default report and the optional report (a hyphen will indicate the absence of information for a particular field):

  1. System - The name of the system being reported.
  2. Location - The environment variable corresponding to the storage location being reported.
  3. Disk Usage - The disk storage owned by the user (in KBytes).
  4. Disk Quota - The disk storage quota, if any (in KBytes).
  5. File Usage - The number of files owned by the user.
  6. File Quota - The file count quota, if any.
  7. Because a user's disk usage can change rapidly, centers are encouraged to provide information that is as close to real-time as is feasible.

    Back to BC Policy FY10-06.