From 5638e3fe84ebabc1aa954524d73bec9b64aba4a0 Mon Sep 17 00:00:00 2001 From: Gabriel Brascher Date: Fri, 9 Oct 2020 16:32:01 -0300 Subject: [PATCH 1/4] Configure Root disk size via Service Offering Based on PR at apache/cloudstack repository: - #4341: Allow to configure root disk size via Service Offering (diskoffering of type Service). --- source/adminguide/storage.rst | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index 9757d457a8..20c48f0a61 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -617,6 +617,34 @@ To resize a volume: #. Click OK. +Root Volume size defined via Service Offering +~~~~~~~~~~~~~~~~ + +If a Service Offering is created with a root disk size, then resizing the Root volume is possible only by resizing the VMs service offering. + +Service offering Root resizing constrains: +#. Users cannot deploy VMs with custom root disk size when using such offerings +#. Users cannot resize the VM root disk size when using such offerings +#. The Root Volume of such VMs can only be resized when changing to another Service Offering with a Root disk size equals or larger than the current one. +#. Users can change the VM offering to a service offering with a Root size of 0GB (default) and then customize the volume size. + +The following table shows possible combinations of Service offering supported resizing based on the offering Root disk size: + ++---+----------------------------+---------------------------+-------------------------------+ +| # | Service Offering Root size | new Service Offering Root | Does support offering resize? | ++---+----------------------------+---------------------------+-------------------------------+ +| 1 | 0GB (default) | Any | YES | ++---+----------------------------+---------------------------+-------------------------------+ +| 2 | 5GB | 5GB | YES | ++---+----------------------------+---------------------------+-------------------------------+ +| 3 | 5GB | 10GB | YES | ++---+----------------------------+---------------------------+-------------------------------+ +| 4 | 10GB | 5GB | NO | ++---+----------------------------+---------------------------+-------------------------------+ +| 5 | Any | 0GB | YES | ++---+----------------------------+---------------------------+-------------------------------+ + +Note that shrinking the Root disk is not supported via the service offering resizing workflow. Reset VM to New Root Disk on Reboot ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ From b2a2f06ea9b4867cdb1452913724852a2995f7e9 Mon Sep 17 00:00:00 2001 From: Gabriel Brascher Date: Wed, 11 Nov 2020 21:43:41 -0300 Subject: [PATCH 2/4] Service Offerings with Root size of 0GB do not change the disk size to Zero --- source/adminguide/storage.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index 20c48f0a61..4d4403c690 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -623,9 +623,13 @@ Root Volume size defined via Service Offering If a Service Offering is created with a root disk size, then resizing the Root volume is possible only by resizing the VMs service offering. Service offering Root resizing constrains: + #. Users cannot deploy VMs with custom root disk size when using such offerings + #. Users cannot resize the VM root disk size when using such offerings + #. The Root Volume of such VMs can only be resized when changing to another Service Offering with a Root disk size equals or larger than the current one. + #. Users can change the VM offering to a service offering with a Root size of 0GB (default) and then customize the volume size. The following table shows possible combinations of Service offering supported resizing based on the offering Root disk size: @@ -644,7 +648,7 @@ The following table shows possible combinations of Service offering supported re | 5 | Any | 0GB | YES | +---+----------------------------+---------------------------+-------------------------------+ -Note that shrinking the Root disk is not supported via the service offering resizing workflow. +Note that shrinking the Root disk is not supported via the service offering resizing workflow. Service Offerings with Root size of 0GB do not change the disk size to Zero and indicates that the offering do not enforces a Root disk size. Reset VM to New Root Disk on Reboot ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ From 42fc3a6d74e6ca5cd84378f9b0b5842476a846d3 Mon Sep 17 00:00:00 2001 From: Gabriel Brascher Date: Wed, 11 Nov 2020 21:53:56 -0300 Subject: [PATCH 3/4] Add '.. note::' block --- source/adminguide/storage.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index 4d4403c690..9993c29db5 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -648,7 +648,9 @@ The following table shows possible combinations of Service offering supported re | 5 | Any | 0GB | YES | +---+----------------------------+---------------------------+-------------------------------+ -Note that shrinking the Root disk is not supported via the service offering resizing workflow. Service Offerings with Root size of 0GB do not change the disk size to Zero and indicates that the offering do not enforces a Root disk size. +.. note:: + Shrinking the Root disk is not supported via the service offering resizing workflow. All the combinations above assume a transition to Root disks with size equals or bigger than the original. + Service Offerings with Root size of 0GB do not change the disk size to Zero and indicates that the offering do not enforces a Root disk size. Reset VM to New Root Disk on Reboot ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ From e26e9f52959611312d6d41fe51cda835c6f36a31 Mon Sep 17 00:00:00 2001 From: Gabriel Brascher Date: Thu, 12 Nov 2020 01:34:53 -0300 Subject: [PATCH 4/4] Add `Root Disk size (optional)` on Service Offering section --- source/adminguide/service_offerings.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/source/adminguide/service_offerings.rst b/source/adminguide/service_offerings.rst index 93c84f5557..be8fde5566 100644 --- a/source/adminguide/service_offerings.rst +++ b/source/adminguide/service_offerings.rst @@ -135,6 +135,9 @@ offerings. The compute service offering specifies: - Guest Networking type (virtual or direct) +- Root Disk size (optional). If not defined by CloudStack administrator, + users can set a custom Root disk size. + - Tags on the root disk The disk offering specifies: