Bug 1030217 - [Doc] Quota: Corrections and suggestions in "12.4. Displaying Quota Limit Information"
Summary: [Doc] Quota: Corrections and suggestions in "12.4. Displaying Quota Limit Inf...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat
Component: doc-Administration_Guide
Version: 2.1
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: ---
Assignee: Bhavana
QA Contact: Sudhir D
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2013-11-14 07:58 UTC by Gowrishankar Rajaiyan
Modified: 2013-12-09 16:48 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2013-12-09 16:48:12 UTC
Target Upstream Version:


Attachments (Terms of Use)

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 5 Gowrishankar Rajaiyan 2013-11-26 04:47:21 UTC
Verified.


Note You need to log in before you can comment on or make changes to this bug.