virt-manager/README

105 lines
2.8 KiB
Plaintext
Raw Normal View History

Virtual Machine Manager
=======================
2006-03-29 19:40:14 +08:00
This application provides a graphical tool for managing virtual machines
via the libvirt library.
2006-07-20 23:12:22 +08: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-21 04:53:44 +08:00
Xen, QEMU & KVM virtual machines. The UI is primarily tested with Xen
2009-04-21 00:08:32 +08: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-21 04:53:44 +08:00
UI should not require any significant changes to deal with these drivers.
2006-07-20 23:12:22 +08: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-21 00:08:32 +08:00
please report any success to the mailing lists
2006-07-20 23:12:22 +08:00
python >= 2.4
pygtk2 >= 1.99.12-6
gnome-python2-gconf >= 1.99.11-7
libvirt-python >= 0.4.0
2006-07-20 23:12:22 +08:00
dbus-python >= 0.61
gnome-keyring >= 0.4.9
gnome-python-desktop >= 2.15.4
libxml2-python >= 2.6.23
vte >= 0.12.2
gtk-vnc >= 0.0.1
python-virtinst >= 0.300.0
PolicyKit >= 0.6
The latter is available from
2006-10-19 22:29:43 +08:00
http://hg.et.redhat.com/virt/applications/virtinst--devel
2006-07-20 23:12:22 +08:00
Contact
-------
All comments / suggestions / patches should be directed to the virt-tools-list
2006-07-20 23:12:22 +08:00
mailing list:
http://www.redhat.com/mailman/listinfo/virt-tools-list
2009-04-21 00:08:32 +08:00
For bug reporting info, see:
2009-04-21 00:08:32 +08:00
http://virt-manager.org/page/BugReporting
2006-07-20 23:12:22 +08:00
There are further project details on the website:
2006-07-20 23:12:22 +08:00
2007-08-30 05:05:11 +08:00
http://virt-manager.org/
2006-07-20 23:12:22 +08: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-21 00:08:32 +08:00
... make some changes ..
2006-07-20 23:12:22 +08: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-21 00:08:32 +08:00
hg export -r my_feature_revision > my_feature.patch
2006-07-20 23:12:22 +08:00
2009-04-21 00:08:32 +08:00
Then mail the 'myfeature.patch' file to et-mgmt-tools list, with [PATCH]
and a brief description in the subject.
2006-07-20 23:12:22 +08:00
Related software
----------------
Links which are relevant:
http://libvirt.org
2009-04-21 00:08:32 +08:00
http://www.linux-kvm.org
2006-07-20 23:12:22 +08:00
http://xensource.com/xen/
http://pygtk.org/
http://gtk.org/
2007-08-30 05:05:11 +08:00
http://gtk-vnc.sourceforge.net/
2006-07-20 23:12:22 +08: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!