.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 2.4.0 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "virt-v2v-release-notes-2.2 1"
.TH virt-v2v-release-notes-2.2 1 2024-03-15 virt-v2v-2.4.0 "Virtualization Support"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
virt\-v2v\-release\-notes \- virt\-v2v release notes for 2.2
.SH DESCRIPTION
.IX Header "DESCRIPTION"
These are the release notes for \fBvirt\-v2v\ 2.2\fR.
This describes the major changes since 2.0.
.PP
Virt\-v2v 2.2.0 was released on \fBTuesday\ 10\ January\ 2023\fR.
.SS Security
.IX Subsection "Security"
When running virt\-v2v as root, NBD Unix domain sockets in the v2v
directory were openable by any user.  We now set the directory owner
so only qemu can access the sockets.  See:
https://bugzilla.redhat.com/show_bug.cgi?id=2066773 (thanks
Xiaodai Wang, Dr\ David\ Gilbert, Daniel Berrangé, Laszlo Ersek).
.SS "New features"
.IX Subsection "New features"
New \fBvirt\-v2v\-inspector\fR\|(1) tool.  This tool can be used before
conversion to collect facts about the source guest, such as number of
disks, and to estimate the disk space required after conversion.
.PP
Add support for NVMe devices and SATA hard disks when importing from
VMware VMX files (Laszlo Ersek).
.PP
Add support for importing to KubeVirt using the new \fBexperimental\fR
\&\fI\-o kubevirt\fR mode.
.PP
Windows 11 guests are now supported.
.PP
Rocky Linux guest support has been added (Andrey Drobyshev).
.SS "Feature removed"
.IX Subsection "Feature removed"
The \fI\-o json\fR mode was removed.  It was intended to be used with
KubeVirt but was never actually used there.  Use \fI\-o kubevirt\fR
instead.
.SS "Other fixes"
.IX Subsection "Other fixes"
Fix detection of virtio-socket support in Linux guests (Laszlo Ersek).
In addition, a semi-random guest CID is chosen in \fI\-o qemu\fR mode,
avoiding an error.
.PP
Allow importing OVAs where the user or group name inside the tarball
contains a space (Jiří Sléžka).
.PP
Reject guests with snapshots when using \-i vmx \-it ssh (Laszlo Ersek).
.PP
Improve documentation for the need to enable PasswordAuthentication on
the server side when importing over SSH (Laszlo Ersek).
.PP
Don't use the deprecated qemu \fI\-balloon\fR option.  This caused
deprecation warnings with \fI\-o qemu\fR mode.  Use \fI\-device\fR instead.
.PP
Rewrite device mapping in \fI\-o qemu\fR mode, removing some strange /
non-existent cases like SCSI floppies.  This should result in more
consistent device layout when using this mode (Laszlo Ersek).
.PP
Remove more left over open-vm-tools packages from Linux guests (Tim
Kent).
.PP
In \fI\-o rhv-upload\fR mode, do not return until the VM has been created
(Tomáš Golembiovský).
.PP
Greatly improved vCPU model handling (Laszlo Ersek).
.PP
Document extra permissions needed for non-admin conversion with
VMware\ 7 (Ming Xie).
.PP
QEMU guest agent is now installed unconditionally and where possible a
virtio-serial socket is created in the guest metadata (Laszlo Ersek).
.PP
In the various RHV output modes, the number of disks is now limited to
23.  RHV doesn't support anything greater and would break (Laszlo
Ersek).
.PP
\&\fI\-oo compressed\fR is now working again.  It was temporarily broken in
virt\-v2v 2.0.
.PP
The documentation no longer advises you to use the dangerous global
"LEGACY crypto" option, but provides more targeted advice (Laszlo
Ersek).
.PP
Remove the LVM2 devices file during conversion (Laszlo Ersek).
.PP
Add support for guests using Zstandard compressed kernel modules.
.PP
Add the BOCHS DRM display driver in Linux guest initrd, to avoid a
crash with some guests with graphical boot displays (Laszlo Ersek).
.PP
The UEFI fallback boot loader is now fixed up if we detect that it was
broken (Laszlo Ersek).
.PP
Improve detection of guests using BIOS boot with GPT partitions so
that we no longer confuse them with UEFI guests (Andrey Drobyshev).
.PP
Fix conflict between fwcfg and qemufwcfg Windows drivers (Laszlo
Ersek).
.PP
Fix Windows 11 support for RHV outputs (Laszlo Ersek).
.SS "Build changes"
.IX Subsection "Build changes"
Enable malloc debugging in tests with glibc ≥ 2.34.
.PP
When using \f(CW\*(C`make check\-valgrind\*(C'\fR, valgrind output is no longer
written to separate files under \fItmp/\fR.  Instead it is written to the
normal test log file.
.PP
We now require ocamldep \fI\-one\-line\fR and \fI\-all\fR options (added to
ocamldep in Jan 2012).
.PP
The OCaml libvirt bindings are no longer bundled.  They must be
available at build time.
.PP
Updated the phony test images.  The tests should all pass.
.PP
Add compatibility with OCaml 4.14.
.PP
We now require PCRE2 instead of PCRE.
.SS Internals
.IX Subsection "Internals"
New LUKS-on-LVM test added (Laszlo Ersek).
.PP
Added \fIscripts/git.orderfile\fR which orders files when we prepare
patches.
.SS "Bugs fixed"
.IX Subsection "Bugs fixed"
.IP https://bugzilla.redhat.com/2152465 4
.IX Item "https://bugzilla.redhat.com/2152465"
v2v should set ovirt:id correctly after coverting windows11/2019/2022 guests to rhv via \-o rhv-upload
.IP https://bugzilla.redhat.com/2151752 4
.IX Item "https://bugzilla.redhat.com/2151752"
qemufwcfg device cannot start or has no driver after v2v converting windows guests
.IP https://bugzilla.redhat.com/2149863 4
.IX Item "https://bugzilla.redhat.com/2149863"
The version of Win 11/Win 2019/Win 2022 shows incorrect on RHV after virt\-v2v conversion
.IP https://bugzilla.redhat.com/2149811 4
.IX Item "https://bugzilla.redhat.com/2149811"
Copy newer versions of drivers for Win 11/Win 2019/Win 2022 during virt\-v2v conversion
.IP https://bugzilla.redhat.com/2149629 4
.IX Item "https://bugzilla.redhat.com/2149629"
Win 2022 fails to boot after virt\-p2v conversion from physical host with nvme disk
.IP https://bugzilla.redhat.com/2131123 4
.IX Item "https://bugzilla.redhat.com/2131123"
RHEL7 UEFI guest turns into black after v2v conversion
.IP https://bugzilla.redhat.com/2116811 4
.IX Item "https://bugzilla.redhat.com/2116811"
virt\-v2v: error: internal error: assertion failed at linux_kernels.ml, line 190, char 11
.IP https://bugzilla.redhat.com/2112801 4
.IX Item "https://bugzilla.redhat.com/2112801"
RHEL9 guest hangs during boot after conversion by virt\-p2v
.IP https://bugzilla.redhat.com/2107503 4
.IX Item "https://bugzilla.redhat.com/2107503"
RHEL 8.6 VM with "qemu64" CPU model can't start because "the CPU is incompatible with host CPU: Host CPU does not provide required features: svm"
.IP https://bugzilla.redhat.com/2101665 4
.IX Item "https://bugzilla.redhat.com/2101665"
"/dev/nvme0n1" is not remapped to "/dev/vda" (etc) in boot config files such as "/boot/grub2/device.map"
.IP https://bugzilla.redhat.com/2089623 4
.IX Item "https://bugzilla.redhat.com/2089623"
Virt\-v2v can't convert rhel8.6 guest from VMware on rhel8.6
.IP https://bugzilla.redhat.com/2082603 4
.IX Item "https://bugzilla.redhat.com/2082603"
virt\-v2v \-o qemu prints cosmetic warning: "warning: short-form boolean option 'readonly' deprecated"
.IP https://bugzilla.redhat.com/2076013 4
.IX Item "https://bugzilla.redhat.com/2076013"
RHEL9.1 guest can't boot into OS after v2v conversion
.IP https://bugzilla.redhat.com/2074805 4
.IX Item "https://bugzilla.redhat.com/2074805"
\&\-o qemu mode fails with: qemu\-system\-x86_64: \-balloon: invalid option and other problems
.IP https://bugzilla.redhat.com/2074801 4
.IX Item "https://bugzilla.redhat.com/2074801"
do not pass "\-\-non\-bootable \-\-read\-write" to "volume create " in openstack output module
.IP https://bugzilla.redhat.com/2070530 4
.IX Item "https://bugzilla.redhat.com/2070530"
Virt\-v2v can't convert guest when os is installed on nvme disk via vmx+ssh
.IP https://bugzilla.redhat.com/2070186 4
.IX Item "https://bugzilla.redhat.com/2070186"
fix virtio-vsock check (for Linux guests) in virt\-v2v
.IP https://bugzilla.redhat.com/2069768 4
.IX Item "https://bugzilla.redhat.com/2069768"
Import of OVA fails if the user/group name contains spaces
.IP https://bugzilla.redhat.com/2066773 4
.IX Item "https://bugzilla.redhat.com/2066773"
The /tmp/v2v.XXXX directory has incorrect permisison if run v2v by root
.IP https://bugzilla.redhat.com/2062360 4
.IX Item "https://bugzilla.redhat.com/2062360"
RFE: Virt\-v2v should replace hairy "enable LEGACY crypto" advice which a more targeted mechanism
.IP https://bugzilla.redhat.com/2059287 4
.IX Item "https://bugzilla.redhat.com/2059287"
RFE: Rebase virt\-v2v to 2.0 in RHEL 9.1
.IP https://bugzilla.redhat.com/2051564 4
.IX Item "https://bugzilla.redhat.com/2051564"
[RFE]Limiting the maximum number of disks per guest for v2v conversions
.IP https://bugzilla.redhat.com/2047660 4
.IX Item "https://bugzilla.redhat.com/2047660"
Add '\-\-compressed' support in modular v2v
.IP https://bugzilla.redhat.com/2028764 4
.IX Item "https://bugzilla.redhat.com/2028764"
Install the qemu-guest-agent package during the conversion process
.IP https://bugzilla.redhat.com/2003503 4
.IX Item "https://bugzilla.redhat.com/2003503"
There is virt\-v2v warning: fstrim on guest filesystem /dev/mapper/osprober\-linux\-sdb1 failed if non-os disk of source guest has few/no inodes lef
.IP https://bugzilla.redhat.com/1985827 4
.IX Item "https://bugzilla.redhat.com/1985827"
Start or remove VM failure even v2v has already finished
.IP https://bugzilla.redhat.com/1953286 4
.IX Item "https://bugzilla.redhat.com/1953286"
No error shows when using virt\-v2v \-o rhv to convert guest to data domain
.IP https://bugzilla.redhat.com/1938954 4
.IX Item "https://bugzilla.redhat.com/1938954"
\&\-i vmx \-it ssh: document percent encoding in ssh URIs
.IP https://bugzilla.redhat.com/1883802 4
.IX Item "https://bugzilla.redhat.com/1883802"
\&\-i vmx: SATA disks are not parsed
.IP https://bugzilla.redhat.com/1854275 4
.IX Item "https://bugzilla.redhat.com/1854275"
document that vmx+ssh "\-ip" auth doesn't cover ssh / scp shell commands
.IP https://bugzilla.redhat.com/1817050 4
.IX Item "https://bugzilla.redhat.com/1817050"
Can't convert guest from VMware with non-admin account and vddk >=7.0  by virt\-v2v
.IP https://bugzilla.redhat.com/1774386 4
.IX Item "https://bugzilla.redhat.com/1774386"
input_vmx: cleanly reject guests with snapshots when using "\-it ssh"
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBvirt\-v2v\fR\|(1),
\&\fBvirt\-v2v\-release\-notes\-2.0\fR\|(1),
\&\fBvirt\-v2v\-release\-notes\-1.42\fR\|(1),
\&\fBguestfs\-release\-notes\-1.40\fR\|(1).
.SH AUTHORS
.IX Header "AUTHORS"
Authors of virt\-v2v 2.2:
.IP "Andrey Drobyshev" 4
.IX Item "Andrey Drobyshev"
.PD 0
.IP "Emilio Herrera" 4
.IX Item "Emilio Herrera"
.IP "Ettore Atalan" 4
.IX Item "Ettore Atalan"
.IP "Hela Basa" 4
.IX Item "Hela Basa"
.IP "Jan Kuparinen" 4
.IX Item "Jan Kuparinen"
.IP "Laszlo Ersek" 4
.IX Item "Laszlo Ersek"
.IP "Marcin Stanclik" 4
.IX Item "Marcin Stanclik"
.IP "Ming Xie" 4
.IX Item "Ming Xie"
.IP "Pavel Borecki" 4
.IX Item "Pavel Borecki"
.IP "Piotr Drąg" 4
.IX Item "Piotr Drąg"
.IP "Richard W.M. Jones" 4
.IX Item "Richard W.M. Jones"
.IP "Ricky Tigg" 4
.IX Item "Ricky Tigg"
.IP "Temuri Doghonadze" 4
.IX Item "Temuri Doghonadze"
.IP "Tim Kent" 4
.IX Item "Tim Kent"
.IP "Tomáš Golembiovský" 4
.IX Item "Tomáš Golembiovský"
.IP "Yuri Chornoivan" 4
.IX Item "Yuri Chornoivan"
.PD
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2023 Red Hat Inc.
.SH LICENSE
.IX Header "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.
.PP
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.
.PP
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.
.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
.PP
To report a new bug against libguestfs, use this link:
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
.IP \(bu 4
The version of libguestfs.
.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.