Bug 1331277

Summary:	[Docs][Admin][VMM] Document functionality for 'Enable SCSI Pass-Through'
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Lucy Bopf <lbopf>
Component:	Documentation	Assignee:	Tahlia Richardson <trichard>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Byron Gravenorst <bgraveno>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	3.6.0	CC:	ahino, amureini, gklein, lsurette, rbalakri, srevivo, trichard, ykaul, ylavi
Target Milestone:	ovirt-3.6.7
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
URL:	http://www.ovirt.org/develop/release-management/features/storage/virtio-scsi/
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2016-07-01 00:40:42 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:	1017284, 1159420
Bug Blocks:

Description Lucy Bopf 2016-04-28 07:51:46 UTC

The following options, which allow users to control migration of virtual machines that use SCSI reservation on VirtIO SCSI direct LUN disks, are now available in the 'New Virtual Disk' window:

New Virtual Disk -> Direct LUN -> Interface: VirtIO SCSI

Enable SCSI Pass-Through
Allow Privileged SCSI I/O (available if the above is selected)

This content should also note that enabling SCSI passthrough on a direct LUN disk with a VirtIO SCSI interface automatically adds SCSI discard support (explained here: https://bugzilla.redhat.com/show_bug.cgi?id=1017284#c11)

Comment 1 Lucy Bopf 2016-05-11 06:56:43 UTC

Assigning to Tahlia for review.

Comment 2 Tahlia Richardson 2016-06-01 07:16:09 UTC

There's also a check box called Using SCSI Reservation that un-greys when Allow Privileged SCSI I/O is selected, but which I cannot select.

Comment 5 Ala Hino 2016-06-09 12:15:36 UTC

Confirmed regarding 'Enable SCSI Pass-Through' functionality. However, I don't see 'Using SCSI Reservation' that, as mentioned in comment #2 by Tahlia, is un-greys when enabling SCSI Pass-Through and selection 'Allow Privileged SCSI I/O'.

'Using SCSI Reservation' enables admin mark whether SCSI reservation is used when
creating Direct Lun.  When migrating a VM, if SCSI reservation is marked,
operation fails. See BZ 1159420.

Comment 6 Tahlia Richardson 2016-06-10 00:12:48 UTC

(In reply to Ala Hino from comment #5)
> Confirmed regarding 'Enable SCSI Pass-Through' functionality. However, I
> don't see 'Using SCSI Reservation' that, as mentioned in comment #2 by
> Tahlia, is un-greys when enabling SCSI Pass-Through and selection 'Allow
> Privileged SCSI I/O'.
> 
> 'Using SCSI Reservation' enables admin mark whether SCSI reservation is used
> when
> creating Direct Lun.  When migrating a VM, if SCSI reservation is marked,
> operation fails. See BZ 1159420.

I didn't document Using SCSI Reservation because, although it ungreyed when I clicked Allow Privileged SCSI I/O, it stayed unticked when I clicked it. Is there anything else that needs to be set to allow me to tick that check box?

Comment 7 Ala Hino 2016-06-10 05:51:45 UTC

(In reply to Tahlia Richardson from comment #6)
> (In reply to Ala Hino from comment #5)
> > Confirmed regarding 'Enable SCSI Pass-Through' functionality. However, I
> > don't see 'Using SCSI Reservation' that, as mentioned in comment #2 by
> > Tahlia, is un-greys when enabling SCSI Pass-Through and selection 'Allow
> > Privileged SCSI I/O'.
> > 
> > 'Using SCSI Reservation' enables admin mark whether SCSI reservation is used
> > when
> > creating Direct Lun.  When migrating a VM, if SCSI reservation is marked,
> > operation fails. See BZ 1159420.
> 
> I didn't document Using SCSI Reservation because, although it ungreyed when
> I clicked Allow Privileged SCSI I/O, it stayed unticked when I clicked it.
> Is there anything else that needs to be set to allow me to tick that check
> box?

Make sure the disk interface is VirtIO-SCSI

Comment 8 Tahlia Richardson 2016-06-10 06:14:06 UTC

(In reply to Ala Hino from comment #7)
> (In reply to Tahlia Richardson from comment #6)
> > (In reply to Ala Hino from comment #5)
> > > Confirmed regarding 'Enable SCSI Pass-Through' functionality. However, I
> > > don't see 'Using SCSI Reservation' that, as mentioned in comment #2 by
> > > Tahlia, is un-greys when enabling SCSI Pass-Through and selection 'Allow
> > > Privileged SCSI I/O'.
> > > 
> > > 'Using SCSI Reservation' enables admin mark whether SCSI reservation is used
> > > when
> > > creating Direct Lun.  When migrating a VM, if SCSI reservation is marked,
> > > operation fails. See BZ 1159420.
> > 
> > I didn't document Using SCSI Reservation because, although it ungreyed when
> > I clicked Allow Privileged SCSI I/O, it stayed unticked when I clicked it.
> > Is there anything else that needs to be set to allow me to tick that check
> > box?
> 
> Make sure the disk interface is VirtIO-SCSI

Yep, it's on Direct LUN, the Interface is set to VirtIO-SCSI, the target is discovered and a LUN selected, Enable SCSI Pass-Through and Allow Privileged SCSI I/O are selected. Using SCSI Reservation is ungreyed, but nothing happens when I click on it; no tick appears. Is there something else I'm missing?

Comment 13 Tahlia Richardson 2016-07-01 00:40:42 UTC

Content is now published.

3.6:
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html/Administration_Guide/sect-Virtual_Disk_Tasks.html#Add_Virtual_Disk_dialogue_entries
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html/Virtual_Machine_Management_Guide/Add_Virtual_Disk_dialogue_entries.html

4.0:
https://access.redhat.com/documentation/en/red-hat-virtualization/4.0-beta/administration-guide/106-virtual-disk-tasks
https://access.redhat.com/documentation/en/red-hat-virtualization/4.0-beta/virtual-machine-management-guide/a3-explanation-of-settings-in-the-new-virtual-disk-and-edit-virtual-disk-windows