VIRT-CONVERTSection: Virtual Machine Install Tools (1)
Index Return to Main Contents
NAMEvirt-convert - convert virtual machines between formats
SYNOPSISvirt-convert [OPTION]... INPUT.VMX|INPUT-DIR [OUTPUT.XML|OUTPUT-DIR]
DESCRIPTIONvirt-convert is a command line tool for converting virtual machines from one format to another. Pass in either a VM definition file (such as VMWare vmx format) or a directory containing a VM. By default, a new VM definition file, and converted disk images, will be placed in a new output directory.
If an output directory is specified, it will be created if necessary, and the output VM definition placed within, along with any disk images as needed.
OPTIONSAny of the options can be omitted, in which case virt-convert will use defaults when required. An input VM definition or containing directory must be provided. By default, an output directory is generated based upon the name of the VM. The default input format is VMWare vmx, and the default output format is a libvirt ``image'' XML definition (see virt-image(5)).
- -i format
- Input format. Currently, "vmx", "virt-image", and "ovf" are supported.
- -o format
- Output format. Currently, "vmx" and "virt-image" are supported.
- -D format
- Output disk format, or "none" if no conversion should be performed. See qemu-img(1).
Virtualization Type optionsOptions to override the default virtualization type choices.
- -v, --hvm Create a fully virtualized guest image
- Convert machine to a hvm/qemu based image (this is the default if paravirt is not specified)
- -p, --paravirt Create a paravirtualized guest image
- Convert machine to a paravirt xen based image
General OptionsGeneral configuration parameters that apply to all types of guest installs.
- -a ARCH, --arch=ARCH
- Architecture of the virtual machine (i686, x86_64, ppc). Defaults to that of the host machine.
- 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 virt-install(1) for valid values.
- Further optimize the guest configuration for a specific operating system variant (ex. 'fedora8', 'winxp'). This parameter is optional, and does not require an "--os-type" to be specified. See virt-install(1) for valid values.
- Override the OS type / variant to disables the APIC setting for fully virtualized guest.
- Override the OS type / variant to disables the ACPI setting for fully virtualized guest.
- -q, --quiet
- Avoid verbose output.
- -d, --debug
- Print debugging information
- Proceed through the conversion process, but don't convert disks or actually write any converted files.
EXAMPLESConvert a paravirt guest from "image.vmx":
# virt-convert --arch=i686 --paravirt image.vmx
Convert a 64-bit hvm guest:
# virt-convert --arch=x86_64 vmx-appliance/ hvm-appliance/
AUTHORWritten by Joey Boggs and John Levon
BUGSPlease see http://virt-manager.org/page/BugReporting
COPYRIGHTCopyright (C) 2006-2008 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 "http://www.gnu.org/licenses/gpl.html". There is NO WARRANTY, to the extent permitted by law.
SEE ALSOvirt-image(5), the project website "http://virt-manager.org"
- SEE ALSO
This document was created by man2html, using the manual pages.
Time: 05:29:12 GMT, December 24, 2015