Difference between revisions of "Unified quota wrapper"

From ScientificComputing
Jump to: navigation, search
(→‎Documentation)
Line 11: Line 11:
 
You can display the documentation of the command by running it with the parameter <tt>-h</tt>:
 
You can display the documentation of the command by running it with the parameter <tt>-h</tt>:
  
−
  [leonhard@eu-login-07-ng ~]$ lquota -h
+
  [sfux@eu-login-20-ng ~]$ lquota -h
−
  /cluster/apps/local/lquota: Command to check share/directory/project quotas on distruted filesystems
+
  /cluster/apps/local/lquota: Command to check quotas on distruted filesystems
−
  Usage: quota [-h] [-k] [-v] [directory]
+
Default: values are diplayed in human readable format (base 10)
 +
 +
  Usage: quota [-h] [-b] [-k] [directory]
 +
 
  -h    display this help message and exit
 
  -h    display this help message and exit
−
  -k    display all numbers in KB instead of the default human readable format
+
-b    display all numbers in human readable format (base 2)
−
-v    show verbose output on quota for Lustre devices. Ignored for NFS
+
  -k    display all numbers in Byte instead of the default human readable format
 
  If "directory" is not specified user's home and scratch directory are used as argument
 
  If "directory" is not specified user's home and scratch directory are used as argument
−
  [leonhard@eu-login-07-ng ~]$
+
  [sfux@eu-login-20-ng ~]$  
  
 
There are space quotas and inode quotas. An inode is a data structure to organize data in a file system. Each file or directory has one inode. Therefore a quota for inodes actually means that you can only have a limited number of files and directories in a storage share. For the home directories, we use a quota of 100'000 inodes, which implies that you cannot have more than 100'000 files and directories in your home directory.
 
There are space quotas and inode quotas. An inode is a data structure to organize data in a file system. Each file or directory has one inode. Therefore a quota for inodes actually means that you can only have a limited number of files and directories in a storage share. For the home directories, we use a quota of 100'000 inodes, which implies that you cannot have more than 100'000 files and directories in your home directory.
 +
 +
==Units==
 +
The quota wrapper can display the values either in Bytes, human readable format (base 10) or human readable format (base 2)
 +
===Base 10===
 +
{|class="wikitable" border=1 style="width: 80%;"
 +
|-
 +
! style="width: 33%" |Name !! Prefix !! Size
 +
|-
 +
|Kilobyte || kB || <math>10^3</math> bytes
 +
|-
 +
|Megabyte || MB || <math>10^6</math> bytes
 +
|-
 +
|Gigabyte || GB || <math>10^9</math> bytes
 +
|-
 +
|Terabyte || TB || <math>10^12</math> bytes
 +
|-
 +
|Petabyte || PB || <math>10^15</math> bytes
 +
|}
 +
 +
===Base 2===
 +
{|class="wikitable" border=1 style="width: 80%;"
 +
|-
 +
! style="width: 33%" |Name !! Prefix !! Size
 +
|-
 +
|Kibibyte || KiB || <math>2^{10}</math> bytes
 +
|-
 +
|Mebibyte || MiB || <math>2^{20}</math> bytes
 +
|-
 +
|Gibibyte || GiB || <math>2^{30}</math> bytes
 +
|-
 +
|Tebibyte || TiB || <math>2^{40}</math> bytes
 +
|-
 +
|Pebibyte || PiB || <math>2^{50}</math> bytes
 +
|}
  
 
==Examples==
 
==Examples==

Revision as of 10:32, 6 March 2019

Introduction

We have implemented a unified quota wrapper lquota that can be used to query the file systems space and inode (file or directory descriptor) quota on all file systems on all clusters that we have:

  • /cluster/home/$USER ($HOME, home directory)
  • /cluster/scratch/$USER ($SCRATCH, personal scratch directory)
  • /cluster/shadow (buffering stdout of running batch jobs)
  • /cluster/work (shareholder storage)
  • /cluster/project (shareholder storage)

Documentation

You can display the documentation of the command by running it with the parameter -h: 

[sfux@eu-login-20-ng ~]$ lquota -h
/cluster/apps/local/lquota: Command to check quotas on distruted filesystems
Default: values are diplayed in human readable format (base 10) 

Usage: quota [-h] [-b] [-k] [directory]

-h    display this help message and exit
-b    display all numbers in human readable format (base 2)
-k    display all numbers in Byte instead of the default human readable format
If "directory" is not specified user's home and scratch directory are used as argument
[sfux@eu-login-20-ng ~]$

There are space quotas and inode quotas. An inode is a data structure to organize data in a file system. Each file or directory has one inode. Therefore a quota for inodes actually means that you can only have a limited number of files and directories in a storage share. For the home directories, we use a quota of 100'000 inodes, which implies that you cannot have more than 100'000 files and directories in your home directory.

Units

The quota wrapper can display the values either in Bytes, human readable format (base 10) or human readable format (base 2)

Base 10

Name Prefix Size
Kilobyte kB 10^3 bytes
Megabyte MB 10^6 bytes
Gigabyte GB 10^9 bytes
Terabyte TB 10^12 bytes
Petabyte PB 10^15 bytes

Base 2

Name Prefix Size
Kibibyte KiB 2^{10} bytes
Mebibyte MiB 2^{20} bytes
Gibibyte GiB 2^{30} bytes
Tebibyte TiB 2^{40} bytes
Pebibyte PiB 2^{50} bytes

Examples

If the command is run without specifying a particular path, then it displays the quota for the home directory, the personal scratch directory and the shadow file system. If a path is specified as argument to the script, then it will display the inode and space quota for this particular storage share: 

[sfux@eu-login-10-ng ~]$ lquota
Disk quotas for user sfux (uid 40093): 
     Filesystem   space   quota   limit   grace   files   quota   limit   grace
eu-ne-home8:/home8
                  7134M  16384M  20480M           19916   80000    100k        
eu-ne-lsf:/shadow
                     4K   2048M   2048M               2   50000   50000        
-----------------------------------------------------------------------------------
Disk quotas for usr 40093 (uid 40093):
     Filesystem    used   quota   limit   grace   files   quota   limit   grace
/cluster/scratch//sfux
                   232k  2.273T  2.455T       -      29  1000000 1500000       -

[sfux@eu-login-10-ng ~]$ lquota /cluster/work/sis
Disk quotas for prj 34 (pid 34):
     Filesystem    used   quota   limit   grace   files   quota   limit   grace
/cluster/work/sis
                 7.392T  9.095T     10T       - 1141042  10000000 11000000       -

[sfux@eu-login-10-ng ~]$ lquota /cluster/project/sis
Filesystem                   Size  Used Avail Use% Mounted on
eu-ne-project2:/project/sis  9.5T  5.7T  3.9T  60% /cluster/project/sis
Filesystem                  Inodes IUsed IFree IUse% Mounted on
eu-ne-project2:/project/sis    31M  1.1M   30M    4% /cluster/project/sis

For the moment, you might need to use the full path /cluster/apps/local/lquota to run the script. We will add it to the users path soon, such that you will not have to use the full path.

Retrieved from "https://scicomp.ethz.ch/w/index.php?title=Unified_quota_wrapper&oldid=3762"