Bug 1415048

Summary:	[Docs][VMM] Update the documentation for SPICE USB redirection
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Lucy Bopf <lbopf>
Component:	Documentation	Assignee:	Avital Pinnick <apinnick>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Tahlia Richardson <trichard>
Severity:	unspecified	Docs Contact:
Priority:	medium
Version:	4.2.3	CC:	apinnick, hannsj_uhl, lsurette, srevivo, tjelinek, ylavi
Target Milestone:	ovirt-4.2.5	Keywords:	Triaged
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:	2018-08-14 07:26:19 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:	1373223
Bug Blocks:	1444027

Description Lucy Bopf 2017-01-20 06:00:02 UTC

The behavior of SPICE USB redirection has changed when redirection is disabled.

From the dev bug 1373223:

If SPICE USB redirection is enabled (VM-like dialog > Console > USB Support), the behavior remains unchanged: each VM has a quadruple of usb controllers: ich9-ehci1, ich9-uhci1,ich9-uhci2, ich9-uhci3.
If SPICE USB redirection is disabled, then VM has newly USB controller as specified in osinfo-defaults.properties configuration file, i.e. it is configurable per guest operating system and effective cluster version. Previously no usb controller was send to libvirt and libvirt created a default usb controller.

Default for all intel (x86, x86-64) operating systems is "piix3-uhci", for ppc64 systems it is "nec-xhci".


SME feedback from Jakub Niedermertl about the 'USB Support' field in the 'Console' tab of the 'New Virtual Machine' window:

Despite the name this dropdown controls spice usb redirection.
Enable: spice usb redirection is enabled allowing client to attach his/her usb device to a guest VM. VM is added special set of special 4 usb controllers.
Disabled: usb spice redirection is disabled, USB controller devices are added according to "devices.usb.controller" key in "osinfo-defaults.properties" configuration file.

Comment 1 Lucy Bopf 2018-06-29 05:15:59 UTC

Moving to 4.2.

Comment 6 Avital Pinnick 2018-08-14 07:26:19 UTC

Published document:

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.2/html-single/virtual_machine_management_guide/index#Virtual_Machine_Console_settings_explained