2006-06-28 14:50:17 -05:00
|
|
|
Virtual Machine Manager
|
|
|
|
|
=======================
|
2006-03-29 05:40:14 -06:00
|
|
|
|
|
|
|
|
This application provides a graphical tool for managing virtual machines
|
|
|
|
|
via the libvirt library.
|
|
|
|
|
|
2006-07-20 10:12:22 -05:00
|
|
|
The front end of the application uses the PyGTK / Glade libraries for
|
|
|
|
|
all user interaction components. The back end uses libvirt for managing
|
2007-02-20 14:53:44 -06:00
|
|
|
Xen, QEMU & KVM virtual machines. The UI is primarily tested with Xen
|
2009-04-20 11:08:32 -05:00
|
|
|
and QEMU, but is intended to be portable to any virtualization backend
|
|
|
|
|
libvirt supports. So when libvirt is ported to UML / VmWare / etc the
|
2007-02-20 14:53:44 -06:00
|
|
|
UI should not require any significant changes to deal with these drivers.
|
2006-07-20 10:12:22 -05:00
|
|
|
|
|
|
|
|
Terminology
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
In prose this app should be referred to as 'Virtual Machine Manager'.
|
|
|
|
|
For source / RPM packaging, & the command name, it is called by the
|
|
|
|
|
shortened form 'virt-manager'
|
|
|
|
|
|
|
|
|
|
Pre-requisite software
|
|
|
|
|
----------------------
|
|
|
|
|
|
|
|
|
|
Where versions are noted below these are the versions tested to definitely
|
|
|
|
|
work. For some of them you may be able to run with earlier releases, so
|
2009-04-20 11:08:32 -05:00
|
|
|
please report any success to the mailing lists
|
2006-07-20 10:12:22 -05:00
|
|
|
|
|
|
|
|
python >= 2.4
|
|
|
|
|
pygtk2 >= 1.99.12-6
|
|
|
|
|
gnome-python2-gconf >= 1.99.11-7
|
2008-01-31 10:39:10 -06:00
|
|
|
libvirt-python >= 0.4.0
|
2006-07-20 10:12:22 -05:00
|
|
|
dbus-python >= 0.61
|
|
|
|
|
gnome-keyring >= 0.4.9
|
2006-08-15 15:07:17 -05:00
|
|
|
gnome-python-desktop >= 2.15.4
|
2006-08-10 15:47:14 -05:00
|
|
|
libxml2-python >= 2.6.23
|
|
|
|
|
vte >= 0.12.2
|
2007-07-06 16:46:50 -05:00
|
|
|
gtk-vnc >= 0.0.1
|
2008-01-31 10:39:10 -06:00
|
|
|
python-virtinst >= 0.300.0
|
|
|
|
|
PolicyKit >= 0.6
|
2006-08-22 13:50:45 -05:00
|
|
|
|
|
|
|
|
The latter is available from
|
|
|
|
|
|
2006-10-19 09:29:43 -05:00
|
|
|
http://hg.et.redhat.com/virt/applications/virtinst--devel
|
2006-07-20 10:12:22 -05:00
|
|
|
|
|
|
|
|
Contact
|
|
|
|
|
-------
|
|
|
|
|
|
2009-04-20 11:08:32 -05:00
|
|
|
All comments / suggestions / patches should be directed to the et-mgmt-tools
|
2006-07-20 10:12:22 -05:00
|
|
|
mailing list:
|
|
|
|
|
|
2009-04-20 11:08:32 -05:00
|
|
|
http://www.redhat.com/mailman/listinfo/et-mgmt-tools
|
|
|
|
|
|
|
|
|
|
Bugs should be reported at bugzilla.redhat.com, against the 'virt-manager'
|
|
|
|
|
component.
|
|
|
|
|
|
|
|
|
|
If you built from source, use Product: 'Virtualization Tools'.
|
|
|
|
|
|
|
|
|
|
If you are using a package provided by Fedora, use Product: 'Fedora'.
|
|
|
|
|
|
|
|
|
|
If you are using another distros package, either file a bug with them,
|
|
|
|
|
or use the 'Virtualization Tools' product as above.
|
2006-07-20 10:12:22 -05:00
|
|
|
|
2007-08-15 16:04:51 -05:00
|
|
|
There are further project details on the website:
|
2006-07-20 10:12:22 -05:00
|
|
|
|
2007-08-29 16:05:11 -05:00
|
|
|
http://virt-manager.org/
|
2006-07-20 10:12:22 -05:00
|
|
|
|
|
|
|
|
Submitting patches
|
|
|
|
|
------------------
|
|
|
|
|
|
|
|
|
|
Patches should be submitted either as unified diffs:
|
|
|
|
|
|
|
|
|
|
tar zxvf virt-manager-X.Y.Z.tar.gz
|
|
|
|
|
cp -a virt-manager-X.Y.Z virt-manager-X.Y.Z-myfeature
|
|
|
|
|
cd virt-manager-X.Y.Z-myfeature
|
2009-04-20 11:08:32 -05:00
|
|
|
... make some changes ..
|
2006-07-20 10:12:22 -05:00
|
|
|
cd ..
|
|
|
|
|
diff -ruN virt-manager-X.Y.Z virt-manager-X.Y.Z-myfeature \
|
|
|
|
|
> myfeature.patch
|
|
|
|
|
|
|
|
|
|
Alternatively use Mercurial and submit a changeset bundle against
|
|
|
|
|
the main source repository:
|
|
|
|
|
|
|
|
|
|
hg clone http://hg.et.redhat.com/virt/applications/virt-manager--devel
|
|
|
|
|
cd virt-manager--devel
|
|
|
|
|
... make some changes & commit them locally...
|
2009-04-20 11:08:32 -05:00
|
|
|
hg export -r my_feature_revision > my_feature.patch
|
2006-07-20 10:12:22 -05:00
|
|
|
|
2009-04-20 11:08:32 -05:00
|
|
|
Then mail the 'myfeature.patch' file to et-mgmt-tools list, with [PATCH]
|
|
|
|
|
and a brief description in the subject.
|
2006-07-20 10:12:22 -05:00
|
|
|
|
|
|
|
|
Related software
|
|
|
|
|
----------------
|
|
|
|
|
|
|
|
|
|
Links which are relevant:
|
|
|
|
|
|
|
|
|
|
http://libvirt.org
|
2009-04-20 11:08:32 -05:00
|
|
|
http://www.linux-kvm.org
|
2006-07-20 10:12:22 -05:00
|
|
|
http://xensource.com/xen/
|
|
|
|
|
http://pygtk.org/
|
|
|
|
|
http://gtk.org/
|
2007-08-29 16:05:11 -05:00
|
|
|
http://gtk-vnc.sourceforge.net/
|
2006-07-20 10:12:22 -05:00
|
|
|
|
|
|
|
|
Copyright / License
|
|
|
|
|
--------------------
|
|
|
|
|
|
|
|
|
|
Unless otherwise noted, all the code for the Virtual Machine Manager
|
|
|
|
|
is covered under the GPL, and Copyright (C) Red Hat.
|
|
|
|
|
|
|
|
|
|
-- End of broadcast!
|
|
|
|
|
|
