(cloudstack-documentation) branch 4.20 updated: Resize volume: add pool capacity disablethreshold for resize and allow volume auto migration (#443)

[we...@apache.org]

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 <we...@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