Frequently Asked Questions
- What license is "Virtual Machine Manager" distributed under?
- It is distributed under the GNU General Public License, see the file COPYING in the distribution for the precise wording.
- What language is the application written it ?
- The application is being written in Python because it allows for very fast development, without sacrificing too much performance.
Build / installation
- What is the process to build & install "Virtual Machine Manager"?
In common with most UNIX applications "Virtual Machine Manager" uses GNU AutoTools for its build system. Thus the standard compilation instructions can be followed:
tar xfvz virt-manager-xxx.tar.gz cd virt-manager-xxxx ./configure --prefix=/path/to/install/root make make install
- What other libraries are needed prior to installing "Virtual Machine Manager"?
All libraries virt-manager depends on are available under a GPL compatible license. The core libraries are Python (for the app itself), GTK+PyGTK (for UI) and libvirt (for the virtualization APIs). The exact list varies over time according, so consult the details on the download page.
Managing Xen Virtual Machines
- How do I launch the application
Either use the menu entry
Applications -> System Tools -> Virtual Machine Manager, or simply run
virt-managerfrom the command line
- Why don't I get a virtual console for the virtual machine?
- Virtual framebuffer support is a very new feature in Xen, and is evolving / developing rapidly. In version 3.0.2 it is only available for HVM/SVM based virtual machines. Work to provide a virtual framebuffer to paravirtualized machines is ongoing, if we're very lucky, to be available in 3.0.3, but more likely to be Xen 3.0.4. If you do have virtual framebuffer support, make sure that the guest domain has the 'vnc=1' config option enabled. Also make sure the root user has a valid VNC password file.
- Why are the pause/shutdown/etc buttons disabled?
- These buttons are always disabled if you are viewing the 'Domain-0' guest since this is the mangement OS, it doesn't make sense to try and pause/stop it. They will also be disabled if you selected a 'read only' connection to Xen.
- Why is the read only button forced on, and disabled changes?
- While XenD does allow unprivileged users to change domains, this is considered to be a security hole, so the application forces an read only connection for non-root users. At a later date when XenD obtains a secure means for allowing authenticated access to non-root users this restriction will be lifted.
- How do I run the manager remotely if I don't have a graphical desktop on the machine?
Since the remote HTTP/HTTPS access to XenD is horrifically insecure this is disabled by default. The preferred method at this time is to run the Virtual Machine Manager within a VNC server session. To do this, login to your host as root and create a file
#!/bin/sh vncconfig -iconic & if test -z "$DBUS_SESSION_BUS_ADDRESS" ; then eval `dbus-launch --sh-syntax --exit-with-session` fi exec gnome-session
If you plan to create any HVM (ie fully virt) guests, then when launching the VNC server make sure you pick a really large display number. If you don't, then your VNC desktop may well clash with the VNC server exporting the guest's domain. eg run
# vncserver :60
- Why does the virtual console mouse cursor position bear no resemblance to local mouse?
- The current Xen framebuffer cursor driver is pretty horribly broken. The mouse cursor range & position rarely matches up correctly with actual screen dimensions. In addition it is very slow to track movement. To work around this problem, when clicking on the virtual console window, the mouse pointer will be 'grabbed' and confined to the console window until Ctrl+Alt is pressed.
- How do you send special key strokes to the guest console?
- If trying to press
"Ctrl+Alt+F1"to switch virtual consoles in a guest, it is very likely that the local X server will intercept the keystroke and switch consoles on the host machine instead. To work around this problem, the virtual console window has the idea of 'sticky' keys. If you press a modifier key 3 times in a row, it will stick on until the next non-modifier key is released. So to send
"Ctrl+Alt+F1"to the guest, one can use the sequence
"Ctrl Ctrl Ctrl Alt+F1"