Desktop tool for managing virtual machines via libvirt
Go to file
Daniel P. Berrange b179a37579 Refresh changelog
2007-09-25 11:57:27 -04:00
docs Fixed a number of typos in manual page & documentation (Atsushi SAKAI) 2007-08-15 17:04:51 -04:00
help Fixed a number of typos in manual page & documentation (Atsushi SAKAI) 2007-08-15 17:04:51 -04:00
m4 Hooked up David Malcolm's 'sparkline' widget for CPU display 2006-06-26 17:17:45 -04:00
man Fixed a number of typos in manual page & documentation (Atsushi SAKAI) 2007-08-15 17:04:51 -04:00
pixmaps Remove unused icons 2007-07-14 14:43:59 -04:00
po Refresh polish translation again (Piotr Drąg) 2007-09-05 19:23:12 -04:00
src Fix an order-of-operations bug; also, look for the target dev when removing a disk, not the source, since source may not actually be there. 2007-09-25 11:35:49 -04:00
.hgignore Major rework of i18n build integration to deal with bz 229324 2007-05-18 12:14:33 -04:00
ABOUT-NLS Major rework of i18n build integration to deal with bz 229324 2007-05-18 12:14:33 -04:00
AUTHORS Move connection state management into vmmConnection class 2007-09-09 22:57:24 -04:00
autobuild.sh Major rework of i18n build integration to deal with bz 229324 2007-05-18 12:14:33 -04:00
autogen.sh Hack around autoconf wierdness 2007-08-16 16:11:25 -04:00
ChangeLog Refresh changelog 2007-09-25 11:57:27 -04:00
configure.ac Prep for 0.5.1 release 2007-09-25 11:57:14 -04:00
COPYING Added autotools support & RPM build 2006-03-29 06:40:14 -05:00
COPYING-DOCS Initial cut at help infrastructure. Help builds and displays, but says nothing. Now we can start filling in content. 2007-03-02 16:24:35 -05:00
INSTALL Added autotools support & RPM build 2006-03-29 06:40:14 -05:00
Makefile.am Added basic manual page 2007-07-24 15:38:31 -04:00
NEWS Prep for 0.5.1 release 2007-09-25 11:57:14 -04:00
omf.make Initial cut at help infrastructure. Help builds and displays, but says nothing. Now we can start filling in content. 2007-03-02 16:24:35 -05:00
README Update README to match latest reality 2007-08-29 17:05:11 -04:00
TODO Fixed a number of typos in manual page & documentation (Atsushi SAKAI) 2007-08-15 17:04:51 -04:00
virt-manager.spec.in Prep for 0.5.1 release 2007-09-25 11:57:14 -04:00
xmldocs.make Hooked up the half-finished help document to a new help menu item. More fun to come. 2007-03-08 14:07:00 -05:00

 Virtual Machine Manager
 =======================

This application provides a graphical tool for managing virtual machines
via the libvirt library.

The front end of the application uses the PyGTK / Glade libraries for
all user interaction components. The back end uses libvirt for managing
Xen, QEMU & KVM virtual machines. The UI is primarily tested with Xen
and QEMU, but is intended to be portable to any virtualization backend 
libvirt supports. So when libvirt is ported to UML / VmWare / etc the 
UI should not require any significant changes to deal with these drivers.

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
please report any success to the mailing lists 

 python  >= 2.4
 pygtk2 >= 1.99.12-6
 gnome-python2-gconf >= 1.99.11-7
 libvirt-python >= 0.2.1
 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.103.0

The latter is available from

http://hg.et.redhat.com/virt/applications/virtinst--devel

Contact
-------

All comments / suggestions / patches should be directed to the fedora-xen
mailing list:

  http://www.redhat.com/mailman/listinfo/fedora-xen

There are further project details on the website:

  http://virt-manager.org/

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
   ... make some changes .. 
   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...
   hg bundle myfeature.hg http://hg.et.redhat.com/virt/applications/virt-manager--devel

Then mail the 'myfeature.hg' file to fedora-xen list. This approach is
preferred to plain patches, because the Mercurial bundle preserves all
your local commit messages & history.

Related software
----------------

Links which are relevant:

  http://libvirt.org
  http://xensource.com/xen/
  http://pygtk.org/
  http://gtk.org/
  http://gtk-vnc.sourceforge.net/

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!