virt-convert(1)

1VIRT-CONVERT(1)          Virtual Machine Install Tools         VIRT-CONVERT(1)
2
3
4

NAME

6       virt-convert - convert virtual machines between formats
7

SYNOPSIS

9       virt-convert [OPTION]... INPUT.VMX|INPUT-DIR [OUTPUT.XML|OUTPUT-DIR]
10

DESCRIPTION

12       virt-convert is a command line tool for converting virtual machines
13       from one format to another. Pass in either a VM definition file (such
14       as VMWare vmx format) or a directory containing a VM. By default, a new
15       VM definition file, and converted disk images, will be placed in a new
16       output directory.
17
18       If an output directory is specified, it will be created if necessary,
19       and the output VM definition placed within, along with any disk images
20       as needed.
21
22       If an output VM definition file is specified, it will be created
23       alongside any disks in the same directory.
24

OPTIONS

26       Any of the options can be omitted, in which case virt-convert will use
27       defaults when required. An input VM definition or containing directory
28       must be provided. By default, an output directory is generated based
29       upon the name of the VM. The default input format is VMWare vmx, and
30       the default output format is a libvirt "image" XML definition (see
31       virt-image(5)).
32
33       -h, --help
34           Show the help message and exit
35
36   Conversion Options
37       -i format
38         Input format. Currently, "vmx", "virt-image", and "ovf" are
39         supported.
40
41       -o format
42         Output format. Currently, "vmx"  and "virt-image" are supported.
43
44       -D format
45         Output disk format, or "none" if no conversion should be performed.
46         See qemu-img(1).
47
48   Virtualization Type options
49       Options to override the default virtualization type choices.
50
51       -v, --hvm      Create  a fully virtualized guest image
52         Convert machine to a hvm/qemu based image (this is the default if
53         paravirt is not specified)
54
55       -p, --paravirt      Create  a paravirtualized guest image
56         Convert machine to a paravirt xen based image
57
58   General Options
59       General configuration parameters that apply to all types of guest
60       installs.
61
62       -a ARCH, --arch=ARCH
63         Architecture of the virtual machine (i686, x86_64, ppc). Defaults to
64         that of the host machine.
65
66       --os-type=OS_TYPE
67         Optimize the guest configuration for a type of operating system (ex.
68         'linux', 'windows'). This will attempt to pick the most suitable ACPI
69         & APIC settings, optimally supported mouse drivers, virtio, and
70         generally accommodate other operating system quirks.  See
71         virt-install(1) for valid values.
72
73       --os-variant=OS_VARIANT
74         Further optimize the guest configuration for a specific operating
75         system variant (ex. 'fedora8', 'winxp'). This parameter is optional,
76         and does not require an "--os-type" to be specified. See
77         virt-install(1) for valid values.
78
79       --noapic
80         Override the OS type / variant to disables the APIC setting for fully
81         virtualized guest.
82
83       --noacpi
84         Override the OS type / variant to disables the ACPI setting for fully
85         virtualized guest.
86
87   Miscellaneous Options
88       -q, --quiet
89         Avoid verbose output.
90
91       -d, --debug
92         Print debugging information
93
94       --dry-run
95         Proceed through the conversion process, but don't convert disks or
96         actually write any converted files.
97

EXAMPLES

99       Convert a paravirt guest from "image.vmx":
100
101         # virt-convert --arch=i686 --paravirt image.vmx
102
103       Convert a 64-bit hvm guest:
104
105         # virt-convert --arch=x86_64 vmx-appliance/ hvm-appliance/
106

AUTHOR

108       Written by Joey Boggs and John Levon
109
110       See the AUTHORS file in the source distribution for the complete list
111       of credits.
112

BUGS

114       Please see http://virt-manager.org/page/BugReporting
115

COPYRIGHT

117       Copyright (C) 2006-2008 Red Hat, Inc, and various contributors.  This
118       is free software. You may redistribute copies of it under the terms of
119       the GNU General Public License "http://www.gnu.org/licenses/gpl.html".
120       There is NO WARRANTY, to the extent permitted by law.
121