Bug 1686057

Summary: [DOC] Configuring and managing Virtualization section on creating snapshots is extremely confusing,
Product: Red Hat Enterprise Linux 8 Reporter: Frank DeLorey <fdelorey>
Component: doc-Release_Notes-8-en-USAssignee: Ioanna Gkioka <igkioka>
Status: CLOSED CURRENTRELEASE QA Contact: RHEL DPM <rhel-docs>
Severity: medium Docs Contact: Yehuda Zimmerman <yzimmerm>
Priority: high    
Version: 8.0CC: areis, jherrman, jsuchane, rhel-docs, shipatil
Target Milestone: rc   
Target Release: 8.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Deprecated Functionality
Doc Text:
.Virtual machine snapshots are not properly supported in RHEL 8 The current mechanism of creating virtual machine (VM) snapshots has been deprecated, as it is not working reliably. As a consequence, it is recommended not to use VM snapshots in RHEL 8. Note that a new VM snapshot mechanism is under development and will be fully implemented in a future minor release of RHEL 8.
Story Points: ---
Clone Of: Environment:
Last Closed: 2019-06-13 23:03:39 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Description Frank DeLorey 2019-03-06 15:56:23 UTC
Document URL: 
https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8-beta/html-single/configuring_and_managing_virtualization/#creating-virtual-machine-snapshots_configuring-and-managing-virtualization

Section Number and Name: 

Chapter 4 Creating Virtual Machine Snapshots

Describe the issue: 

We state the following which leads one to believe that no version of snapshots is actually working or supported:



For Internal Snapshots:

Important

Internal snapshots are not being actively developed, and Red Hat discourages their use. 


For External Snapshots:

     External snapshots work with any type of original disk image, can be taken with no virtual machine downtime, and are more stable and reliable. As such, external snapshots are recommended for use on KVM guest virtual machines. However, external snapshots are currently not fully implemented. A workaround is described on libvirt upstream pages. 

Important

Red Hat Enterprise Linux 8 only supports creating snapshots while the guest virtual machine is paused or powered down. Creating snapshots of running guests (also known as live snapshots) is available on Red Hat Virtualization. For details, call your service representative. 

Suggestions for improvement: 
 
How about we state what works and is supported? Currently we discourage internal snapshots, recommend external but these can only be done while the guest is down which means no memory snapshot. We then state that RHV supports live snapshots however RHV does not yet support RHEL8???  This is causing customers extreme confusion as to what works and doesn't.

Additional information: 

Some tested examples of these commands would be very helpful also.