.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 2.4.0 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "virt-v2v-support 1"
.TH virt-v2v-support 1 2024-03-15 virt-v2v-2.4.0 "Virtualization Support"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
virt\-v2v\-support \- Supported hypervisors, virtualization management
systems and guests in virt\-v2v
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This page documents which foreign hypervisors, virtualization
management systems and guest types that \fBvirt\-v2v\fR\|(1) can support.
.PP
Note this page applies to upstream virt\-v2v from
http://libguestfs.org and in downstream distributions of virt\-v2v
sometimes features are intentionally removed, or are present but not
supported.
.SS "Hypervisors (Input)"
.IX Subsection "Hypervisors (Input)"
.IP "VMware ESXi" 4
.IX Item "VMware ESXi"
Must be managed by VMware vCenter ≥ 5.0 unless VDDK is available.
.IP "OVA exported from VMware" 4
.IX Item "OVA exported from VMware"
OVAs from other hypervisors will not work.
.IP "VMX from VMware" 4
.IX Item "VMX from VMware"
VMX files generated by other hypervisors will not work.
.IP "RHEL 5 Xen" 4
.IX Item "RHEL 5 Xen"
.PD 0
.IP "SUSE Xen" 4
.IX Item "SUSE Xen"
.IP "Citrix Xen" 4
.IX Item "Citrix Xen"
.PD
Citrix Xen has not been recently tested.
.IP Hyper-V 4
.IX Item "Hyper-V"
Not recently tested.  Requires that you export the disk or use
\&\fBvirt\-p2v\fR\|(1) on Hyper-V.
.IP "Direct from disk images" 4
.IX Item "Direct from disk images"
Only disk images exported from supported hypervisors, and using
container formats supported by qemu.
.IP "Physical machines" 4
.IX Item "Physical machines"
Using the \fBvirt\-p2v\fR\|(1) tool.
.SS "Hypervisors (Output)"
.IX Subsection "Hypervisors (Output)"
QEMU and KVM only.
.SS "Virtualization management systems (Output)"
.IX Subsection "Virtualization management systems (Output)"
.IP OpenStack 4
.IX Item "OpenStack"
.PD 0
.IP "Red Hat Virtualization (RHV) 4.1 and up" 4
.IX Item "Red Hat Virtualization (RHV) 4.1 and up"
.IP "Local libvirt" 4
.IX Item "Local libvirt"
.PD
And hence \fBvirsh\fR\|(1), \fBvirt\-manager\fR\|(1), and similar tools.
.IP "Local disk" 4
.IX Item "Local disk"
.SS Guests
.IX Subsection "Guests"
.PD 0
.IP "Red Hat Enterprise Linux 4, 5, 6, 7" 4
.IX Item "Red Hat Enterprise Linux 4, 5, 6, 7"
.IP "CentOS 4, 5, 6, 7" 4
.IX Item "CentOS 4, 5, 6, 7"
.IP "Scientific Linux 4, 5, 6, 7" 4
.IX Item "Scientific Linux 4, 5, 6, 7"
.IP "Oracle Linux" 4
.IX Item "Oracle Linux"
.IP Fedora 4
.IX Item "Fedora"
.IP "SLES 10 and up" 4
.IX Item "SLES 10 and up"
.IP "OpenSUSE 10 and up" 4
.IX Item "OpenSUSE 10 and up"
.IP "ALT Linux 9 and up" 4
.IX Item "ALT Linux 9 and up"
.IP "Debian 6 and up" 4
.IX Item "Debian 6 and up"
.IP "Ubuntu 10.04, 12.04, 14.04, 16.04, and up" 4
.IX Item "Ubuntu 10.04, 12.04, 14.04, 16.04, and up"
.IP "Windows XP to Windows 10 / Windows Server 2016" 4
.IX Item "Windows XP to Windows 10 / Windows Server 2016"
.PD
We use Windows internal version numbers, see
https://en.wikipedia.org/wiki/List_of_Microsoft_Windows_versions
.Sp
Currently NT 5.2 to NT 6.3 are supported.
.Sp
See "WINDOWS" below for additional notes on converting Windows
guests.
.SS "Guest firmware"
.IX Subsection "Guest firmware"
BIOS is supported for all guest types and hypervisors.
.PP
VMware allows you to present UEFI firmware to guests (instead of the
ordinary PC BIOS).  Virt\-v2v can convert these guests, but requires
that UEFI is supported by the target hypervisor.
.PP
Currently KVM supports OVMF, an open source UEFI firmware, and can run
these guests.
.PP
Since OVMF support was only recently added to KVM (in 2014/2015), not
all target environments support UEFI guests yet:
.IP "UEFI on libvirt, qemu" 4
.IX Item "UEFI on libvirt, qemu"
Supported.  Virt\-v2v will generate the correct libvirt XML (metadata)
automatically, but note that the same version of OVMF must be
installed on the conversion host as is installed on the target
hypervisor, else you will have to adjust paths in the metadata.
.IP "UEFI on OpenStack" 4
.IX Item "UEFI on OpenStack"
Supported since virt\-v2v ≥ 1.43.2.
.IP "UEFI on oVirt or RHV" 4
.IX Item "UEFI on oVirt or RHV"
Supported since oVirt/RHV ≥ 4.2 and virt\-v2v ≥ 1.39.12.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBvirt\-v2v\fR\|(1),
http://libguestfs.org.
.SH AUTHOR
.IX Header "AUTHOR"
Richard W.M. Jones
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2020 Red Hat Inc.
.SH LICENSE
.IX Header "LICENSE"
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
.PP
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.
.PP
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA.
.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
.PP
To report a new bug against libguestfs, use this link:
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
.IP \(bu 4
The version of libguestfs.
.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.