Bug 1420186

Summary:	[Docs][RFE][Admin] Document changes to the discard function
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Lucy Bopf <lbopf>
Component:	Documentation	Assignee:	Megan Lewis <melewis>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Tahlia Richardson <trichard>
Severity:	unspecified	Docs Contact:
Priority:	high
Version:	4.1.0	CC:	gklein, ishaby, lsurette, rbalakri, srevivo, ykaul
Target Milestone:	ovirt-4.1.1-1	Keywords:	FutureFeature
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2017-04-13 01:34:10 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	Docs	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:	1342919
Bug Blocks:

Description Lucy Bopf 2017-02-08 04:44:50 UTC

With this update, it is now possible to configure discard after delete per block storage domain, rather than per host. Existing documentation (if any) must be updated.

Previously, a user could get similar functionality by configuring the discard_enable parameter in the VDSM configuration file. This caused each logical volume (disk or snapshot) that was about to be removed by this specific host to be discarded first. Now, discard after delete can be enabled for a block storage domain, rather than a host. This means that if discard after delete is enabled it no longer matters which host removes the logical volume as each logical volume under this domain will be discarded before it is removed.

Comment 1 Lucy Bopf 2017-02-08 04:47:52 UTC

More information is available at the following locations:

http://www.ovirt.org/develop/release-management/features/storage/wipe-volumes-using-blkdiscard/

http://www.ovirt.org/develop/release-management/features/storage/discard-after-delete/

http://www.ovirt.org/develop/release-management/features/storage/pass-discard-from-guest-to-underlying-storage/

Comment 2 Lucy Bopf 2017-02-16 04:28:48 UTC

Assigning to Megan for review.

Comment 5 Megan Lewis 2017-03-14 05:36:00 UTC

This bug only covers the docs changes for the Discard After Delete feature. 

1. Changes to how Wipe After Delete works 
- No docs changes are currently being tracked for this feature 

2. New Discard After Delete for block storage 
- Docs changes being tracked in this bug. 

3. New Enable Discard for virtual machine disks
- Docs changes are tracked here: https://bugzilla.redhat.com/show_bug.cgi?id=1422158

Comment 24 Megan Lewis 2017-04-13 01:34:10 UTC

The changes for this bug are now published. 

Virtual Machine Management Guide: 
https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html-single/virtual_machine_management_guide/#Removing_Virtual_Disks_From_Virtual_Machines

Administration Guide: 
https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html-single/administration_guide/#Setting_Discard_After_Delete_for_a_Storage_Domain

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html-single/administration_guide/#Adding_iSCSI_Storage1

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html-single/administration_guide/#Editing_Storage_Domains