From d21db64c861275c977be5d2fe6dd2631351aea19 Mon Sep 17 00:00:00 2001 From: Lisa Pettyjohn Date: Wed, 19 Aug 2026 11:47:38 -0400 Subject: [PATCH] OSDOCS-21659# Changed block tracking DP->TP --- _topic_maps/_topic_map.yml | 2 + ...sistent-storage-csi-drivers-supported.adoc | 55 +++++++++++-------- ...nt-storage-csi-changed-block-tracking.adoc | 22 ++++++++ 3 files changed, 56 insertions(+), 23 deletions(-) create mode 100644 storage/container_storage_interface/persistent-storage-csi-changed-block-tracking.adoc diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index 91f097e7d2a..3ff9f96c6fa 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -2073,6 +2073,8 @@ Topics: File: persistent-storage-csi-sc-manage - Name: CSI automatic migration File: persistent-storage-csi-migration + - Name: Overview of Changed block tracking + File: persistent-storage-csi-changed-block-tracking - Name: AWS Elastic Block Store CSI Driver Operator File: persistent-storage-csi-ebs - Name: AWS Elastic File Service CSI Driver Operator diff --git a/modules/persistent-storage-csi-drivers-supported.adoc b/modules/persistent-storage-csi-drivers-supported.adoc index ef1bf2f6997..53e78738ca6 100644 --- a/modules/persistent-storage-csi-drivers-supported.adoc +++ b/modules/persistent-storage-csi-drivers-supported.adoc @@ -36,29 +36,29 @@ In addition to the drivers listed in the following table, {product-title} functi endif::openshift-rosa,openshift-rosa-hcp,openshift-aro[] .Supported CSI drivers and features in {product-title} -[cols=",^v,^v,^v,^v,^v,^v,^v width="100%",options="header"] +[cols=",^v,^v,^v,^v,^v,^v,^v,^v width="100%",options="header"] |=== -|CSI driver |CSI volume snapshots |CSI volume group snapshots ^[1]^ |CSI cloning |CSI resize |Inline ephemeral volumes |User namespaces -|AWS EBS | ✅ | | | ✅| | ✅ -|AWS EFS | | | | | | +|CSI driver |CSI volume snapshots |CSI volume group snapshots ^[1]^ |CSI cloning |CSI resize |Inline ephemeral volumes |Changed block tracking ^[2]^ |User namespaces +|AWS EBS | ✅ | | | ✅| | | ✅ +|AWS EFS | | | | | | | ifndef::openshift-rosa,openshift-rosa-hcp[] -|Google Compute Platform (GCP) persistent disk (PD)| ✅| |✅^[2]^ | ✅| | ✅ -|GCP Filestore | ✅ | | | ✅| | +|Google Compute Platform (GCP) persistent disk (PD)| ✅| |✅^[3]^ | ✅| | | ✅ +|GCP Filestore | ✅ | | | ✅| | | endif::openshift-rosa,openshift-rosa-hcp[] ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] -|{ibm-power-server-name} Block | | | | ✅ | | ✅ -|{ibm-cloud-name} Block | ✅^[3]^ | | | ✅^[3]^| | ✅ +|{ibm-power-server-name} Block | | | | ✅ | | | ✅ +|{ibm-cloud-name} Block | ✅^[4]^ | | | ✅^[4]^| | | ✅ endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] -|{lvms} | ✅ | | ✅ | ✅ | | ✅ +|{lvms} | ✅ | | ✅ | ✅ | | | ✅ ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] -|Microsoft Azure Disk | ✅ | | ✅ | ✅| | ✅ -|Microsoft Azure Stack Hub | ✅ | | ✅ | ✅| | ✅ -|Microsoft Azure File | ✅ | | ✅ | ✅| ✅ | -|OpenStack Cinder | ✅ | | ✅ | ✅| | ✅ -|{rh-storage} | ✅ | ✅ | ✅ | ✅| | ✅ ^[4]^ -|OpenStack Manila | ✅ | | | ✅ | | -|CIFS/SMB | | | ✅ | | | -|VMware vSphere | ✅^[5]^ | | | ✅^[6]^| | ✅ ^[7]^ +|Microsoft Azure Disk | ✅ | | ✅ | ✅| | | ✅ +|Microsoft Azure Stack Hub | ✅ | | ✅ | ✅| | | ✅ +|Microsoft Azure File | ✅ | | ✅ | ✅| ✅ | | +|OpenStack Cinder | ✅ | | ✅ | ✅| | | ✅ +|{rh-storage} | ✅ | ✅ | ✅ | ✅| | ✅ ^[5]^| ✅ ^[6]^ +|OpenStack Manila | ✅ | | | ✅ | | | +|CIFS/SMB | | | ✅ | | | | +|VMware vSphere | ✅^[7]^ | | | ✅^[8]^| | | ✅ ^[9]^ endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] |=== ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] @@ -70,29 +70,38 @@ include::snippets/technology-preview.adoc[leveloffset=+1] 2. -Cloning is not supported on hyperdisk-balanced disks with storage pools. +:FeatureName: Changed block tracking +include::snippets/technology-preview.adoc[leveloffset=+1] 3. -Does not support offline snapshots or resize. Volume must be attached to a running pod. +Cloning is not supported on hyperdisk-balanced disks with storage pools. 4. -RBD supports user namespaces; CephFS does not. +Does not support offline snapshots or resize. Volume must be attached to a running pod. 5. +{rh-storage} supports changed block tracking (CBT) only with RBD. + +6. + +RBD supports user namespaces; CephFS does not. + +7. + * Requires VMware vSphere version 8.0 Update 1 or later, or VMware vSphere Foundation (VVF) 9, or VMware Cloud Foundation (VCF) 9, for both vCenter Server and ESXi. * Does not support fileshare volumes. -6. +8. Online expansion is supported from VMware vSphere version 8.0 Update 1 and later, or VVF 9, or VCF 9. -7. +9. File persistent volumes (PVs), such as vSAN file service, do not support user namespaces. -- -endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] \ No newline at end of file +endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] diff --git a/storage/container_storage_interface/persistent-storage-csi-changed-block-tracking.adoc b/storage/container_storage_interface/persistent-storage-csi-changed-block-tracking.adoc new file mode 100644 index 00000000000..89f0065d866 --- /dev/null +++ b/storage/container_storage_interface/persistent-storage-csi-changed-block-tracking.adoc @@ -0,0 +1,22 @@ +:_mod-docs-content-type: ASSEMBLY +[id="persistent-storage-csi-changed-block_tracking_{context}"] +include::_attributes/common-attributes.adoc[] +:context: persistent-storage-csi-changed-block_tracking += Overview of Changed block tracking + +[role="_abstract"] +Container Storage Interface (CSI) changed block tracking (CBT) enables compatible backup applications to identify block ranges that changed between two snapshots of the same underlying CSI block-storage volume. + +:FeatureName: Changed block tracking +include::snippets/technology-preview.adoc[] + +Backup applications can use changed-block metadata to reduce the data read and transferred for incremental backups. The API can also identify allocated block ranges in a single snapshot, allowing backup applications to skip unallocated ranges when creating a full backup of that snapshot. These operations return metadata, not the snapshot data itself. The backup application reads and backs up the relevant data separately. + +CBT requires support from both the CSI driver and the backup application. + +For more information about CBT, see the Red Hat Knowledgebase solution "How to use Changed Block Tracking (Tech Preview) in OpenShift 5.0". + +[id="additional-resources_cbt"] +[role="_additional-resources"] +== Additional resources +* link:https://access.redhat.com/solutions/7146879[How to use Changed Block Tracking (Tech Preview) in OpenShift 5.0]