summaryrefslogtreecommitdiffstats
path: root/doc/features
diff options
context:
space:
mode:
authorSachin Pandit <spandit@redhat.com>2015-04-07 11:39:29 +0530
committerKaleb KEITHLEY <kkeithle@redhat.com>2015-04-14 04:16:58 +0000
commitd3b52c8283eb4c85018a5055a0dbe628b5bd2d29 (patch)
tree5df9c43372385c19b8bcf49a229888d55d4a34b9 /doc/features
parentdb5fc47e2022a18038e3877f69a708532b64969c (diff)
admin/doc : Object count for quota
Change-Id: I271cca911f6dd1f481634063919a587843d93e50 BUG: 1190108 Signed-off-by: Sachin Pandit <spandit@redhat.com> Reviewed-on: http://review.gluster.org/10171 Reviewed-by: Vijaikumar Mallikarjuna <vmallika@redhat.com> Tested-by: Gluster Build System <jenkins@build.gluster.com> Reviewed-by: Kaleb KEITHLEY <kkeithle@redhat.com>
Diffstat (limited to 'doc/features')
-rw-r--r--doc/features/quota/quota-object-count.md47
-rw-r--r--doc/features/quota/quota-scalability.md (renamed from doc/features/quota-scalability.md)0
2 files changed, 47 insertions, 0 deletions
diff --git a/doc/features/quota/quota-object-count.md b/doc/features/quota/quota-object-count.md
new file mode 100644
index 00000000000..063aa7c5d61
--- /dev/null
+++ b/doc/features/quota/quota-object-count.md
@@ -0,0 +1,47 @@
+Previous mechanism:
+====================
+
+The only way we could have retrieved the number of files/objects in a directory or volume was to do a crawl of the entire directory/volume. That was expensive and was not scalable.
+
+New Design Implementation:
+==========================
+The proposed mechanism will provide an easier alternative to determine the count of files/objects in a directory or volume.
+
+The new mechanism will store count of objects/files as part of an extended attribute of a directory. Each directory extended attribute value will indicate the number of files/objects present in a tree with the directory being considered as the root of the tree.
+
+Inode quota management
+======================
+
+**setting limits**
+
+Syntax:
+*gluster volume quota <volname\> limit-objects <path\> <number\>*
+
+Details:
+<number\> is a hard-limit for number of objects limitation for path <path\>. If hard-limit is exceeded, creation of file or directory is no longer permitted.
+
+**list-objects**
+
+Syntax:
+*gluster volume quota <volname\> list-objects \[path\] ...*
+
+Details:
+If path is not specified, then all the directories which has object limit set on it will be displayed. If we provide path then only that particular path is displayed along with the details associated with that.
+
+Sample output:
+
+ Path Hard-limit Soft-limit Files Dirs Available Soft-limit exceeded? Hard-limit exceeded?
+ ---------------------------------------------------------------------------------------------------------------------------------------------
+ /dir 10 80% 0 1 9 No No
+
+**Deleting limits**
+
+Syntax:
+*gluster volume quota <volname\> remove-objects <path\>*
+
+Details:
+This will remove the object limit set on the specified path.
+
+Note: There is a known issue associated with remove-objects. When both usage limit and object limit is set on a path, then removal of any limit will lead to removal of other limit as well. This is tracked in the bug #1202244
+
+
diff --git a/doc/features/quota-scalability.md b/doc/features/quota/quota-scalability.md
index e47c898dd2a..e47c898dd2a 100644
--- a/doc/features/quota-scalability.md
+++ b/doc/features/quota/quota-scalability.md