Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1136187

Summary:	RO disk documentation
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Vered Volansky <vered>
Component:	Documentation	Assignee:	Julie <juwu>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Lucy Bopf <lbopf>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	3.4.0	CC:	amureini, ecohen, gklein, juwu, rbalakri, vered, yeylon
Target Milestone:	---
Target Release:	3.5.0
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2015-02-13 04:00:59 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Vered Volansky 2014-09-02 06:34:40 UTC

We saw two issues in bz1074346:
http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.5-Beta/html-single/Administration_Guide/index.html#Read_Only_Disks_in_Red_Hat_Enterprise_Virtualization



> > Red Hat Enterprise Virtualization allows you to mark virtual machine hard
> > disks as Read Only and attach those disks to virtual machines.

The disk is not read-only, it's a ATTACHED as read only to a VM.
maybe something like:
"Red Hat Enterprise Virtualization allows you to mark virtual machine hard
disks as Read Only when attached to virtual machines."

> > Floating disks are always rewritable and cannot be marked read-only.
This is not wrong, but it's important to clarify that RO is a property of the VM-Disk relationship. A floating disk is not attached to a VM, and therefore cannot ever be RO. We don't want customer to expect to be able to edit this property on floating disk in the future.

Comment 1 Allon Mureinik 2014-09-02 06:37:34 UTC

(In reply to Vered Volansky from comment #0)
> We saw two issues in bz1074346:
> http://documentation-devel.engineering.redhat.com/site/documentation/en-US/
> Red_Hat_Enterprise_Virtualization/3.5-Beta/html-single/Administration_Guide/
> index.html#Read_Only_Disks_in_Red_Hat_Enterprise_Virtualization

Just to clarify - this isn't a request to reopen bz1074346 - the fix there is fine.
While examining it, though, additional (pre-exsiting) issues were noticed.

Comment 2 Julie 2014-12-08 08:20:17 UTC

Hi Vered,
   Thanks for filing this bug. 
I have made the following changes:
"Red Hat Enterprise Virtualization allows you to mark a virtual machine hard disk as Read Only when attaching the hard disk to a virtual machine."

"Floating disks are not attached to a virtual machine and cannot be marked read-only." 


Can you let me know if this is now clear enough and let me know if you have further feedback.

Many thanks,
Julie

Comment 3 Allon Mureinik 2014-12-08 16:08:28 UTC

Hi Julie,

The import thing to clarify here is that read-only or read-write is not an intrinsic property of the disk, but of how it's *attached to the vm*. The given paragraph may be misunderstood a meaning that the disk becomes read-only when attached to a VM. Perhaps an extra clarification would be beneficial? Something down the lines of:

"""
Red Hat Enterprise Virtualization allows you to mark a virtual machine hard disk as read-only when attaching the hard disk to a virtual machine - on that virtual machine. The disk may still be attached as read-write on other virtual machines.
"""

Comment 6 Lucy Bopf 2014-12-10 13:07:47 UTC

VERIFIED - The content has been updated as discussed within this bug.