Scroll to navigation

virt-v2v-release-notes-2.12(1) Virtualization Support virt-v2v-release-notes-2.12(1)

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:

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.
2026-07-20 virt-v2v-2.12.0