From Fedora Project Wiki

No edit summary
(Add other spice features)
Line 2: Line 2:


|description=
|description=
Configure USB redirection for your guest, which allows streaming USB access to your VM, even if it's on a different host!
Test fancy spice features!


|setup=
|setup=
Initial test day setup (basically a function F18 VM). And a USB device to let your guest access.
Fedora 20+ host and Fedora 20+ guest. Older works but the defaults may not be in place.


|actions=
|actions=
# Shut off your guest. Open the hardware view in virt-manager
 
# Make sure the guest is configured with spice graphics and qxl video (this is the default if you chose 'Fedora 18' when installing)
=== Verify spice channel is configured correctly. ===
# Go to the 'Controller USB' page, change type to 'USB 2', click apply
 
# Go: Add Hardware->USB Redirection->Spice->Finish
* Start with a shutoff VM in virt-manager.
# Start the VM, but close virt-manager
* Verify the VM is using spice graphics.
# From the command line, as root, run: <br><pre>virt-viewer f18</pre>
* Verify the VM has a 'Channel spicevmc' attached.
# With virt-viewer, log into the guest so you have graphical desktop access
* Verify that 'Controller USB' has model 'USB 2'
# In virt-viewer, go to File->USB device selection, and select your USB device
* Start the VM, log in to the desktop. Open a terminal and verify the spice agent is running: <code>ps axwww | spice-vdagent</code>
# Verify the device shows up in the guest and is usable
 
# In virt-viewer, go to File->USB device selection, and unselect your device
=== USB redirection ===
# Verify the device is once again usable on the host
{{admon/note | This support requires virt-manager from Fedora 20 or later | If your virt-manager version is too old, use virt-viewer for the console bits }}
 
This streams your USB device access over a spice channel, allowing you to attach a local USB device to any VM, even one on a remote machine! And it seamlessly works even for Windows, and doesn't require any particular agent running in the VM. Yes, it's magic :)
 
* Start with a shutoff VM in virt-manager. Unplug the desired USB device from your host machine.
* Add Hardware -> USB Redirection, use the 'spicevmc' default, click apply
** Add more USB redirection devices if you want to simultaneously redirect more than one host device
* Start the VM. Log in to the desktop.
* With the VM console window focused, plug the USB device into your host machine. It should be automatically attached to your VM, and you will be notified in the VM as it sees the device attached (like a 'show files' notification for a thumb drive)
* Verify the device appears operational in the VM.
* From the virt-manager window, navigate to 'Virtual Machine->Redirect USB Device'
* See that your device is selected. Unselect it. It should revert to host access.
 
=== Host copy/paste ===
 
* Continuing from above with a running and logged in VM.
* Verify you can copy/paste back and forth between the host and the guest.
 
=== Host to guest drag and drop file transfer ===
 
* Continuing from above with a running and logged in VM.
* On the host, open a file manager like 'nautilus'. Navigate to an existing file.
* Drag the file onto the VM console window.
* Verify the file is transfered to ~/Downloads at the destination. (With Fedora 20 gnome in the guest, a window pops up showing the location of the new file).
* Note: copy only works from host to guest


|results=
|results=
No obvious errors occur, USB device is accessible like normal.
No obvious errors occur.
}}
}}


[[Category:Virtualization Test Cases]]
[[Category:Virtualization Test Cases]]

Revision as of 19:13, 8 October 2013

Description

Test fancy spice features!

Setup

Fedora 20+ host and Fedora 20+ guest. Older works but the defaults may not be in place.

How to test

Verify spice channel is configured correctly.

  • Start with a shutoff VM in virt-manager.
  • Verify the VM is using spice graphics.
  • Verify the VM has a 'Channel spicevmc' attached.
  • Verify that 'Controller USB' has model 'USB 2'
  • Start the VM, log in to the desktop. Open a terminal and verify the spice agent is running: ps axwww

Expected Results

No obvious errors occur.