SPICE
Example using SPICE and QXL for improved Graphics experience in the guest
This example is based on qemu-kvm (0.15.0) as installed in Fedora 15. Will first show how to do this manually, and second how to do it using the virt-manager tool.
For extensive details on SPICE, visit http://spice-space.org
Manually, using qemu-kvm command line directly
The simplest part is adding the qxl graphics device to the guest. By adding -vga qxl
:
# /usr/bin/qemu-kvm -m 1024 -name f15 -drive file=/images/f15.img,if=virtio -vga qxl
You'll see a normal SDL window pop up, and if you poke inside the guest you'll find that X is using the qxl device to display:
$ lspci ... 00:02.0 VGA compatible controller: Red Hat, Inc. Device 0100 (rev 03)
$ grep QXL /var/log/Xorg.0.log [ 15.878] (II) qxl: Driver for QXL virtual graphics: QXL 1
However, this is not enough to use SPICE. We need to enable the spice server in qemu-kvm. We also need a client to view the guest. So first be sure the client is installed:
# yum install spice-client
To keep it simple, we'll not require authentication and simply bind the server to 127.0.0.1 on port 5900.
# /usr/bin/qemu-kvm -m 1024 -name f15 -drive file=/images/f15.img,if=virtio -vga qxl -spice port=5900,addr=127.0.0.1,disable-ticketing
This will not pop up an SDL window, so launch the client to connect to the guest.
$ spicec -h 127.0.0.1 -p 5900
We're getting closer. Now the only thing left is to improve the experience by enabling the spice agent communication channel between the host and the guest (you wanted copy and paste between host and guest right? ;)
This part is a bit arcane. We need to add a virtio-serial device to the guest, and open a port for the spice vdagent. We also need to install the spice vdagent in guest. Be sure the agent is running (and for future, started automatically).
First the guest side, since the guest is running.
# yum install spice-vdagent # chkconfig --add spice-vdagentd
Now stop the guest and we'll build up the hostside qemu-kvm commandline.
We need to add the virtio-serial device: -device virtio-serial-pci
We need to add a port for spice in that device: -device virtserialport,chardev=spicechannel0,name=com.redhat.spice.0
And we need a spicevmc chardev for that port: -chardev spicevmc,id=spicechannel0,name=vdagent
It's important that the virserialport chardev=
option matches the <cdoe>id= given the chardev (spicechannel0
in this example). It's also important that the port's name=
is com.redhat.spice.0
, because that's the namespace spice-vdagentd is looking for in the guest. And finally, you need to specify name=vdagent
so spice knows what this channel is for.
So we launch the guest one last time with the complete command line:
# /usr/bin/qemu-kvm -m 1024 -name f15 -drive file=/images/f15.img,if=virtio -vga qxl -spice port=5900,addr=127.0.0.1,disable-ticketing -device virtio-serial-pci -device virtserialport,chardev=spicechannel0,name=com.redhat.spice.0 -chardev spicevmc,id=spicechannel0,name=vdagent
And kick off a spice client:
$ spicec -h 127.0.0.1 -p 5900
Now you can login to the guest, and you'll still see the qxl display device. In addition, you'll see the virtio-serial port:
$ ls /dev/virtio-ports/ com.redhat.spice.0
Now test it out. Grab some text and copy it to the clipboard in the guest. (In gnome-terminal it's Shift-Ctrl-C to copy). And paste it in the host (again, Shift-Ctrl-V to paste in gnome-terminal).
Enabling SPICE using virt-manager
This assumes you've already installed a guest with virt-manager or virt-install and it's shut off.
Start virt-manager, and open your VM by double clicking on it. Click the virtual hardware details (lightbulb).
First we need to make the Video card a qxl device. Click on Video, and in the Model pulldown, choose, qxl. And Apply.
Next we need to change the display from VNC to Spice. Click on Display VNC, and in the Type pulldown, choose Spice. And Apply. You'll be prompted to add the Spice agent channels, click Yes. (notice the additional Controller Virtio Serial too).
Now start the VM. virt-manager has a spice-gtk client built-in. So you don't need to fuss with a manual spice client like you did above. You still need to be sure that the guest has spice-vdagent installed and running. In the guest:
# yum install spice-vdagent # chkconfig --add spice-vdagentd # service start spice-vdagentd ... log out of X, and log back in, verify agent is running... $ ps -ef | grep vdagent root 1653 1 0 14:54 ? 00:00:00 /usr/sbin/spice-vdagentd gdm 1703 1 0 14:54 ? 00:00:00 /usr/bin/spice-vdagent chrisw 1932 1 0 14:55 ? 00:00:00 /usr/bin/spice-vdagent
And you're done. Test copy and paste and enjoy.