Description of problem: Virtual Machine Management Guide: 6.8.1. Creating a Snapshot of a Virtual Machine 1) The 'IMPORTANT' note is wrong. I.e. no need to manually freeze and thaw the guest filesystem when using the REST API. It is done automatically by the engine. These actions where added just as a safety measure to mitigate issues with live snapshotting a VM with Cinder disks. E.g. it should be invoked manually if the VM stayed on freeze state after taking a live snapshot (due to a failure). 2) Procedure 6.10. Creating a Snapshot of a Virtual Machine The note is wrong. 'thaw' should be manually executed only in case of a failure (only if the VM stayed on freeze state).
Why is this required for Cinder? Don't we do it for these VMs?
(In reply to Yaniv Dary from comment #1) > Why is this required for Cinder? Don't we do it for these VMs? We do it automatically, i.e. the special notes for the rest-api in the documentation are redundant.
(In reply to Daniel Erez from comment #2) > (In reply to Yaniv Dary from comment #1) > > Why is this required for Cinder? Don't we do it for these VMs? > > We do it automatically, i.e. the special notes for the rest-api in the > documentation are redundant. s/redundant/misleading/
I still see this issue in the 4.0 docs: https://access.redhat.com/documentation/en/red-hat-virtualization/4.0/paged/virtual-machine-management-guide/69-snapshots Can we please fix this?
Assigning to Byron for review.
This content has been published to: 3.6: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html/Virtual_Machine_Management_Guide/sect-Snapshots.html 4.0: https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.0/html-single/virtual_machine_management_guide/#sect-Snapshots 4.1: https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html-single/virtual_machine_management_guide/#sect-Snapshots