README.RHEL-5

   1 spice-vdagent and RHEL-5 README
   2 -------------------------------
   3
   4 spice-vdagent can also be used inside RHEL-5 guests, if, and only if, they
   5 are hosted on a host which uses virtio-serial as the agent channel. Note
   6 that older hosts, such as qemu shipped with RHEL-5 for example, use
   7 a custom pci device (the spicevmc device) for the agent channel and
   8 there is no Linux support for this device so spice-vdagent does not work
   9 inside guests hosted on such hosts! Hosts based on RHEL-6 or Fedora 15
  10 and newer for example, are fine.
  11
  12 spice-vdagent relies on ConsoleKit to determine the active session, since
  13 RHEL-5 has no ConsoleKit it cannot do this on RHEL-5, therefor only 1
  14 active X-session is supported with RHEL-5. If you try to start multiple
  15 sessions by running multiple X-servers the agent will disable itself.
  16
  17 Since the RHEL-5 X-server does not support hotplugging of input devices,
  18 spice-vdagentd must be started before the X-server, so that it can create
  19 the uinput tablet device it uses for agent mouse mode.
  20
  21 This also means that you must use a customized xorg.conf to teach the
  22 X-server about the uinput device. An example xorg.conf is included with
  23 spice-vdagent. After installing spice-vdagent, first start spice-vdagentd,
  24 and then copy this file to /etc/X11/xorg.conf and restart your X-server.
  25
  26 Note: the sample xorg.conf assumes that the vm has been configured to *not*
  27 use a usb tablet device, since there is no need for one with the agent and
  28 usb emulation takes a significant amount of CPU.
  29
  30 Building from source for RHEL-5
  31 -------------------------------
  32
  33 If you're building spice-vdagent from source on RHEL-5, you must pass
  34 --disable-console-kit --enable-static-uinput to ./configure!