135 lines
3.5 KiB
Plaintext
135 lines
3.5 KiB
Plaintext
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'
|
|
|
|
Basic Install
|
|
-------------
|
|
|
|
To build virt-manager, run the command:
|
|
|
|
./autogen.sh && ./configure && make
|
|
|
|
You can then run virt-manager in the source directory with
|
|
|
|
python src/virt-manager.py
|
|
|
|
To install the software into /usr/local (usually), you can then run:
|
|
|
|
make install
|
|
|
|
To build an RPM, you can run:
|
|
|
|
make rpm
|
|
|
|
virt-manager generally requires the latest upstream version of
|
|
python-virtinst, which checked out with
|
|
|
|
git clone git://git.fedorahosted.org/git/python-virtinst.git
|
|
|
|
If you want to replace your system installed virt-manager version,
|
|
add --prefix=/usr to ./configure. Please see the INSTALL file
|
|
for much more information about autotools install options.
|
|
|
|
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://git.fedorahosted.org/git/python-virtinst.git
|
|
|
|
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 git and submit a diff against the main source repository:
|
|
|
|
git clone git://git.fedorahosted.org/git/virt-manager.git
|
|
cd virt-manager
|
|
... make your changes ...
|
|
git commit -a -m "Some changelog message"
|
|
git show > my_feature.patch
|
|
|
|
Then mail the 'my_feature.patch' file to the virt-tools-list@redhat.com list,
|
|
with [PATCH] and a brief description in the subject.
|
|
|
|
Using git format-patch and/or git send-email is also fine.
|
|
|
|
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!
|
|
|