cf62f1947f
Resolves: bz#1264911 bz#1277924 bz#1286820 bz#1360331 bz#1401969 Resolves: bz#1410719 bz#1419438 bz#1426042 bz#1444820 bz#1459101 Resolves: bz#1464150 bz#1464350 bz#1466122 bz#1466129 bz#1467903 Resolves: bz#1468972 bz#1476876 bz#1484446 bz#1492591 bz#1498391 Resolves: bz#1498730 bz#1499865 bz#1500704 bz#1501345 bz#1505570 Resolves: bz#1507361 bz#1507394 bz#1509102 bz#1509191 bz#1509810 Resolves: bz#1509833 bz#1511766 bz#1512470 bz#1512496 bz#1512963 Resolves: bz#1515051 bz#1519076 bz#1519740 bz#1534253 bz#1534530 Signed-off-by: Milind Changire <mchangir@redhat.com>
76 lines
4.5 KiB
Diff
76 lines
4.5 KiB
Diff
From 16aae2303e2cd70405a3ab5a41c719256dd2db7a Mon Sep 17 00:00:00 2001
|
|
From: Sanoj Unnikrishnan <sunnikri@redhat.com>
|
|
Date: Tue, 24 Oct 2017 16:10:23 +0530
|
|
Subject: [PATCH 090/128] Quota: Adding man page for quota
|
|
|
|
> Change-Id: I95365c443705f56561cc10138318eb96db3b941e
|
|
> BUG: 1505660
|
|
> https://review.gluster.org/#/c/18561/
|
|
|
|
Change-Id: I95365c443705f56561cc10138318eb96db3b941e
|
|
BUG: 1501345
|
|
Signed-off-by: Sanoj Unnikrishnan <sunnikri@redhat.com>
|
|
Reviewed-on: https://code.engineering.redhat.com/gerrit/124658
|
|
Tested-by: RHGS Build Bot <nigelb@redhat.com>
|
|
Reviewed-by: Sunil Kumar Heggodu Gopala Acharya <sheggodu@redhat.com>
|
|
---
|
|
doc/gluster.8 | 42 ++++++++++++++++++++++++++++++++++++++++++
|
|
1 file changed, 42 insertions(+)
|
|
|
|
diff --git a/doc/gluster.8 b/doc/gluster.8
|
|
index 316a3d2..4c20307 100644
|
|
--- a/doc/gluster.8
|
|
+++ b/doc/gluster.8
|
|
@@ -123,6 +123,48 @@ Check status of data movement from the hot to cold tier.
|
|
.TP
|
|
\fB\ volume tier <VOLNAME> detach stop\fR
|
|
Stop detaching the hot tier from the volume.
|
|
+
|
|
+.SS "Quota Commands"
|
|
+.TP
|
|
+\fB\ volume quota <VOLNAME> enable \fR
|
|
+Enable quota on the specified volume. This will cause all the directories in the filesystem hierarchy to be accounted and updated thereafter on each operation in the the filesystem. To kick start this accounting, a crawl is done over the hierarchy with an auxiliary client.
|
|
+.TP
|
|
+\fB\ volume quota <VOLNAME> disable \fR
|
|
+Disable quota on the volume. This will disable enforcement and accounting in the filesystem. Any configured limits will be lost.
|
|
+.TP
|
|
+\fB\ volume quota <VOLNAME> limit-usage <PATH> <SIZE> [<PERCENT>] \fR
|
|
+Set a usage limit on the given path. Any previously set limit is overridden to the new value. The soft limit can optionally be specified (as a percentage of hard limit). If soft limit percentage is not provided the default soft limit value for the volume is used to decide the soft limit.
|
|
+.TP
|
|
+\fB\ volume quota <VOLNAME> limit-objects <PATH> <SIZE> [<PERCENT>] \fR
|
|
+Set an inode limit on the given path. Any previously set limit is overridden to the new value. The soft limit can optionally be specified (as a percentage of hard limit). If soft limit percentage is not provided the default soft limit value for the volume is used to decide the soft limit.
|
|
+.TP
|
|
+NOTE: valid units of SIZE are : B, KB, MB, GB, TB, PB. If no unit is specified, the unit defaults to bytes.
|
|
+.TP
|
|
+\fB\ volume quota <VOLNAME> remove <PATH> \fR
|
|
+Remove any usage limit configured on the specified directory. Note that if any limit is configured on the ancestors of this directory (previous directories along the path), they will still be honored and enforced.
|
|
+.TP
|
|
+\fB\ volume quota <VOLNAME> remove-objects <PATH> \fR
|
|
+Remove any inode limit configured on the specified directory. Note that if any limit is configured on the ancestors of this directory (previous directories along the path), they will still be honored and enforced.
|
|
+.TP
|
|
+\fB\ volume quota <VOLNAME> list <PATH> \fR
|
|
+Lists the usage and limits configured on directory(s). If a path is given only the limit that has been configured on the directory(if any) is displayed along with the directory's usage. If no path is given, usage and limits are displayed for all directories that has limits configured.
|
|
+.TP
|
|
+\fB\ volume quota <VOLNAME> list-objects <PATH> \fR
|
|
+Lists the inode usage and inode limits configured on directory(s). If a path is given only the limit that has been configured on the directory(if any) is displayed along with the directory's inode usage. If no path is given, usage and limits are displayed for all directories that has limits configured.
|
|
+.TP
|
|
+\fB\ volume quota <VOLNAME> default-soft-limit <PERCENT> \fR
|
|
+Set the percentage value for default soft limit for the volume.
|
|
+.TP
|
|
+\fB\ volume quota <VOLNAME> soft-timeout <TIME> \fR
|
|
+Set the soft timeout for the volume. The interval in which limits are retested before the soft limit is breached.
|
|
+.TP
|
|
+\fB\ volume quota <VOLNAME> hard-timeout <TIME> \fR
|
|
+Set the hard timeout for the volume. The interval in which limits are retested after the soft limit is breached.
|
|
+.TP
|
|
+\fB\ volume quota <VOLNAME> alert-time <TIME> \fR
|
|
+Set the frequency in which warning messages need to be logged (in the brick logs) once soft limit is breached.
|
|
+.TP
|
|
+NOTE: valid units of time and their symbols are : hours(h/hr), minutes(m/min), seconds(s/sec), weeks(w/wk), Days(d/days).
|
|
.SS "Geo-replication Commands"
|
|
.TP
|
|
\fI\ Note\fR: password-less ssh, from the master node (where these commands are executed) to the slave node <SLAVE_HOST>, is a prerequisite for the geo-replication commands.
|
|
--
|
|
1.8.3.1
|
|
|