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 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), and 4) any additional file systems that a Center
chooses to report.
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 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):
- System - The name of the system being reported.
- Location - The environment variable corresponding to the storage location being reported.
- Disk Usage - The disk storage owned by the user (in KB).
- Disk Quota - The disk storage quota, if any (in KB).
- File Usage - The number of files owned by the user.
- 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.