virt-convert(1)

1VIRT-CONVERT(1)             Virtual Machine Manager            VIRT-CONVERT(1)
2
3
4

NAME

6       virt-convert - convert ovf/vmx to native libvirt guests
7

SYNOPSIS

9       virt-convert INPUT.vmx|INPUT.ovf|INPUT-DIR|INPUT.zip [OPTIONS]
10

DESCRIPTION

12       virt-convert is a command line tool for converting VMX or OVF virtual
13       machines to native libvirt XML. Disk format conversion can also be done
14       at the same time.
15
16       The simplest invocation is simply: virt-convert INPUT. INPUT might be a
17       .vmx or .ovf file, a directory containing a .vmx or .ovf file (and
18       likely 1 or more disk images), or an appliance archive like .zip,
19       .tar.gz, or .ova. virt-convert will try to do the right thing in each
20       case.
21
22       By default, the virt-convert will convert all encountered disk images
23       to 'raw' format, sending the output to a new directory location. So the
24       original disk images are _not_ altered in place.
25

OPTIONS

27       --connect URI
28           Connect to a non-default hypervisor. See virt-install(1) for
29           details
30

CONVERSION OPTIONS

32       -i INPUT-FORMAT
33       --input-format INPUT-FORMAT
34           Input format. This should be auto-detected, but can be forced if
35           necessary. Currently "vmx" and "ovf" are supported.
36
37       -D OUTPUT-FORMAT
38       --disk-format OUTPUT-FORMAT
39           Output disk format. The default is 'raw', so any encountered disk
40           images will be converted to 'raw' format using qemu-img(1). Pass
41           "none" if no conversion should be performed: in this case the
42           images will just be copied to the specified --destination.
43
44       --destination DIRECTORY
45           The directory to send converted/copied disk images. If not
46           specified, the hypervisor default is used, typically
47           /var/lib/libvirt/images.
48

MISCELLANEOUS OPTIONS

50       --noautoconsole
51           Don't automatically try to connect to the guest console. The
52           default behaviour is to launch virt-viewer(1) to display the
53           graphical console, or to run the "virsh" "console" command to
54           display the text console. Use of this parameter will disable this
55           behaviour.
56
57       --print-xml
58           Print the generated libvirt XML, but do not perform any disk
59           conversions or install/start the guest. This option implies
60           --dry-run.
61
62       --dry-run
63           Proceed through the conversion process, but don't convert disks or
64           actually write any converted files.
65
66       -h
67       --help
68           Show the help message and exit
69
70       --version
71           Show program's version number and exit
72
73       -q
74       --quiet
75           Avoid verbose output.
76
77       -d
78       --debug
79           Print debugging information
80

EXAMPLES

82       Run a fedora18 OVA archive:
83
84         # virt-convert fedora18.ova
85
86       Run an extracted zip archive containing a centos6 .vmx and .vmdk file,
87       converting the images to qcow2 format
88
89         # virt-convert centos6/ --disk-format qcow2
90
91       Convert the specified .vmx file. Any references disk images must be in
92       the same directory. Don't change the disk format. Move the disk images
93       to /tmp
94
95         # virt-convert foo.vmx --disk-format none --destination /tmp
96

BUGS

98       Please see https://virt-manager.org/page/BugReporting
99

COPYRIGHT

101       Copyright (C) Red Hat, Inc, and various contributors.  This is free
102       software. You may redistribute copies of it under the terms of the GNU
103       General Public License "https://www.gnu.org/licenses/gpl.html".  There
104       is NO WARRANTY, to the extent permitted by law.
105