Go to file
Cole Robinson 3fc1ff1180 Bring borders and button spacing more inline with Gnome HIG. 2009-09-23 11:49:35 -04:00
docs Remove large design images (they are already archived on the website). 2008-08-21 18:01:59 -04:00
help Various string changes to improve consistency, usability, and HIG compliance. 2009-01-12 09:22:35 -05:00
m4 Hooked up David Malcolm's 'sparkline' widget for CPU display 2006-06-26 17:17:45 -04:00
man Update man page bug reporting info and option listing. 2009-05-12 10:35:43 -04:00
pixmaps Update new VM status icons. 2009-09-17 11:24:18 -04:00
po Updated french translation. 2009-09-23 09:04:26 -04:00
src Bring borders and button spacing more inline with Gnome HIG. 2009-09-23 11:49:35 -04:00
tests Block a new pylint check. 2009-09-17 12:31:17 -04:00
.hgignore Remove graphwidgets written in 'C'. We are now 100% python! 2009-07-22 11:16:06 -04:00
ABOUT-NLS Major rework of i18n build integration to deal with bz 229324 2007-05-18 12:14:33 -04:00
AUTHORS addhardware: Fix error message syntax typo 2009-08-31 10:45:59 -04:00
COPYING Refresh GPL text with latest FSF address & fix spec file license tag 2007-11-20 11:12:20 -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
ChangeLog Bump version number, update NEWS and CHANGELOG. 2009-07-28 21:50:55 -04:00
HACKING Add HACKING file. 2009-06-18 10:53:09 -04:00
INSTALL Added autotools support & RPM build 2006-03-29 06:40:14 -05:00
Makefile.am Remove graphwidgets written in 'C'. We are now 100% python! 2009-07-22 11:16:06 -04:00
NEWS Bump version number, update NEWS and CHANGELOG. 2009-07-28 21:50:55 -04:00
README Update docs with new mailing list address. 2009-07-28 19:24:24 -04:00
TODO Update TODO to point to online roadmap. 2009-06-18 10:54:21 -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 Build fix that allows autogen.sh to work right out of the repo. 2007-11-14 16:13:37 -05:00
configure.ac Bump version number, update NEWS and CHANGELOG. 2009-07-28 21:50:55 -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
virt-manager.spec.in Bump version number, update NEWS and CHANGELOG. 2009-07-28 21:50:55 -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

README

 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.4.0
 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

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

Contact
-------

All comments / suggestions / patches should be directed to the virt-tools-list
mailing list:

  http://www.redhat.com/mailman/listinfo/virt-tools-list

For bug reporting info, see:

http://virt-manager.org/page/BugReporting

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 export -r my_feature_revision > my_feature.patch

Then mail the 'myfeature.patch' file to et-mgmt-tools list, with [PATCH]
and a brief description in the subject.

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

Links which are relevant:

  http://libvirt.org
  http://www.linux-kvm.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!