Skip to content

Commit 358d26d

Browse files
committed
updates to reserving PVC space
1 parent ee00a26 commit 358d26d

File tree

3 files changed

+20
-11
lines changed

3 files changed

+20
-11
lines changed

modules/virt-how-fs-overhead-affects-space-vm-disks.adoc

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@
88
When you add a virtual machine disk to a persistent volume claim (PVC) that uses the `Filesystem` volume mode, you must ensure that there is enough space on the PVC for:
99

1010
* The virtual machine disk.
11-
* The space that the Containerized Data Importer (CDI) reserves for file system overhead, such as metadata.
11+
* The space reserved for file system overhead, such as metadata
1212

13-
By default, CDI reserves 5.5% of the PVC space for overhead, reducing the space available for virtual machine disks by that amount.
13+
By default, {VirtProductName} reserves 5.5% of the PVC space for overhead, reducing the space available for virtual machine disks by that amount.
1414

15-
If a different value works better for your use case, you can configure the overhead value by editing the `CDI` object. You can change the value globally and you can specify values for specific storage classes.
15+
You can configure a different overhead value by editing the `HCO` object. You can change the value globally and you can specify values for specific storage classes.

modules/virt-overriding-default-fs-overhead-value.adoc

Lines changed: 16 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,19 +6,19 @@
66
[id="virt-overriding-default-fs-overhead-value_{context}"]
77
= Overriding the default file system overhead value
88

9-
Change the amount of persistent volume claim (PVC) space that the Containerized Data Importer (CDI) reserves for file system overhead by editing the `spec.config.filesystemOverhead` attribute of the `CDI` object.
9+
Change the amount of persistent volume claim (PVC) space that the {VirtProductName} reserves for file system overhead by editing the `spec.config.filesystemOverhead` attribute of the `HCO` object.
1010

1111
.Prerequisites
1212

1313
* Install the OpenShift CLI (`oc`).
1414
1515
.Procedure
1616

17-
. Open the `CDI` object for editing by running the following command:
17+
. Open the `HCO` object for editing by running the following command:
1818
+
1919
[source,terminal]
2020
----
21-
$ oc edit cdi
21+
$ oc edit hco -n openshift-cnv kubevirt-hyperconverged
2222
----
2323

2424
. Edit the `spec.config.filesystemOverhead` fields, populating them with your chosen values:
@@ -33,16 +33,25 @@ spec:
3333
storageClass:
3434
<storage_class_name>: "<new_value_for_this_storage_class>" <2>
3535
----
36-
<1> The file system overhead percentage that CDI uses across the cluster. For example, `global: "0.07"` reserves 7% of the PVC for file system overhead.
36+
<1> The default file system overhead percentage used for any storage classes that do not already have a set value. For example, `global: "0.07"` reserves 7% of the PVC for file system overhead.
3737
<2> The file system overhead percentage for the specified storage class. For example, `mystorageclass: "0.04"` changes the default overhead value for PVCs in the `mystorageclass` storage class to 4%.
3838

39-
. Save and exit the editor to update the `CDI` object.
39+
. Save and exit the editor to update the `HCO` object.
4040

4141
.Verification
4242

43-
* View the `CDI` status and verify your changes by running the following command:
43+
* View the `CDIConfig` status and verify your changes by running one of the following commands:
44+
+
45+
To generally verify changes to `CDIConfig`:
46+
+
47+
[source,terminal]
48+
----
49+
$ oc get cdiconfig -o yaml
50+
----
51+
+
52+
To view your specific changes to `CDIConfig`:
4453
+
4554
[source,terminal]
4655
----
47-
$ oc get cdi -o yaml
56+
$ oc get cdiconfig -o jsonpath='{.items..status.filesystemOverhead}'
4857
----

virt/virtual_machines/virtual_disks/virt-reserving-pvc-space-fs-overhead.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ include::_attributes/common-attributes.adoc[]
66

77
toc::[]
88

9-
By default, the Containerized Data Importer (CDI) reserves space for file system overhead data in persistent volume claims (PVCs) that use the `Filesystem` volume mode. You can set the percentage that CDI reserves for this purpose globally and for specific storage classes.
9+
By default, the {VirtProductName} reserves space for file system overhead data in persistent volume claims (PVCs) that use the `Filesystem` volume mode. You can set the percentage to reserve space for this purpose globally and for specific storage classes.
1010

1111
include::modules/virt-how-fs-overhead-affects-space-vm-disks.adoc[leveloffset=+1]
1212

0 commit comments

Comments
 (0)