Bug 1030217

Summary: [Doc] Quota: Corrections and suggestions in "12.4. Displaying Quota Limit Information"
Product: Red Hat Gluster Storage Reporter: Gowrishankar Rajaiyan <grajaiya>
Component: doc-Administration_GuideAssignee: Bhavana <bmohanra>
Status: CLOSED CURRENTRELEASE QA Contact: Sudhir D <sdharane>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 2.1CC: asriram, grajaiya, mhideo, rhs-bugs, storage-doc, vraman
Target Milestone: ---Keywords: ZStream
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2013-12-09 16:48:12 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Gowrishankar Rajaiyan 2013-11-14 07:58:42 UTC 
http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Storage/2.1/html/Administration_Guide/chap-User_Guide-Dir_Quota-Display.html

...
To display quota limit information
Display quota limit information of all the directories on which limit is set, using the following command:
# gluster volume quota VOLNAME list
For example, to view the quota limit set on test-volume:
# gluster volume quota test-volume list
Path       Hard-limit  Soft-limit   Used    Available
------------------------------------------------------
/dir        10GB        75%       0Bytes    10.0GB
/dir/dir2   20GB        90%       0Bytes    20.0GB

[shanks] We mention about listing quota on volume, however, the example output is incorrect.

should be:
# gluster volume quota test-volume list
Path       Hard-limit  Soft-limit   Used    Available
------------------------------------------------------
/           50GB        75%       0Bytes    50.0GB
/dir        10GB        75%       0Bytes    10.0GB
/dir/dir2   20GB        90%       0Bytes    20.0GB
...


...
# gluster volume quota VOLNAME list /directory name

should be

# gluster volume quota VOLNAME list /<directory name>
...


...
For example, to view the limit set on /data directory of /dir:
For example, to view the limit set on /data directory of /dir and /dir/dir2:

[shanks] unclear what the above means. What is "/data" ?
...


...
/dir   10GB          75%       0Bytes  10.0GB

should be

/dir   10.0GB          75%       0Bytes  10.0GB

[shanks] The above is true for all the examples.
...


...
The following example displays the disk usage when quota-deem-statfs is on.

[shanks] Example given is confusing. Would like to see something like:

[root@server1 ~]# gluster vol quota shanks-vol list
                  Path                   Hard-limit Soft-limit   Used  Available
--------------------------------------------------------------------------------
/                                        300.0GB       90%      11.5GB 288.5GB
/shanks/Downloads                         77.0GB       75%      11.5GB  65.5GB
[root@server1 ~]# 


when quota-deem-statfs is off (default)
server1:
[root@server1 ~]# gluster vol set shanks-vol features.quota-deem-statfs off
volume set: success
[root@server1 ~]# 

client1:
[root@localhost ~]# df -h
Filesystem                    Size  Used Avail Use% Mounted on
/dev/mapper/VolGroup-lv_root   44G  5.1G   37G  13% /
tmpfs                         3.8G   84K  3.8G   1% /dev/shm
/dev/vda1                     485M   86M  374M  19% /boot
10.70.42.214:/shanks-vol      400G   12G  389G   3% /home
[root@localhost ~]# 


when quota-deem-statfs is on
server1:
[root@server1 ~]# gluster vol set shanks-vol features.quota-deem-statfs on
volume set: success
[root@server1 ~]# 

client1:
[root@client1 ~]# df -h
Filesystem                    Size  Used Avail Use% Mounted on
/dev/mapper/VolGroup-lv_root   44G  5.1G   37G  13% /
tmpfs                         3.8G   84K  3.8G   1% /dev/shm
/dev/vda1                     485M   86M  374M  19% /boot
10.70.42.214:/shanks-vol      300G   12G  289G   4% /home
[root@localhost ~]# 

with a clear summary on what is the benefit with quota-deem-statfs being on and probably even saying that it is recommended to set this on.
...
Comment 1 Bhavana 2013-11-25 05:40:11 UTC 

Updated the bug as suggested:

http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Storage/2.1/html/Administration_Guide/chap-User_Guide-Dir_Quota-Display.html


For your last comment - "with a clear summary on what is the benefit with quota-deem-statfs being on and probably even saying that it is recommended to set this on... "

The following two sentences are added in the documentation. Hope this addresses the issue :)

"In this case, the total disk space of the directory is taken as the quota hard limit set on the directory of the volume. It is recommended to set quota-deem-statfs to on."

"The quota-deem-statfs option when set to on, allows the administrator to make the user view the total disk space available on the directory as the hard limit set on it."
Comment 2 Gowrishankar Rajaiyan 2013-11-25 06:20:48 UTC 
we have both dr and test-volume in our examples. Can we please stick to "test-volume" ?
Comment 3 Gowrishankar Rajaiyan 2013-11-25 06:22:42 UTC 
(In reply to Bhavana from comment #1)
> 
...
> "In this case, the total disk space of the directory is taken as the quota
> hard limit set on the directory of the volume. It is recommended to set
> quota-deem-statfs to on."

ACK

> 
> "The quota-deem-statfs option when set to on, allows the administrator to
> make the user view the total disk space available on the directory as the
> hard limit set on it."

Ok
Comment 4 Bhavana 2013-11-25 17:14:31 UTC 
Thankyou.

Following is the link to the updated doc:

http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Storage/2.1/html/Administration_Guide/chap-User_Guide-Dir_Quota-Display.html
Comment 5 Gowrishankar Rajaiyan 2013-11-26 04:47:21 UTC 
Verified.