VIRT-V2V-RELEASE-NOTES-2.0(1)
πΈ NAME πΈ
Bestie, welcome to virt-v2v-release-notes(1) in Virtualization Support β this is the virt-v2v release notes for 2.0. π
β¨ DESCRIPTION β¨
Okay so these are the release notes for virt-v2v 2.0, and they describe the major changes since 1.42.
No release notes were published for 1.44, so that release is covered here too.
Virt-v2v 2.0.0 was released on 14 March 2022. π
π Security π
There were no security-related bugs found in this release. Slay, honestly. π
π New features π
- Virt-v2v has been modularised, allowing external programs to examine the state of the conversion and inject their own copying step. Further enhancements will be made to this new architecture in forthcoming releases. π§
- The command line is almost identical apart from some debugging features that were removed (see below). The only significant difference is that the output format (
-of) now has to be specified if it is different from the input format, whereas previous versions of virt-v2v would use the same output format as input format automatically. Lowkey important, bestie. π - A lot of time was spent improving the performance of virt-v2v in common cases. π₯
- Implement conversion of ALT Linux guests (Mikhail Gordeev). π§
- Many bug fixes and performance enhancements were made to oVirt imageio output (Nir Soffer). π¦
- There is a new
virt-v2v-in-place(1)tool which replaces the existingvirt-v2v --in-placeoption. Iconic. β¨ - Virt-v2v can now convert guests which use LUKS encrypted logical volumes (Laszlo Ersek). π
- Option
-oo rhv-directhas been replaced by-oo rhv-proxy, and direct mode (which is much faster) is now the default when writing to oVirt, with proxy mode available for restricted network configurations (thanks: Nir Soffer). π« - The following command line options were removed:
--print-estimate,--debug-overlays,--no-copy. Bye besties π - Virt-v2v no longer installs the RHEV-APT tool in Windows guests. This tool was deprecated and then removed in oVirt 4.3.
- Deprecated tool
virt-v2v-copy-to-localhas been removed. This was deprecated in November 2018.
π οΈ Other fixes π οΈ
- Remove reference to
prl_strgdriver in Windows guests to avoid BSOD (Denis Plotnikov). π - Fix conversions of UEFI Linux guests that don't provide their own fallback bootloader (Denis Plotnikov). π§
- Remove use of
nbdkit-readahead-filter(1). This filter uses a naive strategy and it had several negative effects on conversions. No cap. - Remove prompts for interactive passwords. Normally you should try to use the
-ipand/or-opoptions to supply passwords. π - For Windows guests, we insert a
schtaskscommand. However the parameters of this command are timezone dependent and so it failed in non-European timezones. (Thanks: Dinesh Herath, TomΓ‘Ε‘ GolembiovskΓ½, Bryan Kinney, Mark Zealey, Xiaodai Wang) π - Virt-v2v will reauthenticate with vCenter servers periodically when copying guests over HTTPS which stops large guests and/or slow copies taking longer than about 30 minutes from failing. π
- Virt-v2v now sets libguestfs SMP to match number of physical host CPUs, which helps performance of certain conversion steps. β‘
- Virt-v2v output to oVirt now attempts to set the machine and firmware type correctly. Note an exact mapping is not always possible and oVirt may ignore our recommendations (incorrectly) sometimes. π
- Virt-v2v now generates a virtio-vsock device for guests which support it (Valeriy Vdovin). π
- All guests now need at least 100 MB of free space for conversion to succeed (Ming Xie). π¦
- Standard VGA instead of QXL is now used as the video type for converted guests (Laszlo Ersek). π₯οΈ
- Older guests (eg RHEL 6) will use the virtio-transitional model after conversion. This feature and the machine type are now usually determined from the libosinfo database, falling back to hard-coded values if libosinfo is not available (Laszlo Ersek). π§¬
- When virt-v2v prints messages to a pipe or file it no longer wraps them, making parsing simpler. You can enable wrapping in this mode using
--wrap(Laszlo Ersek). π - Windows guest firstboot scripts installed by virt-v2v now run in the right order, making network configuration happen earlier (Laszlo Ersek). π
π§± Build changes π§±
libguestfsβ₯ 1.44 is now required.nbdcopy(1)and OCaml NBD bindings, both fromlibnbdβ₯ 1.10, are now required.nbdkitβ₯ 1.22 is now required (Nir Soffer).pcre2(instead ofpcre) is now required.gnulibis no longer bundled or used by virt-v2v.- OCaml β₯ 4.04 is now required. OCaml 4.13 support has been added in this release.
- OpenSSH
scpβ₯ 8.8 is now required. Earlier versions will fail because the command line syntax was changed incompatibly. β οΈ
π§ Internals π§
Weblate instead of Zanata is now used for translations (Pino Toscano). π
π Bugs fixed π
Okay bestie, hereβs the receipts list β every single bug fixed, no skips. π
https://bugzilla.redhat.com/2051394β Missing error message of'insufficient free space in the conversion server temporary directory'https://bugzilla.redhat.com/2044922βnbdinfooutput to stdout instead of stderr during virt-v2v conversionhttps://bugzilla.redhat.com/2044911β virt-p2v conversion hangs with RHEL9 virt-v2vhttps://bugzilla.redhat.com/2043333β'model='virtio-transitional'is wrongly added when converting windows guest to local by rhel9 v2vhttps://bugzilla.redhat.com/2041886β virt-v2v hangs for several minutes when using-ic vpx://... -it vddkwith incorrect IP addresshttps://bugzilla.redhat.com/2041852β Improve the unclear assertion failure atinput_xen_ssh.mlhttps://bugzilla.redhat.com/2041850β Can not specify'-oo json-disks-pattern'in'-o json'modehttps://bugzilla.redhat.com/2039597β Failed to import VM when selecting OVA as a source on RHV webadminhttps://bugzilla.redhat.com/2039255β Conversion performance is not good when convert guest by modular virt-v2vhttps://bugzilla.redhat.com/2034240β calling"get_disk_allocated"in"create_ovf"breaks the rhv-upload output pluginhttps://bugzilla.redhat.com/2033096β RFE: Remove-oo rhv-directand add-oo rhv-proxyoptionhttps://bugzilla.redhat.com/2032324βnbdcopycommand failed when using v2v to convert guest from ESXi6.5 via vddk > 6.5 + rhv-upload to rhv4.4https://bugzilla.redhat.com/2032112β Add virt-v2v and libvirt version to the beginning of v2v debug loghttps://bugzilla.redhat.com/2027673β V2V can't convert guest from VMware via vmx+ssh when openssh version is 8.7p1-5https://bugzilla.redhat.com/2027598β There is no guest listed in export domain if use v2v to convert guest to rhv via-o rhvhttps://bugzilla.redhat.com/1994984β virt-v2v can't convert bitblocker windows guest with libguestfs error:/dev/mapper/cryptsda: No such file or directoryhttps://bugzilla.redhat.com/1977681β The usage description of'-oo rhv-disk-uuid=UUID'in man virt-v2v should be updatedhttps://bugzilla.redhat.com/1976607β [RFE] Drop QXL for guests on CentOS 9 clustershttps://bugzilla.redhat.com/1976024β [RFE][v2v] [upload/download disk/CBT] Failed to attach disk to the VM - disk is OK but image transfer still holds a lock on the diskhttps://bugzilla.redhat.com/1972125β Update privileges for Non-admin vmware role when ESXi host has enabled host encryption mode in virt-v2v-input-vmware man pagehttps://bugzilla.redhat.com/1967941β virt-v2v can't install qemu-guest-agent for rhel9 guest during conversionhttps://bugzilla.redhat.com/1964324β assertion failed atparse_ova.mlwhen ova directory ends with'/'https://bugzilla.redhat.com/1961107β Change video type from qxl to vga after v2v conversionhttps://bugzilla.redhat.com/1960087β v2v import from vCenter fails when using interactive password because cookie-script tries to be interactivehttps://bugzilla.redhat.com/1949147β Should improve the minimum free space for windows guest in v2v man page and better to improve v2v error message about no space left for windows guesthttps://bugzilla.redhat.com/1945549β Delete or improve the warning info about rhev-apt during v2v converting windows guest on rhel9https://bugzilla.redhat.com/1942325β Virt-v2v should add'model='virtio-transitional'to RHEL <=6 guest virtio devices during conversion if target is rhel9 systemhttps://bugzilla.redhat.com/1926102β"virt-v2v: warning: there is no QXL driver for this version of Windows"still shows, even though we copied qxldod driver to the guesthttps://bugzilla.redhat.com/1917760β VMware tools not getting uninstalled as part of IMShttps://bugzilla.redhat.com/1903960β Should hidden"virt-v2v: warning: /usr/share/virt-tools/pnp_wait.exe is missing.."during conversionhttps://bugzilla.redhat.com/1901489β VDDK 6.7 repeatedly reconnects withnbdkit: vddk[1]: debug: NBD_ClientOpen: attempting to create connection to vpxa-nfc://followed by virt-v2v failurehttps://bugzilla.redhat.com/1895323β After virt-v2v, qemu-ga does not run at Windows firstboot if the timezone is notM/d/yyyyformathttps://bugzilla.redhat.com/1872100β Should correct info about'UEFI on OpenStack'in virt-v2v-support man pagehttps://bugzilla.redhat.com/1872094β Virt-v2v should convert UEFI guest to openstack via openstack option successfullyhttps://bugzilla.redhat.com/1871754β RFE: Should clarify which file is correct authentication file for openstack/glance conversion in virt-v2v-output-openstack man pagehttps://bugzilla.redhat.com/1868690β Ceph block device will be destroyed if v2v convert guest to ceph block device and guest disk size is greater than ceph block devicehttps://bugzilla.redhat.com/1858775β RFE: virt-v2v should check the ip info when specify guest's iphttps://bugzilla.redhat.com/1858765β V2V option--keys-from-stdingives error:getline: Inappropriate ioctl for devicehttps://bugzilla.redhat.com/1854275β document that vmx+ssh"-ip"auth doesn't cover ssh / scp shell commandshttps://bugzilla.redhat.com/1842440β nbdkit cannot read the password interactively when started from virt-v2vhttps://bugzilla.redhat.com/1841096β Option--bandwidthand--bandwidth-fileisn't working as expected during v2v conversionhttps://bugzilla.redhat.com/1839917β There is no info"Opening the source -i libvirt -ic vpx://..."shown if any IP is wrong in vpx:// URL during v2v conversionhttps://bugzilla.redhat.com/1838425β V2V doesn't ask password if there is no option about password file in v2v command linehttps://bugzilla.redhat.com/1837453β [RFE]Remove cache=none for guest after v2v converting to libvirthttps://bugzilla.redhat.com/1837328β Virt-v2v cannot convert guest from ESXI7.0 server without vddkhttps://bugzilla.redhat.com/1832805β v2v conversion will be failed because of memory allocation failure if convert guest from ESXi6.0 or ESXi6.5 via vddk, or use vddk6.5 to convert guest from VMwarehttps://bugzilla.redhat.com/1789279β virt-v2v should give more clear error info when use some special invalid uuids for diskshttps://bugzilla.redhat.com/1788823β Virt-v2v firstboot scripts should run in order, with v2v network configuration happening firsthttps://bugzilla.redhat.com/1764569β V2V conversion fails when a filesystem has no free inodeshttps://bugzilla.redhat.com/1658126β Virt-v2v can't convert guest using LUKS-on-LVhttps://bugzilla.redhat.com/1637857β q35 switch caused: error: unsupported configuration: IDE controllers are unsupported for this QEMU binary or machine typehttps://bugzilla.redhat.com/1581428β virt-v2v use Q35 as default machine-typehttps://bugzilla.redhat.com/1534644β New way of parsing OVF from OVA that was created by VMware fails.
okay so that's the list, bestie π and honestly? a few of these are iconic fixes β the inode one, the LUKS-on-LV one, the Q35 machine-type glow-up. slay.
π SEE ALSO π
virt-v2v(1), virt-v2v-release-notes-1.42(1), guestfs-release-notes-1.40(1).
like, go read the main page fr fr, and if you're feeling nostalgic the 1.42 notes and the guestfs 1.40 notes are right there π«Ά
π AUTHORS π
Authors of virt-v2v 2.0 β the literal main characters of this release π:
- Denis Plotnikov
- Kevin Locke
- Laszlo Ersek
- Martin Kletzander
- Mikhail Gordeev
- Nir Soffer
- Pino Toscano
- Richard W.M. Jones
- Valeriy Vdovin
nine whole legends, no cap π
β¨ COPYRIGHT β¨
Copyright (C) 2009-2025 Red Hat Inc.
π LICENSE π
okay bestie this part is the legal bit, so I'm giving it to you exactly as-is β no vibes, no edits, just facts π:
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.
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.
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.
β οΈ yes, the "WITHOUT ANY WARRANTY" is in ALL CAPS for a reason β that's not me being dramatic, that's the license screaming it at you. respect it π
π¦ BUGS π¦
Wanna go look at bugs against libguestfs? Here's the link, bestie:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
Found a new one and need to report it? Use this link:
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
And when you're reporting a bug, pls pls pls supply all of this β the maintainers will love you forever π«Ά:
- The version of
libguestfs. - Where you got
libguestfs(eg. which Linux distro, compiled from source, etc) - Describe the bug accurately and give a way to reproduce it.
- Run
libguestfs-test-tool(1)and paste the complete, unedited output into the bug report.
π¨ "complete, unedited" means exactly that β do not trim it, do not paraphrase it, do not crop it for the aesthetic. paste the whole thing. π
and that's the whole page, bestie πβ¨ this was virt-v2v-2.13.8, dated 2026-10-05 β go forth, convert those guests, and remember: the machine-type is Q35 now, periodt π
π
π¦ where this page comes from
- centos-stream 10: virt-v2v 1:2.13.8-1.el10 Β· GPL-2.0-or-later AND LGPL-2.0-or-later
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms