NAME

virt-v2v-release-notes - 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

virt-v2v(1).

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: