Commit 4fa03ba6 authored by Guido Günther's avatar Guido Günther

New upstream version 0.10.0~git20130205.69015c

parent f1d7e9f3
......@@ -25,12 +25,17 @@ to see a code coverage report.
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
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:
python setup.py test_urls : Test fetching media from distro URLs
python setup.py test_initrd_inject: Test --initrd-inject
Submitting patches
==================
......
......@@ -30,7 +30,7 @@ Release 0.9.3 (July 09, 2012)
Release 0.9.2 (July 09, 2012)
-----------------------------
- Convert to gtkbuilder: UI can now be editted with modern glade tool
- Convert to gtkbuilder: UI can now be edited with modern glade tool
- virt-manager no longer runs on RHEL5, but can manage a remote RHEL5
host
- Option to configure spapr net and disk devices for pseries (Li Zhang)
......
No preview for this file type
......@@ -19,6 +19,12 @@
<summary>Username and secrets ID for graphical password</summary>
<description>Username and secrets ID for graphical password</description>
</key>
<key name="resize-guest" type="i">
<default>-1</default>
<summary>Automatically resize guest when window size changes</summary>
<description>Automatically change guest resolution along with virt-manager window. Only works with spice with a vdagent set up. -1 = global default, 0 = off, 1 = on.</description>
</key>
</schema>
<schema id="org.virt-manager.virt-manager"
......@@ -94,6 +100,12 @@
<description>Show the host cpu usage field in the domain list summary view</description>
</key>
<key name="memory-usage" type="b">
<default>false</default>
<summary>Show memory usage in summary</summary>
<description>Show memory usage field in the domain list summary view</description>
</key>
</schema>
<schema id="org.virt-manager.virt-manager.stats" path="/org/virt-manager/virt-manager/stats/">
......@@ -115,6 +127,11 @@
<summary>Poll net i/o stats</summary>
<description>Whether or not the app will poll VM network i/o statistics</description>
</key>
<key name="enable-memory-poll" type="b">
<default>true</default>
<summary>Poll memory stats</summary>
<description>Whether or not the app will poll VM memory statistics</description>
</key>
</schema>
......@@ -155,11 +172,23 @@
<description>When to scale the VM graphical console. 0 = never, 1 = only when in full screen mode, 2 = Always</description>
</key>
<key name="resize-guest" type="i">
<default>-1</default>
<summary>Automatically resize guest when window size changes</summary>
<description>Automatically change guest resolution along with virt-manager window. Only works with spice with a vdagent set up. -1 = global default, 0 = off, 1 = on.</description>
</key>
<key name="grab-keys" type="s">
<default>''</default>
<summary>Grab keyboard sequence for the graphical console</summary>
<description>Grab keyboard sequence for the graphical console</description>
</key>
<key name="auto-redirect" type="b">
<default>true</default>
<summary>Enable SPICE Auto USB redirection in console window</summary>
<description>Whether to enable SPICE Auto USB redirection while connected to the guest console.</description>
</key>
</schema>
<schema id="org.virt-manager.virt-manager.details"
......@@ -185,11 +214,24 @@
<description>Install selected graphics type for new VM. vnc or spice, system for software configured default</description>
</key>
<key name="add-spice-usbredir" type="s">
<default>'system'</default>
<summary>Add spice usbredir HW for new VMs</summary>
<description>Add spice usbredir HW for new VMs. yes, no, or system for software configured default</description>
</key>
<key name="storage-format" type="s">
<default>'default'</default>
<summary>Use selected format for new VM storage</summary>
<description>Use selected format when creating new disk images in new VM wizard</description>
</key>
<key name="cpu-default" type="s">
<default>'default'</default>
<summary>CPU setting to use for new VMs</summary>
<description>CPU setting to use for new VMs. Limited to VMs matching the host architecture. Possible values: default (virt-manager default), hv-default (qemu's default), host-cpu-model (just the model, not the additional features), host-model (libvirt's host-model setting).</description>
</key>
</schema>
<schema id="org.virt-manager.virt-manager.paths"
......
<?xml version="1.0" encoding="UTF-8"?>
<!-- Copyright 2013 Cole Robinson -->
<application>
<id type="desktop">virt-manager.desktop</id>
<licence>CC0</licence>
<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">http://virt-manager.org/appdata/en_US/manager.png</screenshot>
<screenshot>http://virt-manager.org/appdata/en_US/details.png</screenshot>
<screenshot>http://virt-manager.org/appdata/en_US/console.png</screenshot>
</screenshots>
<url type="homepage">http://www.virt-manager.org/</url>
<updatecontact>virt-tools-list@redhat.com</updatecontact>
</application>
......@@ -18,9 +18,9 @@ uniqueness will be updated to avoid a clash between old and new guests.
By default, virt-clone will show an error if the necessary information to
clone the guest is not provided. The --auto-clone option will generate
all needed input, aside from the source guest to clone. An interactive mode
is available with the --prompt option, but this will only ask for the
minimum required options.
all needed input, aside from the source guest to clone.
Please note, virt-clone does not change anything _inside_ the guest OS, it only duplicates disks and does host side changes. So things like changing passwords, changing static IP address, etc are outside the scope of this tool. For these types of changes, please see B<virt-sysprep>.
=head1 OPTIONS
......@@ -34,6 +34,10 @@ storage options via -file.
Show the help message and exit
=item --version
Show program's version number and exit
=item --connect=URI
Connect to a non-default hypervisor. See L<virt-install(1)> for details
......@@ -146,18 +150,8 @@ cloning the original guest.
=item -d, --debug
Print debugging information to the terminal when running the install process.
The debugging information is also stored in C<$HOME/.virtinst/virt-clone.log>
even if this parameter is omitted.
=item --force
Prevent interactive prompts. If the intended prompt was a yes/no prompt, always
say yes. For any other prompts, the application will exit.
=item --prompt
Specifically enable prompting for required information. Default prompting
is off.
The debugging information is also stored in
C<~/.cache/virt-manager/virt-clone.log> even if this parameter is omitted.
=back
......@@ -197,25 +191,21 @@ new guest can do a filesystem resize when it boots.
--file /dev/HostVG/DemoVM \
--mac 52:54:00:34:11:54
=head1 AUTHOR
Written by Kazuki Mizushima, Cole Robinson, and a team of many other
contributors.
=head1 BUGS
Please see http://virt-manager.org/page/BugReporting
=head1 COPYRIGHT
Copyright (C) Fujitsu Limited, and various contributors.
Copyright (C) Fujitsu Limited, Copyright (C) Red Hat, Inc,
and various contributors.
This is free software. You may redistribute copies of it under the terms
of the GNU General Public License C<http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.
=head1 SEE ALSO
C<virsh(1)>, C<virt-install(1)>, C<virt-manager(1)>, the project website C<http://virt-manager.org>
C<virt-sysprep(1)>, C<virsh(1)>, C<virt-install(1)>, C<virt-manager(1)>, the project website C<http://virt-manager.org>
=cut
......@@ -38,6 +38,10 @@ default output format is a libvirt "image" XML definition
Show the help message and exit
=item --version
Show program's version number and exit
=back
=head2 Conversion Options
......@@ -87,29 +91,13 @@ General configuration parameters that apply to all types of guest installs.
Architecture of the virtual machine (i686, x86_64, ppc). Defaults to
that of the host machine.
=item --os-type=OS_TYPE
Optimize the guest configuration for a type of operating system (ex. 'linux',
'windows'). This will attempt to pick the most suitable ACPI & APIC settings,
optimally supported mouse drivers, virtio, and generally accommodate other
operating system quirks. See L<virt-install(1)> for valid values.
=item --os-variant=OS_VARIANT
Further optimize the guest configuration for a specific operating system
variant (ex. 'fedora8', 'winxp'). This parameter is optional, and does not
require an C<--os-type> to be specified. See L<virt-install(1)> for valid
values.
=item --noapic
Override the OS type / variant to disables the APIC setting for fully
virtualized guest.
=item --noacpi
Override the OS type / variant to disables the ACPI setting for fully
virtualized guest.
Optimize the guest configuration for a specific operating system (ex.
'fedora18', 'rhel7', 'winxp'). While not requires, specifying this
options is HIGHLY RECOMMENDED, as it can greatly increase performance
by specifying virtio among other guest tweaks.
See L<virt-install(1)> for valid values.
=back
......@@ -142,17 +130,13 @@ Convert a 64-bit hvm guest:
# virt-convert --arch=x86_64 vmx-appliance/ hvm-appliance/
=head1 AUTHOR
Written by Joey Boggs, John Levon, and Cole Robinson.
=head1 BUGS
Please see http://virt-manager.org/page/BugReporting
=head1 COPYRIGHT
Copyright (C) 2006-2012 Red Hat, Inc, and various contributors.
Copyright (C) Red Hat, Inc, and various contributors.
This is free software. You may redistribute copies of it under the terms
of the GNU General Public License C<http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.
......
......@@ -110,9 +110,7 @@ or C<ppc>.
The I<features> element indicates whether certain platform features should
be on or off. Currently, the platform features are I<pae>, I<acpi>, and
I<apic>. They can be turned on or off by giving a I<state> attribute of
either C<on> or C<off>. When a feature is mentioned in the I<features>
element, it defaults to C<on>.
I<apic>. Omitting a togglable feature tag turns it off.
=item The details of booting the image's operating system
......@@ -222,17 +220,13 @@ To create a virtual machine, save the above XML in F<image.xml> and run:
# virt-image --vnc image.xml
=head1 AUTHOR
Written by David Lutterkort.
=head1 BUGS
Please see C<http://virt-manager.org/page/BugReporting>
=head1 COPYRIGHT
Copyright (C) 2006-2012 Red Hat, Inc, and various contributors.
Copyright (C) Red Hat, Inc, and various contributors.
This is free software. You may redistribute copies of it under the terms
of the GNU General Public License C<http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.
......
......@@ -34,6 +34,10 @@ line option.
Show the help message and exit
=item --version
Show program's version number and exit
=item --connect=URI
Connect to a non-default hypervisor. See L<virt-install(1)> for details
......@@ -52,15 +56,11 @@ General configuration parameters that apply to all types of guest installs.
Name of the guest instance
=item -r MEMORY, --ram=MEMORY
Memory to allocate for guest instance in megabytes. Defaults to
C</image/devices/memory> in the XML descriptor.
=item --memory=MEMORY
=item -u UUID, --uuid=UUID
Memory to allocate for the guest, in megabytes. Defaults to C</image/devices/memory> in the XML descriptor. This deprecates the -r/--ram option.
UUID for the guest; if none is given a random UUID will be generated. If
you specify UUID, you should use a 32-digit hexadecimal number.
See L<virt-install(1)> for more details.
=item --vcpus=VCPUS
......@@ -68,51 +68,18 @@ Number of vcpus to configure for your guest. Defaults to
C</image/devices/vcpu> in the XML descriptor. This option can also be
used to set CPU topology, please see L<virt-install(1)> for more info.
=item --cpuset
Set which physical cpus the guest can use. Please see L<virt-install(1)> for
more info.
=item --cpu
Configure the CPU and CPU features exposed to the guest. Please see
L<virt-install(1)> for more info.
=item --check-cpu
Check that vcpus do not exceed physical CPUs and warn if they do.
=item --os-type=OS_TYPE
Optimize the guest configuration for a type of operating system (ex. 'linux',
'windows'). This will attempt to pick the most suitable ACPI & APIC settings,
optimally supported mouse drivers, virtio, and generally accommodate other
operating system quirks. See L<virt-install(1)> for valid values.
=item --os-variant=OS_VARIANT
Further optimize the guest configuration for a specific operating system
variant (ex. 'fedora8', 'winxp'). This parameter is optional, and does not
require an C<--os-type> to be specified. See L<virt-install(1)> for valid
values.
=back
=head2 Full Virtualization specific options
Parameters specific only to fully virtualized guest installs.
=over 2
=item --noapic
Force disable APIC for the guest.
=item --noacpi
Force disable ACPI for the guest.
Optimize the guest configuration for a specific operating system (ex.
'fedora18', 'rhel7', 'winxp'). While not requires, specifying this
options is HIGHLY RECOMMENDED, as it can greatly increase performance
by specifying virtio among other guest tweaks.
See L<virt-install(1)> for valid values.
=back
......@@ -125,15 +92,7 @@ Force disable ACPI for the guest.
=item -w NETWORK, --network=NETWORK
Connect the guest to the host network. See L<virt-install(1)> for details
=item -m MAC, --mac=MAC
This is deprecated in favor of C<--network ...,mac=MAC,...>
=item -b BRIDGE, --bridge=BRIDGE
This is deprecated in favor of C<--network bridge=BRIDGE>
Connect the guest to the host network. This deprecates the -m/--mac and -b/--bridge options. See L<virt-install(1)> for details.
=back
......@@ -153,37 +112,18 @@ Specifies the graphical display configuration. This does not configure any
virtual hardware, just how the guest's graphical display can be accessed.
See L<virt-install(1)> for details usage info.
=item --vnc
This option is deprecated in favor of C<--graphics vnc,...>
=item --vncport=VNCPORT
This option is deprecated in favor of C<--graphics vnc,port=PORT,...>
This deprecates the following options: --vnc, --vncport, --vnclisten, -k/--keymap, --sdl, --nographics
=item --vnclisten=VNCLISTEN
This option is deprecated in favor of C<--graphics vnc,listen=LISTEN,...>
=item -k KEYMAP, --keymap=KEYMAP
This option is deprecated in favor of C<--graphics vnc,keymap=KEYMAP,...>
=item --sdl
This option is deprecated in favor of C<--graphics sdl,...>
=back
=item --nographics
This option is deprecated in favor of C<--graphics none>
=back
=head2 Miscellaneous Options
=over 2
=item -p, --print
=item --print-xml
Print the libvirt XML, but do not start the guest.
......@@ -226,17 +166,13 @@ do not create or start a virtual machine:
# virt-image --print --name example --nographics image.xml
=head1 AUTHOR
Written by David Lutterkort and Cole Robinson.
=head1 BUGS
Please see http://virt-manager.org/page/BugReporting
=head1 COPYRIGHT
Copyright (C) 2006-2012 Red Hat, Inc, and various contributors.
Copyright (C) Red Hat, Inc, and various contributors.
This is free software. You may redistribute copies of it under the terms
of the GNU General Public License C<http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.
......
This diff is collapsed.
......@@ -22,59 +22,74 @@ The following options are accepted when running C<virt-manager>:
=over 4
=item -h, -help
=item -h, --help
Display command line help summary
=item --version
Show virt-manager's version number and exit
=item -c URI, --connect=URI
Specify the hypervisor connection URI
Specify the hypervisor connection C<URI>
=item --debug
List debugging output to the console (normally this is only logged in
~/.virt-manager/virt-manager.log). This function implies --no-fork.
~/.cache/virt-manager/virt-manager.log). This function implies --no-fork.
=item --no-fork
Don't fork C<virt-manager> off into the backround: run it blocking the
Don't fork C<virt-manager> off into the background: run it blocking the
current terminal. Useful for seeing possible errors dumped to stdout/stderr.
=item --no-conn-autostart
Don't autostart any libvirt connections when launching C<virt-manager>.
=item --show-DIALOG-WINDOW
Display the corresponding C<DIALOG-WINDOW> when launching C<virt-manager>. This
function implies --no-conn-autostart and the manager window will not be shown
at startup in this case.
The following C<DIALOG-WINDOW> options are currently available:
=over 4
=item --show-domain-creator
Display the wizard for creating new virtual machines
=item --show-domain-editor=UUID
=item --show-domain-editor=NAME|ID|UUID
Display the dialog for editing properties of the virtual machine with
unique ID matching C<UUID>
unique ID matching either the domain name, ID, or UUID
=item --show-domain-performance=UUID
=item --show-domain-performance=NAME|ID|UUID
Display the dialog for monitoring performance of the virtual machine with
unique ID matching C<UUID>
unique ID matching either the domain name, ID, or UUID
=item --show-domain-console=UUID
=item --show-domain-console=NAME|ID|UUID
Display the virtual console of the virtual machine with
unique ID matching C<UUID>