From 3cf2c06896d0d043666eeb70467edc4d93f77614 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Jandre?= Date: Fri, 16 Aug 2024 11:08:53 -0300 Subject: [PATCH 1/4] update docs about snapshots on kvm --- source/adminguide/storage.rst | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index f4d969813a..756e9f3347 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -1141,11 +1141,18 @@ is running, the global setting 'kvm.snapshot.enabled' must be set to 'True'. The Volume Snapshot creation has changed in recent versions: -Under the hood, first, a full Instance Snapshot is taken - this means that during the taking of -the Instance Snapshot the Instance will be in the "Paused" state (while RAM memory is being written to the -QCOW2 file), which means that Instance will be unavailable from the Network point of view. -When the Instance Snapshot is created, Instance is unpaused/resumed, the single Volume Snapshot is exported -to the Secondary Storage, and then the Instance Snapshots is removed from the Instance. +When the VM is running, a disk-only VM snapshot is taken, exclusively for the volume in question. +If the VM is stopped, the volume will be converted (with qemu-img convert). The final storage location is +determined by the ``snapshot.backup.to.secondary`` configuration; if it is false the snapshot will be copied +to a different directory in the same primary storage as the volume; if it is true the snapshot will be copied +to the secondary storage. If the snapshot is being taken in a file-based storage (NFS, SharedMountPoint, Local), +it will be copied directly to its final storage location, according to the configuration. + +Since 4.20.0.0, ACS supports incremental snapshots for the KVM hypervisor when using file-based storage (NFS, SharedMountPoint, Local), +to enable incremental snapshots the ``kvm.incremental.snapshot`` configuration must be enabled. Furthermore, in order to take incremental snapshots +the KVM host must have at least Libvirt version 7.6.0+ and qemu version 6.1+. The size of the snapshot chains +will be determined by the ``snapshot.delta.max`` configuration, which affects both KVM and XenServer snapshots. +More information on the incremental snapshot feature for KVM can be found in its (specification)[https://github.com/apache/cloudstack/issues/8907]. Automatic Snapshot Creation and Retention From a2dca836dc8f88477e45e24f69ab14ad03120f28 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Jandre?= Date: Fri, 16 Aug 2024 11:14:52 -0300 Subject: [PATCH 2/4] fix link --- source/adminguide/storage.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index 756e9f3347..d5d3ca25d7 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -1152,7 +1152,7 @@ Since 4.20.0.0, ACS supports incremental snapshots for the KVM hypervisor when u to enable incremental snapshots the ``kvm.incremental.snapshot`` configuration must be enabled. Furthermore, in order to take incremental snapshots the KVM host must have at least Libvirt version 7.6.0+ and qemu version 6.1+. The size of the snapshot chains will be determined by the ``snapshot.delta.max`` configuration, which affects both KVM and XenServer snapshots. -More information on the incremental snapshot feature for KVM can be found in its (specification)[https://github.com/apache/cloudstack/issues/8907]. +More information on the incremental snapshot feature for KVM can be found in its `specification `. Automatic Snapshot Creation and Retention From d9ebde01e6b033f0a64a78ab3937d1a5e35f7dd3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Jandre?= Date: Fri, 16 Aug 2024 11:18:55 -0300 Subject: [PATCH 3/4] really fix the link --- source/adminguide/storage.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index d5d3ca25d7..c9f31c6232 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -1152,7 +1152,7 @@ Since 4.20.0.0, ACS supports incremental snapshots for the KVM hypervisor when u to enable incremental snapshots the ``kvm.incremental.snapshot`` configuration must be enabled. Furthermore, in order to take incremental snapshots the KVM host must have at least Libvirt version 7.6.0+ and qemu version 6.1+. The size of the snapshot chains will be determined by the ``snapshot.delta.max`` configuration, which affects both KVM and XenServer snapshots. -More information on the incremental snapshot feature for KVM can be found in its `specification `. +More information on the incremental snapshot feature for KVM can be found in its `specification `_. Automatic Snapshot Creation and Retention From 93caa932b040c83a32e20371f9830663eb6786c3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Jandre?= Date: Fri, 16 Aug 2024 13:01:44 -0300 Subject: [PATCH 4/4] update incremental snapshots table --- source/adminguide/storage.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index c9f31c6232..53517804c4 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -1194,7 +1194,7 @@ incremental backups are supported, every N backup is a full backup. +------------------------------+------------------+------------------+-----+ | | VMware vSphere | Citrix XenServer | KVM | +==============================+==================+==================+=====+ -| Support incremental backup | No | Yes | No | +| Support incremental backup | No | Yes | Yes | +------------------------------+------------------+------------------+-----+ .. note::