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 would be a valuable tool in daily job preparation and system monitoring.

Under this Baseline Configuration policy, each center shall maintain a command named show_storage. This command will allow users to easily identify their quota and usage information for the shared storage areas provided on center resources: 1) the file system location associated with the $HOME environment variable, 2) the file system location associated with the $WORKDIR environment variable and, 3) the Center-Wide file system location associated with the $CENTER environment variable.

The show_storage command shall produce two reports. The default report shows quota and usage information for the storage areas in which the user owns data on the current 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 should always be 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      204800000     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      102400000        6650           -
utilserv   CENTER         42778300      204800000     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.

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