NAME

virt-v2v-release-notes - virt-v2v release notes for 2.8

DESCRIPTION

These are the release notes for virt-v2v 2.8. This describes the major changes since 2.6.

Virt-v2v 2.8.0 was released on XXX XXX 2025.

New features

Windows Server 2025 is supported (thanks Ming Xie).

Two features have been added to enhance data integrity. Firstly you can specify a <checksum> field for each input disk (when importing from libvirt). Virt-v2v will verify the checksum of the actual disk matches the expected checksum. Secondly virt-v2v in debug mode now computes the blkhash (a type of checksum) of the converted disk and prints it out, allowing you to compare the blkhash with the final output.

The UEFI secureboot property is now modelled correctly, and (for outputs which support it) is reflected in the output metadata (thanks Daniel Berrange, Andrea Bolognani, Ming Xie).

Parallel disk copies are now possible, using the --parallel=N option. The default behaviour is still to do serial copies.

virt-v2v-in-place(1) has a new -O option. This generates the same output as virt-v2v-inspector(1), allowing callers to combine both passes into one.

Virtio-win driver selection has been made more robust. It now selects the correct drivers to install in more cases, and avoids installing unnecessary debugging and SRIOV files. Libosinfo is no longer used for this as the osinfo metadata used had grown out of date. (Cole Robinson)

Features removed

Handling of kmod-xenpv has been removed. This only applied to RHEL 3 and RHEL 4 guests being converted from very ancient versions of Xen (Cole Robinson).

Other fixes

Update support page to cover RHEL 10 and Windows Server 2025.

When importing from libvirt sources, trim whitespace from around the <name> element, rather than creating a guest name containing that whitespace.

We no longer overwrite the EFI grub2 wrapper file (/boot/efi/EFI/<OS>/grub.cfg) on Fedora ≥ 34 and RHEL ≥ 9.0.

When removing packages during conversion, use yum, apt, and similar tools so that dependencies are also removed (Cole Robinson).

When some rpm commands run in the context of the guest produced more than 4MB of output, virt-v2v conversions would fail. This has now been fixed (thanks Nijin Ashok).

Virt-v2v is now compatible with guests that use dnf5.

-i vmx mode now supports importing guests with SATA-emulated disks.

Build changes

json-c is now required. This replaces Jansson which was previously used for parsing JSON input files.

libguestfs ≥ 1.55.6 is now required.

OCaml ≥ 4.08 is now required.

libnbd ≥ 1.14 is now required.

OCaml oUnit is no longer used.

We now assume that __attribute__((cleanup)) always works. This requires gcc or Clang.

The configure option --with-virt-v2v-nbdkit-python-plugin has been removed. It was only needed for very old versions of nbdkit and Python.

Tests should no longer break if ntfs-3g is not supported by libguestfs.

Internals

The tests were modified to use a set of common functions and remove use of the weird $TEST_FUNCTIONS macro, similar to how we do it in nbdkit.

The way we generate the phony virtio-win drivers (for testing) has been simplified. Also there are new regression tests to ensure that virt-v2v installs the correct set of driver files. (Cole Robinson).

Phony Windows guests are now generated for several different versions of Windows, allowing more broad testing (Cole Robinson).

Bugs fixed

https://issues.redhat.com/browse/MTV-2256

Document issues with upgrading Windows guests after conversion

https://issues.redhat.com/browse/RHEL-32099

Harden grub2-mkconfig to avoid overwriting /boot/efi/EFI/redhat/grub.cfg

https://issues.redhat.com/browse/RHEL-39077

v2v can't convert the guest if info "add_dracutmodules+=" network-legacy " is added to network-legacy.conf [rhel-9.6]

https://issues.redhat.com/browse/RHEL-58032

v2v: add output file after virt-v2v-in-place conversion [rhel-9.6]

https://issues.redhat.com/browse/RHEL-65009

Can't find drivers from virtio-win for win2025 guests during v2v conversion [rhel 10.0]

https://issues.redhat.com/browse/RHEL-65010

Can't find drivers from virtio-win for win2025 guests during v2v conversion [rhel 9.6]

https://issues.redhat.com/browse/RHEL-66197

[MTV] migration failed with module "network-legacy" configured in RHEL 8 guests

https://issues.redhat.com/browse/RHEL-67007

[RFE] Add secureboot info in kubevirt output [rhel-9.7]

https://issues.redhat.com/browse/RHEL-67836

RFE: Get the uefi.secureBoot.enabled setting from VMware sources [rhel-9.6]

https://issues.redhat.com/browse/RHEL-71522

Migration Plan / vddk pod cannot remove open-vm-tools in case of dependencies [rhel-9.6]

https://issues.redhat.com/browse/RHEL-77989

CentOS 9 Migration from VMWare to Openshift Virt fails [rhel-9.6]

https://issues.redhat.com/browse/RHEL-80080

Converting a SUSE VM will fail if the kernel-source package is installed in the source VM

https://issues.redhat.com/browse/RHEL-85508

Improve checksumming and data consistency checks in virt-v2v, libnbd, nbdkit

https://issues.redhat.com/browse/RHEL-85512

Print blkhash of converted image in virt-v2v debugging output [9.7]

https://issues.redhat.com/browse/RHEL-85514

Print blkhash of converted image in virt-v2v debugging output [10.1]

https://issues.redhat.com/browse/RHEL-86022

There is no nbdcopy info in v2v debug log since virt-v2v version 2.7.1-2 [rhel-9.7]

https://github.com/libguestfs/virt-v2v/issues/79

virt-v2v 2.7.4 error: libguestfs error: you must call guestfs_add_drive before guestfs_launch

SEE ALSO

virt-v2v(1).

AUTHORS

Authors of virt-v2v 2.8:

Cole Robinson
Krascovict Petrov
Richard W.M. Jones
Ricky Tigg
Yuri Chornoivan

COPYRIGHT

Copyright (C) 2009-2025 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: