CNV8909 Adding VM disk enlargement feature

CNV8909 fixing typo

CNV8909 Making changes based on initial SME review

CNV8909 Changes based on QE review

CNV8909 Changes based on peer review

CNV8909 Changes based on peer review 2

CNV8909 Changes based on peer review 3

CNV8909 Changes based on peer review 4

CNV8909 Changes based on peer review 5

CNV8909 Changes based on peer review 6

CNV8909 Changes based on peer review 7

Author: Matthew Garrell

_topic_maps/_topic_map.yml

@@ -3029,6 +3029,8 @@ Topics:
       File: virt-preparing-cdi-scratch-space
     - Name: Re-using statically provisioned persistent volumes
       File: virt-reusing-statically-provisioned-persistent-volumes
+    - Name: Expanding a virtual machine disk
+      File: virt-expanding-vm-disk
     - Name: Deleting data volumes
       File: virt-deleting-datavolumes
 # Templates

modules/virt-enlarging-vm-disk.adoc

@@ -0,0 +1,40 @@
+// Module included in the following assemblies:
+//
+// * virt/virtual_machines/virtual_disks/virt-vm-disk-resizing.adoc
+
+:_content-type: PROCEDURE
+[id="virt-enlarging-vm-disk_{context}"]
+= Enlarging a virtual machine disk
+
+VM disk enlargement makes extra space available to the virtual machine. However, it is the responsibility of the VM owner to decide how to consume the storage.
+
+If the disk is a `Filesystem` PVC, the matching file expands to the remaining size while reserving some space for file system overhead.
+
+.Procedure
+
+. Edit the `PersistentVolumeClaim` manifest of the VM disk that you want to expand:
++
+[source,terminal]
+
+----
+$ oc edit pvc <pvc_name>
+----
+
+. Change the value of `spec.resource.requests.storage` attribute to a larger size.
++
+[source,yaml]
+
+----
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+   name: vm-disk-expand
+spec:
+  accessModes:
+     - ReadWriteMany
+  resources:
+    requests:
+       storage: 3Gi <1>
+...
+----
+<1> The VM disk size that can be increased

virt/virtual_machines/virtual_disks/virt-expanding-vm-disk.adoc

@@ -0,0 +1,21 @@
+:_content-type: ASSEMBLY
+[id="virt-vm-disk-resizing"]
+= Expanding a virtual machine disk
+include::modules/virt-document-attributes.adoc[]
+include::modules/common-attributes.adoc[]
+:context: virt-expanding-vm-disk
+
+toc::[]
+
+You can enlarge the size of a virtual machine's (VM) disk to provide a greater storage capacity by resizing the disk's persistent volume claim (PVC).
+
+However, you cannot reduce the size of a VM disk.
+
+include::modules/virt-enlarging-vm-disk.adoc[leveloffset=+1]
+
+[id="additional-resources_virt-vm-disk-resizing"]
+== Additional resources
+
+* link:https://docs.microsoft.com/en-us/windows-server/storage/disk-management/extend-a-basic-volume[Extending a basic volume in Windows].
+* link:https://access.redhat.com/solutions/29095[Extending an existing file system partition without destroying data in Red Hat Enterprise Linux].
+* link:https://access.redhat.com/solutions/24770[Extending a logical volume and its file system online in Red Hat Enterprise Linux].