.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 2.11.5 (Pod::Simple 3.47)
.\"
.\" 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
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "virt-v2v-release-notes-2.2 1"
.TH virt-v2v-release-notes-2.2 1 2026-04-13 virt-v2v-2.11.5 "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 名前
.IX Header "名前"
virt\-v2v\-release\-notes \- virt\-v2v release notes for 2.2
.SH 説明
.IX Header "説明"
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\*(Aqt 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\*(Aqt 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 内部
.IX Subsection "内部"
New LUKS\-on\-LVM test added (Laszlo Ersek).
.PP
Added \fIscripts/git.orderfile\fR which orders files when we prepare patches.
.SS バグ修正
.IX Subsection "バグ修正"
.IP https://bugzilla.redhat.com/2152465 4
.IX Item "https://bugzilla.redhat.com/2152465"
v2v should set ovirt:id correctly after converting 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\*(Aqt 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\*(Aqt 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 \*(Aqreadonly\*(Aq deprecated"
.IP https://bugzilla.redhat.com/2076013 4
.IX Item "https://bugzilla.redhat.com/2076013"
RHEL9.1 guest can\*(Aqt 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\*(Aqt 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 permission 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 \*(Aq\-\-compressed\*(Aq 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\*(Aqt cover ssh / scp shell commands
.IP https://bugzilla.redhat.com/1817050 4
.IX Item "https://bugzilla.redhat.com/1817050"
Can\*(Aqt 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 関連項目
.IX Header "関連項目"
\&\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 著者
.IX Header "著者"
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\-2025 Red Hat Inc.
.SH LICENSE
.IX Header "LICENSE"
.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.
