summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/release-notes/3.10.0.md25
1 files changed, 25 insertions, 0 deletions
diff --git a/doc/release-notes/3.10.0.md b/doc/release-notes/3.10.0.md
index 2facc0cf3bf..03e65dcfb7f 100644
--- a/doc/release-notes/3.10.0.md
+++ b/doc/release-notes/3.10.0.md
@@ -54,10 +54,35 @@ the `gluster volume get` command on the newly introduced global option,
### Support for rebalance time to completion estimation
*Notes for users:*
+Users can now see approximately how much time the rebalance
+operation will take to complete across all nodes.
+
+The estimated time left for rebalance to complete is displayed
+as part of the rebalance status. Use the command:
+
+```bash
+# gluster volume rebalance VOLNAME status
+```
*Limitations:*
+The rebalance process calculates the time left based on the rate
+at while files are processed on the node and the total number of files
+on the brick which is determined using statfs. The limitations of this
+are:
+
+ * A single fs partitiion must host only one brick. Multiple bricks on
+the same fs partition will cause the statfs results to be invalid.
+
+ * The estimates are dynamic and are recalculated every time the rebalance status
+command is invoked.The estimates become more accurate over time so short running
+rebalance operations may not benefit.
+
*Known Issues:*
+As glusterfs does not stored the number of files on the brick, we use statfs to
+guess the number. The .glusterfs directory contents can significantly skew this
+number and affect the calculated estimates.
+
### Separation of tier as its own service
*Notes for users:*