Commits (408)
This diff is collapsed.
The following commands will be useful for anyone writing patches:
./setup.py test # Run local unit test suite
./setup.py pylint # Run a pylint script against the codebase
./setup.py codespell # Run a codespell script against the codebase
Any patches shouldn't change the output of 'test', 'pylint' or 'codespell'. The
'pylint' requires [`pylint`](https://github.com/PyCQA/pylint) and
[`pycodestyle`](https://github.com/pycqa/pycodestyle) to be installed. The
'codespell' requires
[`codespell`](https://github.com/codespell-project/codespell) to be installed.
Our pylint script uses a blacklist rather than a whitelist approach,
so it could throw some false positives or useless messages. If you think
your patch exposes one of these, bring it up on the mailing list.
'test*' have a `--debug` option if you are hitting problems.
For more options, use `./setup.py test --help`.
One useful way to manually test virt-manager's UI is using libvirt's
unit test driver. From the source directory, Launch virt-manager like:
virt-manager --connect test://$PWD/tests/testdriver.xml
This testdriver has many fake XML definitions that can be used to see each bit
of virt-manager's UI. It also enables testing the various wizards without
having to alter your host virt config.
Also, there's a few standalone specialty tests:
./setup.py test_urls # Test fetching media from distro URLs
./setup.py test_initrd_inject # Test --initrd-inject
We use [glade-3](https://glade.gnome.org/) for building virt-manager's UI.
It is recommended you have a fairly recent version of `glade-3`. If a small UI
change seems to rewrite the entire glade file, you likely have a too old
(or too new :) glade version.
## Submitting patches
Patches should be developed against a git checkout and **not** a source
release(see [git repository](https://github.com/virt-manager/virt-manager)).
Patches should be sent to the
[mailing list](https://www.redhat.com/mailman/listinfo/virt-tools-list).
Using git format-patch/send-email is preferred, but an attachment with
format-patch output is fine too.
Small patches are acceptable via github pull-request, but anything
non-trivial should be sent to the mailing list.
## Translations
Translations are handled at `fedora.zanata.org`. Please register for a Fedora
account and request access to a translation team, as described at
[Translate on Zanata](https://fedoraproject.org/wiki/L10N/Translate_on_Zanata).
And contribute to
[virt-manager at Zanata](https://fedora.zanata.org/project/view/virt-manager/).
# Basic Install
For starters, if you just want to run `virt-manager/virt-install` to test out
changes, it can be done from the source directory:
To install the software into `/usr/local` (usually), you can do:
./setup.py install
To build an RPM, you can run:
./setup.py rpm
`setup.py` generally has all the build and install commands, for more info see:
- `./setup.py --help-commands`
- `./setup.py install --help`
- [Python Standard Build and Install](https://docs.python.org/3/install/#standard-build-and-install)
## Pre-requisite software
A detailed dependency list can be found in
[virt-manager.spec.in](virt-manager.spec.in) file.
Minimum version requirements of major components:
- python >= 3.3
- gtk3 >= 3.14
- libvirt-python >= 0.6.0
- pygobject3 >= 3.14
- libosinfo >= 0.2.10
On Debian or Ubuntu based distributions, you need to install the
`gobject-introspection` bindings for some dependencies like `libvirt-glib`
and `libosinfo`. Look for package names that start with `'gir'`, for example
# to be included/excluded from the tarball produced by sdist
include MANIFEST.in
include setup.py
include virt-*
recursive-include data *
exclude data/gschemas.compiled
recursive-include man *
recursive-include po *
recursive-include tests *
recursive-include ui *
recursive-include virtManager *
recursive-include virtcli *
recursive-include virtconv *
recursive-include virtinst *
global-exclude *.pyc
This diff is collapsed.
Metadata-Version: 1.0
Name: virt-manager
Version: 2.0.0
Summary: UNKNOWN
Home-page: http://virt-manager.org
Author: Cole Robinson
Author-email: virt-tools-list@redhat.com
License: GPLv2+
Description: UNKNOWN
Platform: UNKNOWN
# Virtual Machine Manager
This application provides a graphical tool for managing virtual machines
via the [libvirt](https://libvirt.org) library.
The front end of the application uses the GTK / Glade libraries for
all user interaction components. The back end uses libvirt for managing
Qemu/KVM and Xen virtual machines, as well as LXC containers. The UI is
primarily tested with KVM, but is intended to be reasonably portable to any
virtualization backend libvirt supports.
Several command line tools are also provided:
- `virt-install`: Create new libvirt virtual machines
- `virt-clone`: Duplicate existing libvirt virtual machines
- `virt-xml`: Edit existing libvirt virtual machines/manipulate libvirt XML
- `virt-convert`: Convert VMX or OVF configs to libvirt virtual machines
For dependency info and installation instructions, see the
[INSTALL.md](INSTALL.md) file.
## Contact
- All comments / suggestions / patches should be directed to the
mailing list.
- For IRC we use #virt on OFTC.
- For bug reporting info, see
- There are further project details on the
[virt-manager](https://virt-manager.org/) website.
- See the [HACKING.md](HACKING.md) file for info about submitting patches or
contributing translations.
This diff is collapsed.
<?xml version="1.0" encoding="UTF-8"?>
<component type="desktop">
<_name>Virtual Machine Manager</_name>
<_summary>Graphically manage KVM, Xen, or LXC via libvirt</_summary>
Virtual Machine Manager provides a graphical tool for administering virtual
machines for KVM, Xen, and LXC. Start, stop, add or remove virtual devices,
connect to a graphical or serial console, and see resource usage statistics
for existing VMs on local or remote machines. Uses libvirt as the backend
management API.
<screenshot type="default">
<_caption>Main manager window</_caption>
<_caption>Virtual machine configuration screen</_caption>
<_caption>Graphical console connection for a virtual machine</_caption>
<url type="homepage">https://www.virt-manager.org/</url>
<url type="bugtracker">https://bugzilla.redhat.com/enter_bug.cgi?product=Virtualization%20Tools&amp;component=virt-manager</url>
<translation type="gettext">virt-manager</translation>
[Desktop Entry]
_Name=Virtual Machine Manager
_Comment=Manage virtual machines
Access Control
Access to the libvirt socket is controlled by membership in the "libvirt"
group. If you want to manage virtual machines as non root you need to add your
user to that group or you have to use the session uris like qemu:///session.
See also /usr/share/doc/libvirt-bin/README.Debian.
-- Guido Guenther <agx@sigxcpu.org> Thu, 04 Jun 2010 11:46:03 +0100
Access Control
Access to the libvirt socket is controlled by membership in the "libvirt"
group. If you want to manage virtual machines as non root you need to add your
user to that group or you have to use the session uris like qemu:///session.
See also /usr/share/doc/libvirt-daemon-system/README.Debian.gz.
-- Guido Guenther <agx@sigxcpu.org> Thu, 04 Jun 2010 11:46:03 +0100
This package is maintained with git-buildpackage(1). It follows DEP-14
for branch naming (e.g. using debian/sid for the current version
in Debian unstable).
It uses pristine-tar(1) to store enough information in git to generate
bit identical tarballs when building the package without having
downloaded an upstream tarball first.
When working with patches it is recommended to use "gbp pq import" to
import the patches, modify the source and then use "gbp pq export
--commit" to commit the modifications.
The changelog is generated using "gbp dch" so if you submit any
changes don't bother to add changelog entries but rather provide
a nice git commit message that can then end up in the changelog.
It is recommended to build the package with pbuilder using:
gbp builpackage --git-pbuilder
For information on how to set up a pbuilder environment see the
git-pbuilder(1) manpage. In short:
DIST=sid git-pbuilder create
gbp clone <project-url>
cd <project>
gbp buildpackage --git-pbuilder
-- Guido Günther <agx@igxcpu.org>, Wed, 2 Dec 2015 18:51:15 +0100
When reporting issues regarding virt-manager please run the program using the
--debug --no-fork command line options and provide the output.
Often the problem isn't related to virt-manager at all. Please also check the
libvirt and VM logfiles and try to reproduce with virsh or virt-install.
http://wiki.debian.org/libvirt/Debugging has more information on howto provide
debugging information for the virt-* tools.
This diff is collapsed.
Source: virt-manager
Section: admin
Priority: optional
Maintainer: Debian Libvirt Maintainers <pkg-libvirt-maintainers@lists.alioth.debian.org>
Uploaders: Guido Günther <agx@sigxcpu.org>, Laurent Léonard <laurent@open-minds.org>
Standards-Version: 4.1.1
Vcs-Git: https://salsa.debian.org/libvirt-team/virt-manager.git
Vcs-Browser: https://salsa.debian.org/libvirt-team/virt-manager
Homepage: http://virt-manager.org/
debhelper (>= 10~),
# for the tests
Package: virt-manager
Architecture: all
Depends: ${misc:Depends}, ${python3:Depends},
python3-libvirt (>= 0.7.1),
gir1.2-gtk-3.0 (>= 3.10),
virtinst (>= ${binary:Version}),
Recommends: libvirt-daemon-system (>= 1.2.7),
Suggests: virt-viewer, ssh-askpass, gnome-keyring, gir1.2-secret-1,
Description: desktop application for managing virtual machines
It presents a summary view of running domains and their live performance &
resource utilization statistics. A detailed view presents graphs showing
performance & utilization over time. Ultimately it will allow creation of new
domains, and configuration & adjustment of a domain's resource allocation &
virtual hardware. Finally an embedded VNC client viewer presents a full
graphical console to the guest domain.
NOTE: the GUI is still considered experimental.
Package: virtinst
Architecture: all
python3-libvirt (>= 0.4.6),
Recommends: virt-viewer, qemu-utils
Description: Programs to create and clone virtual machines
Virtinst is a set of commandline tools to create virtual machines using
virt-install: provision new virtual machines
virt-clone: clone existing virtual machines
virt-xml: edit libvirt XML using command line options.
virt-convert: convert virtual machines between formats
This is the Ubuntu / Debian GNU/Linux prepackaged version of the
Virtual Machine Manger.
Packaged by Marcelo Boveto Shima <marceloshima@gmail.com>
and Guido Guenther <agx@sigxcpu.org>
Downloaded from http://virt-manager.et.redhat.com/download.html
Upstream Author:
Daniel Berrange <berrange-at-redhat-dot-com>
Hugh O. Brock <hbrock-at-redhat-dot-com>
Jeremy Katz <katzj-at-redhat-dot-com>
Daniel Berrange <berrange-at-redhat-dot-com>
Red Hat, Inc.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; version 2 dated June, 1991.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 51 Franklin
St, Fifth Floor, Boston, MA 02110-1301, USA.
On Ubuntu / Debian GNU/Linux systems, the complete text of the GNU
General Public License can be found in `/usr/share/common-licenses/GPL'.
Copyright (C) 2005-2006 Red Hat, Inc., David Malcolm <dmalcolm@redhat.com>
Copyright (C) 2006 Daniel P. Berrange <berrange@redhat.com>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
You should have received a copy of the GNU Library General Public License with
this program; if not, write to the Free Software Foundation, Inc., 51 Franklin
St, Fifth Floor, Boston, MA 02110-1301, USA.
On Ubuntu / Debian GNU/Linux systems, the complete text of the GNU
General Library Public License can be found in
Copyright 2007 Red Hat Inc., and Hugh Brock
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation
License (GFDL), Version 1.1 or any later version published
by the Free Software Foundation with no Invariant Sections,
no Front-Cover Texts, and no Back-Cover Texts.
On Ubuntu / Debian GNU/Linux systems, the complete text of the GNU Free
Documentation License can be found in `/usr/share/common-licenses/GFDL'.
patch-numbers = False
From: =?utf-8?q?Guido_G=C3=BCnther?= <agx@sigxcpu.org>
Date: Sat, 24 Dec 2016 01:18:30 +0100
Subject: Use /usr/bin/python3
so we don't have to worry about picking up the wrong version
setup.py | 3 +--
virt-clone | 2 +-
virt-convert | 2 +-
virt-install | 2 +-
virt-manager | 2 +-
virt-xml | 2 +-
6 files changed, 6 insertions(+), 7 deletions(-)
diff --git a/setup.py b/setup.py
index 2e1215c..17c497f 100755
--- a/setup.py
+++ b/setup.py
@@ -1,9 +1,8 @@
-#!/usr/bin/env python3
# This work is licensed under the GNU GPLv2 or later.
# See the COPYING file in the top-level directory.
import glob
import fnmatch
import os
diff --git a/virt-clone b/virt-clone
index d1eedee..823990d 100755
--- a/virt-clone
+++ b/virt-clone
@@ -1,4 +1,4 @@
-#!/usr/bin/env python3
# Copyright(c) FUJITSU Limited 2007.
diff --git a/virt-convert b/virt-convert
index 1b7b796..6f44902 100755
--- a/virt-convert
+++ b/virt-convert
@@ -1,4 +1,4 @@
-#!/usr/bin/env python3
# Copyright 2008, 2013, 2014 Red Hat, Inc.
# Joey Boggs <jboggs@redhat.com>
diff --git a/virt-install b/virt-install
index a7f247f..e09553e 100755
--- a/virt-install
+++ b/virt-install
@@ -1,4 +1,4 @@
-#!/usr/bin/env python3
# Copyright 2005-2014 Red Hat, Inc.
diff --git a/virt-manager b/virt-manager
index 15d5109..b608ff7 100755
--- a/virt-manager
+++ b/virt-manager
@@ -1,4 +1,4 @@
-#!/usr/bin/env python3
# Copyright (C) 2006, 2014 Red Hat, Inc.
# Copyright (C) 2006 Daniel P. Berrange <berrange@redhat.com>
diff --git a/virt-xml b/virt-xml
index 9bdde95..b8fddac 100755
--- a/virt-xml
+++ b/virt-xml
@@ -1,4 +1,4 @@
-#!/usr/bin/env python3
# Copyright 2013-2014 Red Hat, Inc.
# Cole Robinson <crobinso@redhat.com>
#!/usr/bin/make -f
dh $@ --with python3 --buildsystem=pybuild
dh_python3 -O--buildsystem=python_distutils
dh_python3 -p virtinst usr/share/virt-manager
ifneq (,$(filter check,$(DEB_BUILD_OPTIONS)))
python3 setup.py test
@echo "Checks disabled atm"
python3 setup.py --no-update-icon-cache --no-compile-schemas install --force --root=debian/tmp --no-compile -O0
dh_install debian/10_virt-manager.gschema.override \
rm -f data/gschemas.compiled
Tests: help.sh
Restrictions: superficial
Depends: virtinst,
Tests: virt-manager.sh
Restrictions: superficial
Depends: virt-manager,