This is an automated email from the ASF dual-hosted git repository.
weizhou pushed a commit to branch 4.20
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git
The following commit(s) were added to refs/heads/4.20 by this push:
new 499f3a9e Resize volume: add pool capacity disablethreshold for resize
and allow volume auto migration (#443)
499f3a9e is described below
commit 499f3a9ec950ae3ae7df286fe0b3e13287c2a8c0
Author: Wei Zhou <weiz...@apache.org>
AuthorDate: Tue Sep 2 10:57:09 2025 +0200
Resize volume: add pool capacity disablethreshold for resize and allow
volume auto migration (#443)
---
source/_static/images/resize-volume.png | Bin 10420 -> 40174 bytes
source/adminguide/storage.rst | 11 ++++++++++-
2 files changed, 10 insertions(+), 1 deletion(-)
diff --git a/source/_static/images/resize-volume.png
b/source/_static/images/resize-volume.png
index 75c63ab7..17b21d19 100644
Binary files a/source/_static/images/resize-volume.png and
b/source/_static/images/resize-volume.png differ
diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst
index e6fd6c3e..2a225ee0 100644
--- a/source/adminguide/storage.rst
+++ b/source/adminguide/storage.rst
@@ -897,6 +897,13 @@ Before you try to resize a volume, consider the following:
Therefore, resize any partitions or file systems before you shrink a
data disk so that all the data is moved off from that disk.
+- In Apache CloudStack 4.20 and before, resizing volume will fail if
+ the current storage pool does not have enough capacity for new volume size.
+ Since Apache CloudStack 4.21, it becomes possible if zone setting
+ volume.resize.allowed.beyond.allocation is set to true, and the new volume
size
+ does not cross the resize threshold
(pool.storage.allocated.resize.capacity.disablethreshold) of storage pool.
+ These two zone settings are configurable by ROOT admin.
+
To resize a volume:
#. Log in to the CloudStack UI as a user or admin.
@@ -913,7 +920,7 @@ To resize a volume:
|resize-volume.png|
- #. If you select Custom Disk, specify a custom size.
+ #. Specify a custom size.
#. Click Shrink OK to confirm that you are reducing the size of a
volume.
@@ -922,6 +929,8 @@ To resize a volume:
which might lead to the risk of data loss. You must sign off that
you know what you are doing.
+ #. Check if you wish to auto migrate volume to another storage pool if
required.
+
#. Click OK.
Root Volume size defined via Service Offering
