From Fedora Project Wiki

(Fix page formatting)
(Remove f20 warning)
Line 18: Line 18:
  
 
=== USB redirection ===
 
=== USB redirection ===
{{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 :)
 
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 :)
  

Revision as of 17:01, 17 September 2014

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 | spice-vdagent

USB redirection

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

Expected Results

No obvious errors occur.