5
virt-convert - convert virtual machines between formats
9
B<virt-convert> [OPTION]... INPUT.VMX|INPUT-DIR [OUTPUT.XML|OUTPUT-DIR]
13
B<virt-convert> is a command line tool for converting virtual machines
14
from one format to another. Pass in either a VM definition file (such
15
as VMWare vmx format) or a directory containing a VM. By default, a new
16
VM definition file, and converted disk images, will be placed in a new
19
If an output directory is specified, it will be created if necessary,
20
and the output VM definition placed within, along with any disk images
23
If an output VM definition file is specified, it will be created
24
alongside any disks in the same directory.
28
Any of the options can be omitted, in which case B<virt-convert> will use defaults when required.
29
An input VM definition or containing directory must be provided. By
30
default, an output directory is generated based upon the name of the VM.
31
The default input format is VMWare vmx, and the default output format is
32
a libvirt "image" XML definition (see L<virt-image(5)>).
38
Show the help message and exit
40
=item -a ARCH, --arch=ARCH
42
Architecture of the virtual machine (i686, x86_64, ppc). Defaults to
43
that of the host machine.
45
=item -v, --hvm Create a fully virtualized guest image
47
Convert machine to a hvm/qemu based image (this is the default if paravirt is not specified)
49
=item -p, --paravirt Create a paravirtualized guest image
51
Convert machine to a paravirt xen based image
55
Input format. Currently, C<vmx> is the only supported input format.
59
Output format. Currently, C<virt-image> is the only supported output format.
63
Output disk format, or C<none> if no conversion should be performed. See
68
Print debugging information
74
=item --os-type=OS_TYPE
76
Optimize the guest configuration for a type of operating system. This will
77
attempt to pick the most suitable ACPI & APIC settings, optimally supported
78
mouse drivers and generally accommodate other operating system quirks. The
79
valid operating system types are
89
Microsoft Windows 9x or later
93
Traditional UNIX BSD or SysV derivatives
97
Operating systems not in one of the 3 prior groups
101
=item --os-variant=OS_VARIANT
103
Further optimize the guest configuration for a specific operating system
104
variant. This parameter is optional. The valid variants are
114
Red Hat Enterprise Linux 2.1
118
Red Hat Enterprise Linux 3
122
Red Hat Enterprise Linux 4
126
Red Hat Enterprise Linux 5
146
Suse Linux Enterprise Server 10.x
158
Generic Linux 2.6.x kernel
162
Generic Linux 2.4.x kernel
176
Microsoft Windows 2000
180
Microsoft Windows 2003
184
Microsoft Windows Vista
236
Override the OS type / variant to disables the APIC setting for fully
241
Override the OS type / variant to disables the ACPI setting for fully
248
Convert a paravirt guest from C<image.vmx>:
250
# virt-convert --arch=i686 --paravirt image.vmx
252
Convert a 64-bit hvm guest:
254
# virt-convert --arch=x86_64 vmx-appliance/ hvm-appliance/
258
Written by Joey Boggs and John Levon
260
See the AUTHORS file in the source distribution for the complete list of credits.
264
Report bugs to the mailing list C<http://www.redhat.com/mailman/listinfo/et-mgmt-tools>
265
or directly to BugZilla C<http://bugzilla.redhat.com/bugzilla/> against the
266
C<Fedora> product, and the C<python-virtinst> component.
270
Copyright (C) 2006-2008 Red Hat, Inc, and various contributors.
271
This is free software. You may redistribute copies of it under the terms of the GNU General
272
Public License C<http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent
277
L<virt-pack(1)>, L<virt-image(5)>, the project website
278
C<http://virt-manager.org>