virt-v2v-release-notes-2.12 - Man Page
virt-v2v release notes for 2.12
Description
These are the release notes for virt-v2v 2.12. This describes the major changes since 2.10.
Virt-v2v 2.12.0 was released on 10 July 2026.
New features
Enable conversions of Debian 12 guests that use UEFI (Martin Necas).
Enable conversions of SLES 12 SP5 and Ubuntu 24.04 that use LUKS encrypted filesystems (Cole Robinson).
Enable conversions of Kylin, NeoKylin and Anolis Linux distributions (grass lu).
Add new --no-fstrim option to disable fstrim during conversion (sarika at Platform 9).
New --collect option which can be used to collect pre-conversion information such as the Windows Registry and event log for later diagnosis (thanks Vadim Rozenfeld).
The -i disk input method now allows nbd://... URIs to be used instead of local disks. This allows more flexible conversions such as converting from xz-compressed images.
virt-v2v-inspector(1) now includes information about XFSv4 and XFSv5 filesystems.
virt-v2v-in-place(1) and virt-v2v-inspector XML output now contains suggested disk boot order information (thanks Elad Hazan).
Other fixes
Fix detection of remote files when using -it ssh mode (Ming Xie).
When injecting virtio-win drivers in Windows guests, install blnsvr.exe (the balloon server) (Cole Robinson).
Fix installation of Windows Vista and Windows 2008 Server R1 drivers (Cole Robinson).
Stop using xfs_repair -m option (thanks Ming Xie, Eric Sandeen, Dave Chinner).
Ignore AGFL inconsistencies in XFS filesystems on RHEL 7 guests (thanks Brian Foster, Eric Sandeen).
Retry Windows qemu-guest-agent installer several times to work around temporary installation bugs (thanks Martin Necas, Cole Robinson).
Virt-v2v --key parameter now allows binary keys.
Virt-v2v --firstboot scripts on Windows may now exit with code 250 to avoid rebooting after the script (Srihari Parimi).
Immutable /etc/resolv.conf no longer prevents conversion (Srihari Parimi).
Obey cgroup v2 CPU limits (Susant Sahani).
Fix output filenames if guest name contains / character (Susant Sahani).
Documentation
Document how to recover the key used by Windows guests that stored the Bitlocker disk encryption key in the VMware vTPM (Ming Xie).
Document pre-conversion steps required for certain guests encrypted with LUKS using vTPM (Ming Xie, Susant Sahani).
Fix conversion from VMware vCenter where the VMware datastore name contains some special characters (Cole Robinson).
Document that the PowerShell execution policy AllSigned will not work (thanks Martin Mecas, Ulhas Surse).
Build changes
Fix Weblate (i18n) web hooks (Rafael Fontenelle).
Fix and enhance github CI checks (Cole Robinson).
Remove AM_GNU_GETTEXT macro and replace it with simpler LIBINTL checks (Cole Robinson).
Various build warnings were cleaned up (Cole Robinson).
Fix warnings in configure script related to the order that various autoconf macros appear (Olaf Hering).
Internals
Many memory leaks identified by Claude Code were fixed (shivanayak).
Improve debug output (Srihari Parimi).
Bugs fixed
- https://issues.redhat.com/browse/MTV-4424
[MTV] Migration of windows 2019 VM fails to install qemu-ga and set static IP if ExecutionPolicy is set in souce VM.
- https://issues.redhat.com/browse/RHEL-85154
ubuntu guest with encrypted disk and TPM fails boot into OS after v2v conversion
- https://issues.redhat.com/browse/RHEL-93583
sles12sp5 guest with encrypted brtfs fliesystem fails to boot into OS after v2v conversion
- https://issues.redhat.com/browse/RHEL-103915
win11 guest with vtpm and bitlocker enabled will power off automatically if the user does not enter the key in 1 minute after v2v conversion [docs only]
- https://issues.redhat.com/browse/RHEL-133729
virt-v2v migration from vSphere fails when datastore name has characters like '+' [rhel-10.2]
- https://issues.redhat.com/browse/RHEL-136479
v2v fails to create the disk on target if the source guest contains specific characters like '*+_/'
- https://issues.redhat.com/browse/RHEL-137121
encrypted ubuntu installation fails to boot after conversion
- https://issues.redhat.com/browse/RHEL-144075
Expose XFS version in virt-v2v-inspector
- https://issues.redhat.com/browse/RHEL-144467
[MTV] Debian UEFI VM fails to boot after migrating to Openshift Virtualzation.
- https://issues.redhat.com/browse/RHEL-148423
blnsvr.exe running from C:\Program Files\Guestfs\Firstboot\Temp
- https://issues.redhat.com/browse/RHEL-152939
Create sentinel file after all firstboot scripts have finished running
- https://issues.redhat.com/browse/RHEL-164271
Add virt-v2v-in-place --no-fstrim option
- https://issues.redhat.com/browse/RHEL-165677
Stop using xfs_repair -m because memory required scales with filesystem size and has sharp edges
- https://issues.redhat.com/browse/RHEL-170864
virt-v2v failing with binary LUKS keys [virt-v2v]
- https://issues.redhat.com/browse/RHEL-178287
virt-v2v fails during migration of RHEL 7 VMs due to XFS filesystem errors, potentially related to RHEL 10.1 xfs_repair running against a RHEL 7 XFS filesystem.
- https://issues.redhat.com/browse/RHEL-178432
regression converting ubuntu24.04
- https://issues.redhat.com/browse/RHEL-178556
Use bind mount to overwrite /sysroot/etc/resolv.conf during "sh" operations
- https://issues.redhat.com/browse/RHEL-184508
Set boot disk index for guests in virt-v2v-in-place / inspection XML output
- https://issues.redhat.com/browse/RHEL-188772
RFE: virt-v2v option to collect Windows registry and event logs and other useful information
- https://issues.redhat.com/browse/RHEL-191749
virt-v2v fails during migration of RHEL 7 VMs due to XFS filesystem errors, potentially related to RHEL 10.1 xfs_repair running against a RHEL 7 XFS filesystem [virt-v2v]
See Also
Authors
Authors of virt-v2v 2.12:
Andi Chandler
Arif Budiman
Cole Robinson
Emilio Herrera
Ettore Atalan
Fco. Javier F. Serrador
grass lu
grimst
Hela Basa
Jan Kuparinen
Krascovict Petrov
Martin Necas
Nathan95
Olaf Hering
Pavel Borecki
Piotr Drąg
Rafael Fontenelle
Richard W.M. Jones
Ricky Tigg
sarika
Susant Sahani
Temuri Doghonadze
Tim Wiederhake
Yuri Chornoivan
Copyright
Copyright (C) 2009-2026 Red Hat Inc.
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.
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.
Bugs
To get a list of bugs against libguestfs, use this link: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
When reporting a bug, please supply:
- 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.