[cloudstack-documentation] branch main updated: Storage-based VM snapshots on KVM (#153)

[nv...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

nvazquez pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git


The following commit(s) were added to refs/heads/main by this push:
     new d9afcc7  Storage-based VM snapshots on KVM (#153)
d9afcc7 is described below

commit d9afcc7b360ccf318616e6366bec072cfcfa0f8a
Author: slavkap <51...@users.noreply.github.com>
AuthorDate: Thu Apr 21 14:08:23 2022 +0300

    Storage-based VM snapshots on KVM (#153)
    
    * [WIP] Storage-based VM snapshots on KVM
    
    Documentation fo pull request - https://github.com/apache/cloudstack/pull/3724
    
    * Removed information for QCOW2 support
    
    * Fix reference
    
    * Fix section
---
 source/adminguide/virtual_machines.rst | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/source/adminguide/virtual_machines.rst b/source/adminguide/virtual_machines.rst
index 052f670..cffbc89 100644
--- a/source/adminguide/virtual_machines.rst
+++ b/source/adminguide/virtual_machines.rst
@@ -814,7 +814,9 @@ like many other resources in CloudStack.
 
 KVM supports VM snapshots when using NFS shared storage. If raw block storage
 is used (i.e. Ceph), then VM snapshots are not possible, since there is no possibility
-to write RAM memory content anywhere.
+to write RAM memory content anywhere. In such cases you can use as an alternative 
+`Storage-based VM snapshots on KVM`_
+
 
 If you need more information about VM snapshots on VMware, check out the
 VMware documentation and the VMware Knowledge Base, especially
@@ -822,6 +824,27 @@ VMware documentation and the VMware Knowledge Base, especially
 <http://kb.vmware.com/selfservice/microsites/search.do?cmd=displayKC&externalId=1015180>`_.
 
 
+.. _`Storage-based VM snapshots on KVM`:
+
+Storage-based VM snapshots on KVM
+---------------------------------
+
+.. note::
+	 For now this functionality is limited for NFS and Local storage.
+
+CloudStack introduces a new Storage-based VM snapshots on KVM feature that provides
+crash-consistent snapshots of all disks attached to the VM. It employs the underlying storage
+providers’ capability to create/revert/delete disk snapshots. Consistency is obtained by freezing
+the virtual machine before the snapshotting. Memory snapshots are not supported.
+
+.. note::
+	``freeze`` and ``thaw`` of virtual machine is maintained by the guest agent.
+	``qemu-guest-agent`` has to be installed in the VM.
+
+When the snapshotting is complete, the virtual machine is thawed.
+
+You can use this functionality on virtual machines with raw block storages (E.g. Ceph/SolidFire/Linstor).
+
 Limitations on VM Snapshots
 ---------------------------
 
@@ -857,6 +880,7 @@ Configuration          Description       Type
 ====================== ========================
 vmsnapshots.max        The maximum number of VM snapshots that can be saved for any given virtual machine in the cloud. The total possible number of VM snapshots in the cloud is (number of VMs) \* vmsnapshots.max. If the number of snapshots for any VM ever hits the maximum, the older ones are removed by the snapshot expunge job
 vmsnapshot.create.wait Number of seconds to wait for a snapshot job to succeed before declaring failure and issuing an error.
+kvm.vmstoragesnapshot.enabled For live snapshot of virtual machine instance on KVM hypervisor without memory. Requieres qemu version 1.6+ (on NFS or Local file system) and qemu-guest-agent installed on guest VM
 ====================== ========================