...
 
Commits (419)
# Contribute to virt-manager
## Bug reporting
The preferred place for bug reports is bugzilla.redhat.com. This
is documented more at https://virt-manager.org/bugs/
Small issues can be reported in the
[github issue tracker](https://github.com/virt-manager/virt-manager/issues).
Anything that's non-trivial, or is a feature request, should be filed in
bugzilla.
Please only file issues if they apply to the latest version of
virt-manager. If you are using an older version from a distro,
please file a bug with them.
When filing a bug, please reproduce the issue with the `--debug`
flag passed to the tool and attach the full output in the bug
report.
## Writing patches
The following commands will be useful for anyone writing patches:
```sh
./setup.py test # Run local unit test suite
./setup.py pylint # Run pylint/pycodestyle checking
```
Any patches shouldn't change the output of 'test' or 'pylint'. Depending
on what version of libvirt or pylint is installed, you may see some
pre-existing errors from these commands. The important thing is that
any changes you make do not add additional errors.
The 'pylint' command requires [`pylint`](https://github.com/PyCQA/pylint)
and [`pycodestyle`](https://github.com/pycqa/pycodestyle) to be installed.
If [`codespell`](https://github.com/codespell-project/codespell) is installed,
it will be invoked as well.
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:
```sh
./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.
The command line tools can be tested similarly. To run a virt-install
command that won't alter your host config, you can do:
```sh
./virt-install --connect test:///default --debug ...
```
`--connect test:///default` here is libvirt's built in unit test driver.
We use [glade-3](https://glade.gnome.org/) for building most of virt-manager's
UI. See the files in the ui/ directory.
## Submitting patches
The [virt-manager git repo](https://github.com/virt-manager/virt-manager)
is hosted on github. Small patches are acceptable via github pull-request,
but anything non-trivial should be sent to the
[virt-tools-list mailing list](https://www.redhat.com/mailman/listinfo/virt-tools-list).
Sending patches using `git send-email` is preferred, but `git format-patch`
output attached to an email is also fine.
## Introductory tasks
Extending the virt-install or virt-xml command line is a good introductory
task for virt-manager. See [the wiki](https://github.com/virt-manager/virt-manager/wiki)
for both a patch tutorial, and a list of libvirt `<domain>` XML options
that still need to be added to our command line.
## 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 at
[virt-manager at Zanata](https://fedora.zanata.org/project/view/virt-manager/).
## Advanced testing
There's a few standalone specialty tests:
```sh
./setup.py test_ui # dogtail UI test suite. This takes over your desktop
./setup.py test_urls # Test fetching media from live distro URLs
./setup.py test_initrd_inject # Test live virt-install --initrd-inject
```
All test 'test*' commands have a `--debug` option if you are hitting problems. For more options, see `./setup.py test --help`.
This diff is collapsed.
# 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:
```sh
./virt-manager
```
To install the software into `/usr/local` (usually), you can do:
```sh
./setup.py install
```
To build an RPM, you can run:
```sh
./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.4
- gtk3 >= 3.22
- libvirt-python >= 0.6.0
- pygobject3 >= 3.22
- libosinfo >= 0.2.10
- gtksourceview >= 3
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
`gir1.2-libosinfo-1.0`.
## Optional software
`virt-manager` can optionally use [libguestfs](http://libguestfs.org/)
for inspecting the guests. For this, `python-libguestfs` >= 1.22 is needed.
# to be included/excluded from the tarball produced by sdist
include COPYING CONTRIBUTING.md INSTALL.md NEWS.md README.md
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 virtconv *
recursive-include virtinst *
global-exclude *.pyc
This diff is collapsed.
Metadata-Version: 1.0
Name: virt-manager
Version: 2.2.1
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
`virt-manager` is a graphical tool for managing virtual machines
via [libvirt](https://libvirt.org). Most usage is with QEMU/KVM
virtual machines, but Xen and libvirt LXC containers are well
supported. Common operations for any libvirt driver should work.
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. If you just want to quickly test the
code from a git checkout, you can launch any of the commands like:
```sh
./virt-manager --debug ...
```
## Contact
- All comments / suggestions / patches should be directed to the
[virt-tools-list](https://www.redhat.com/mailman/listinfo/virt-tools-list)
mailing list.
- For IRC we use #virt on OFTC.
- For bug reporting info, see
[virt-manager bug reporting](https://virt-manager.org/bugs).
- There are further project details on the
[virt-manager](https://virt-manager.org/) website.
- See the [CONTRIBUTING.md](CONTRIBUTING.md) file for info about submitting patches or
contributing translations.
#!/bin/bash
# Run something, muting output or redirecting it to the debug stream
# depending on the value of _ARC_DEBUG.
__python_argcomplete_run() {
if [[ -z "$_ARC_DEBUG" ]]; then
"$@" 8>&1 9>&2 1>/dev/null 2>&1
else
"$@" 8>&1 9>&2 1>&9 2>&1
fi
}
_python_argcomplete() {
if [[ "$COMP_WORDBREAKS" != *,* ]]; then
COMP_WORDBREAKS="${COMP_WORDBREAKS},"
fi
local IFS=$'\013'
local SUPPRESS_SPACE=0
if compopt +o nospace 2> /dev/null; then
SUPPRESS_SPACE=1
fi
COMP_WORDS[4]=""
COMPREPLY=( $(IFS="$IFS" \
COMP_LINE="$COMP_LINE" \
COMP_POINT="$COMP_POINT" \
COMP_TYPE="$COMP_TYPE" \
_ARGCOMPLETE_COMP_WORDBREAKS="\"'><;|&(:" \
_ARGCOMPLETE=1 \
_ARGCOMPLETE_SUPPRESS_SPACE=$SUPPRESS_SPACE \
__python_argcomplete_run "$1") )
if [[ $? != 0 ]]; then
unset COMPREPLY
elif [[ $SUPPRESS_SPACE == 1 ]] && [[ "$COMPREPLY" =~ [=/:]$ ]]; then
compopt -o nospace
fi
}
complete -o nospace -o default -F _python_argcomplete ::SCRIPTNAME::
This diff is collapsed.
<?xml version="1.0" encoding="UTF-8"?>
<component type="desktop">
<id>virt-manager.desktop</id>
<metadata_license>CC0-1.0</metadata_license>
<project_license>GPL-2.0+</project_license>
<_name>Virtual Machine Manager</_name>
<_summary>Graphically manage KVM, Xen, or LXC via libvirt</_summary>
<description>
<_p>
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.
</_p>
</description>
<screenshots>
<screenshot type="default">
<image>https://virt-manager.org/appdata/en_US/manager.png</image>
<_caption>Main manager window</_caption>
</screenshot>
<screenshot>
<image>https://virt-manager.org/appdata/en_US/details.png</image>
<_caption>Virtual machine configuration screen</_caption>
</screenshot>
<screenshot>
<image>https://virt-manager.org/appdata/en_US/console.png</image>
<_caption>Graphical console connection for a virtual machine</_caption>
</screenshot>
</screenshots>
<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>
<url type="translate">https://fedora.zanata.org/project/view/virt-manager/</url>
<update_contact>virt-tools-list@redhat.com</update_contact>
<translation type="gettext">virt-manager</translation>
<keywords>
<keyword>virtualization</keyword>
<keyword>libvirt</keyword>
<keyword>qemu</keyword>
<keyword>kvm</keyword>
</keywords>
</component>
[Desktop Entry]
_Name=Virtual Machine Manager
_Comment=Manage virtual machines
Icon=virt-manager
Exec=virt-manager
Type=Application
Terminal=false
Categories=System;
[org.virt-manager.virt-manager.console]
auto-redirect=false
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/
Build-Depends:
debhelper (>= 12~),
dh-python,
intltool,
libglib2.0-bin,
python3-all,
# for the tests
cpio,
gir1.2-libosinfo-1.0,
gir1.2-libvirt-glib-1.0,
libvirt-daemon,
python3-gi,
python3-libvirt,
python3-libxml2,
python3-requests,
unzip,
Package: virt-manager
Architecture: all
Depends:
gir1.2-gtk-3.0 (>= 3.10),
gir1.2-gtk-vnc-2.0,
gir1.2-gtksource-4,
gir1.2-libosinfo-1.0,
gir1.2-libvirt-glib-1.0,
gir1.2-vte-2.91,
librsvg2-common,
python3-dbus,
python3-gi,
python3-gi-cairo,
python3-libvirt (>= 0.7.1),
virtinst (>= ${binary:Version}),
${misc:Depends},
${python3:Depends},
Recommends:
gir1.2-spiceclientglib-2.0,
gir1.2-spiceclientgtk-3.0,
libvirt-daemon-system (>= 1.2.7),
Suggests:
gir1.2-secret-1,
gnome-keyring,
python3-guestfs,
ssh-askpass,
virt-viewer,
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
Depends:
e2fsprogs,
genisoimage,
gir1.2-libosinfo-1.0,
python3,
python3-distutils,
python3-gi,
python3-libvirt (>= 0.4.6),
python3-libxml2,
python3-requests,
${misc:Depends},
${python3:Depends},
${shlibs:Depends},
Recommends:
qemu-utils,
virt-viewer,
Description: Programs to create and clone virtual machines
Virtinst is a set of commandline tools to create virtual machines using
libvirt:
.
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>