Include it4i-disk-usage

docs.it4i/salomon/storage.md

@@ -9,9 +9,9 @@ All login and compute nodes may access same data on shared file systems. Compute
 ## Policy (In a Nutshell)
 
 !!! note
-    \* Use [HOME](#home) for your most valuable data and programs.
-    \* Use [WORK](#work) for your large project files.
-    \* Use [TEMP](#temp) for large scratch data.
+    \* Use [HOME](#home) for your most valuable data and programs.  
+    \* Use [WORK](#work) for your large project files.  
+    \* Use [TEMP](#temp) for large scratch data.  
 
 !!! warning
     Do not use for [archiving](#archiving)!
@@ -110,41 +110,52 @@ Read more on <http://wiki.lustre.org/manual/LustreManual20_HTML/ManagingStriping
 
 ## Disk Usage and Quota Commands
 
-User quotas on the Lustre file systems (SCRATCH) can be checked and reviewed using following command:
+Disk usage and user quotas can be checked and reviewed using following command:
 
 ```console
-$ lfs quota dir
+$ it4i-disk-usage
 ```
 
-Example for Lustre SCRATCH directory:
-
-```console
-$ lfs quota /scratch
-Disk quotas for user user001 (uid 1234):
-     Filesystem kbytes   quota   limit   grace   files   quota   limit   grace
-          /scratch       8       0 100000000000       *    3       0       0       -
-Disk quotas for group user001 (gid 1234):
- Filesystem kbytes quota limit grace files quota limit grace
- /scratch       8       0       0       *    3       0       0       -
-```
-
-In this example, we view current quota size limit of 100TB and 8KB currently used by user001.
-
-HOME directory is mounted via NFS, so a different command must be used to obtain quota information:
+Example:
 
 ```console
-$ quota
+$ it4i-disk-usage -h
+# Using human-readable format
+# Using power of 1024 for space
+# Using power of 1000 for entries
+
+Filesystem:    /home
+Space used:    110G
+Space limit:   238G
+Entries:       40k
+Entries limit: 500k
+# based on filesystem quota
+
+Filesystem:    /scratch
+Space used:    377G
+Space limit:   93T
+Entries:       14k
+Entries limit: 0
+# based on Lustre quota
+
+Filesystem:    /scratch
+Space used:    377G
+Entries:       14k
+# based on Robinhood
+
+Filesystem:    /scratch/work
+Space used:    377G
+Entries:       14k
+# based on Robinhood
+
+Filesystem:    /scratch/temp
+Space used:    12K
+Entries:       6
+# based on Robinhood
 ```
 
-Example output:
-
-```console
-$ quota
-    Disk quotas for user vop999 (uid 1025):
-         Filesystem blocks   quota   limit   grace   files   quota   limit   grace
-    home-nfs-ib.salomon.it4i.cz:/home
-                         28       0 250000000              10     0 500000
-```
+In this example, we view current size limits and space occupied on  the /home and /scratch filesystem, for a particular user executing the command.
+Note that limits are imposed also on number of objects (files, directories, links, etc...) that are allowed to create.  
 
 To have a better understanding of where the space is exactly used, you can use following command to find out.