.\" 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 .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . 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.0 1" .TH virt-v2v-release-notes-2.0 1 "2024-01-09" "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.0 .SH "DESCRIPTION" .IX Header "DESCRIPTION" These are the release notes for \fBvirt\-v2v 2.0\fR. This describes the major changes since 1.42. .PP No release notes were published for 1.44, so that release is covered here. .PP Virt\-v2v 2.0.0 was released on \fB14 March 2022\fR. .SS "Security" .IX Subsection "Security" There were no security-related bugs found in this release. .SS "New features" .IX Subsection "New features" Virt\-v2v has been modularised allowing external programs to examine the state of the conversion and inject their own copying step. Further enhancements will be made to this new architecture in forthcoming releases. .PP The command line is almost identical apart from some debugging features that were removed (see below). The only significant difference is that the output format (\fI\-of\fR) now has to be specified if it is different from the input format, whereas previous versions of virt\-v2v would use the same output format as input format automatically. .PP A lot of time was spent improving the performance of virt\-v2v in common cases. .PP Implement conversion of \s-1ALT\s0 Linux guests (Mikhail Gordeev). .PP Many bug fixes and performance enhancements were made to oVirt imageio output (Nir Soffer). .PP There is a new \fBvirt\-v2v\-in\-place\fR\|(1) tool which replaces the existing virt\-v2v \fI\-\-in\-place\fR option. .PP Virt\-v2v can now convert guests which use \s-1LUKS\s0 encrypted logical volumes (Laszlo Ersek). .PP Option \fI\-oo rhv-direct\fR has been replaced by \fI\-oo rhv-proxy\fR, and direct mode (which is much faster) is now the default when writing to oVirt, with proxy mode available for restricted network configurations (thanks: Nir Soffer). .PP The following command line options were removed: \fI\-\-print\-estimate\fR, \&\fI\-\-debug\-overlays\fR, \fI\-\-no\-copy\fR. .PP Virt\-v2v no longer installs the RHEV-APT tool in Windows guests. This tool was deprecated and then removed in oVirt 4.3. .PP Deprecated tool virt\-v2v\-copy\-to\-local has been removed. This was deprecated in November 2018. .SS "Other fixes" .IX Subsection "Other fixes" Remove reference to prl_strg driver in Windows guests to avoid \s-1BSOD\s0 (Denis Plotnikov). .PP Fix conversions of \s-1UEFI\s0 Linux guests that don't provide their own fallback bootloader (Denis Plotnikov). .PP Remove use of \fBnbdkit\-readahead\-filter\fR\|(1). This filter uses a naive strategy and it had several negative effects on conversions. .PP Remove prompts for interactive passwords. Normally you should try to use the \fI\-ip\fR and/or \fI\-op\fR options to supply passwords. .PP For Windows guests, we insert a schtasks command. However the parameters of this command are timezone dependent and so it failed in non-European timezones. (Thanks: Dinesh Herath, Tomáš Golembiovský, Bryan Kinney, Mark Zealey, Xiaodai Wang) .PP Virt\-v2v will reauthenticate with vCenter servers periodically when copying guests over \s-1HTTPS\s0 which stops large guests and/or slow copies taking longer than about 30 minutes from failing. .PP Virt\-v2v now sets libguestfs \s-1SMP\s0 to match number of physical host CPUs, which helps performance of certain conversion steps. .PP Virt\-v2v output to oVirt now attempts to set the machine and firmware type correctly. Note an exact mapping is not always possible and oVirt may ignore our recommendations (incorrectly) sometimes. .PP Virt\-v2v now generates a virtio-vsock device for guests which support it (Valeriy Vdovin). .PP All guests now need at least 100 \s-1MB\s0 of free space for conversion to succeed (Ming Xie). .PP Standard \s-1VGA\s0 instead of \s-1QXL\s0 is now used as the video type for converted guests (Laszlo Ersek). .PP Older guests (eg \s-1RHEL 6\s0) will use the virtio-transitional model after conversion. This feature and the machine type are now usually determined from the libosinfo database, falling back to hard-coded values if libosinfo is not available (Laszlo Ersek). .PP When virt\-v2v prints messages to a pipe or file it no longer wraps them, making parsing simpler. You can enable wrapping in this mode using \fI\-\-wrap\fR (Laszlo Ersek). .PP Windows guest firstboot scripts installed by virt\-v2v now run in the right order, making network configuration happen earlier (Laszlo Ersek). .SS "Build changes" .IX Subsection "Build changes" libguestfs ≥ 1.44 is now required. .PP \&\fBnbdcopy\fR\|(1) and OCaml \s-1NBD\s0 bindings, both from libnbd ≥ 1.10, are now required. .PP nbdkit ≥ 1.22 is now required (Nir Soffer). .PP pcre2 (instead of pcre) is now required. .PP gnulib is no longer bundled or used by virt\-v2v. .PP OCaml ≥ 4.04 is now required. OCaml 4.13 support has been added in this release. .PP OpenSSH scp ≥ 8.8 is now required. Earlier versions will fail because the command line syntax was changed incompatibly. .SS "Internals" .IX Subsection "Internals" Weblate instead of Zanata is now used for translations (Pino Toscano). .SS "Bugs fixed" .IX Subsection "Bugs fixed" .IP "https://bugzilla.redhat.com/2051394" 4 .IX Item "https://bugzilla.redhat.com/2051394" Missing error message of 'insufficient free space in the conversion server temporary directory' .IP "https://bugzilla.redhat.com/2044922" 4 .IX Item "https://bugzilla.redhat.com/2044922" nbdinfo output to stdout instead of stderr during virt\-v2v conversion .IP "https://bugzilla.redhat.com/2044911" 4 .IX Item "https://bugzilla.redhat.com/2044911" virt\-p2v conversion hangs with \s-1RHEL9\s0 virt\-v2v .IP "https://bugzilla.redhat.com/2043333" 4 .IX Item "https://bugzilla.redhat.com/2043333" \&'model='virtio\-transitional' is wrongly added when converting windows guest to local by rhel9 v2v .IP "https://bugzilla.redhat.com/2041886" 4 .IX Item "https://bugzilla.redhat.com/2041886" virt\-v2v hangs for several minutes when using \-ic vpx://... \-it vddk with incorrect \s-1IP\s0 address .IP "https://bugzilla.redhat.com/2041852" 4 .IX Item "https://bugzilla.redhat.com/2041852" Improve the unclear assertion failure at input_xen_ssh.ml .IP "https://bugzilla.redhat.com/2041850" 4 .IX Item "https://bugzilla.redhat.com/2041850" Can not specify '\-oo json\-disks\-pattern' in '\-o json' mode .IP "https://bugzilla.redhat.com/2039597" 4 .IX Item "https://bugzilla.redhat.com/2039597" Failed to import \s-1VM\s0 when selecting \s-1OVA\s0 as a source on \s-1RHV\s0 webadmin .IP "https://bugzilla.redhat.com/2039255" 4 .IX Item "https://bugzilla.redhat.com/2039255" Conversion performance is not good when convert guest by modular virt\-v2v .IP "https://bugzilla.redhat.com/2034240" 4 .IX Item "https://bugzilla.redhat.com/2034240" calling \*(L"get_disk_allocated\*(R" in \*(L"create_ovf\*(R" breaks the rhv-upload output plugin .IP "https://bugzilla.redhat.com/2033096" 4 .IX Item "https://bugzilla.redhat.com/2033096" \&\s-1RFE:\s0 Remove \-oo rhv-direct and add \-oo rhv-proxy option .IP "https://bugzilla.redhat.com/2032324" 4 .IX Item "https://bugzilla.redhat.com/2032324" nbdcopy command failed when using v2v to convert guest from ESXi6.5 via vddk > 6.5 + rhv-upload to rhv4.4 .IP "https://bugzilla.redhat.com/2032112" 4 .IX Item "https://bugzilla.redhat.com/2032112" Add virt\-v2v and libvirt version to the beginning of v2v debug log .IP "https://bugzilla.redhat.com/2027673" 4 .IX Item "https://bugzilla.redhat.com/2027673" V2V can't convert guest from VMware via vmx+ssh when openssh version is 8.7p1\-5 .IP "https://bugzilla.redhat.com/2027598" 4 .IX Item "https://bugzilla.redhat.com/2027598" There is no guest listed in export domain if use v2v to convert guest to rhv via \-o rhv .IP "https://bugzilla.redhat.com/1994984" 4 .IX Item "https://bugzilla.redhat.com/1994984" virt\-v2v can't convert bitblocker windows guest with libguestfs error: /dev/mapper/cryptsda: No such file or directory .IP "https://bugzilla.redhat.com/1977681" 4 .IX Item "https://bugzilla.redhat.com/1977681" The usage description of '\-oo rhv\-disk\-uuid=UUID' in man virt\-v2v should be updated .IP "https://bugzilla.redhat.com/1976607" 4 .IX Item "https://bugzilla.redhat.com/1976607" [\s-1RFE\s0] Drop \s-1QXL\s0 for guests on CentOS 9 clusters .IP "https://bugzilla.redhat.com/1976024" 4 .IX Item "https://bugzilla.redhat.com/1976024" [\s-1RFE\s0][v2v] [upload/download disk/CBT] Failed to attach disk to the \s-1VM\s0 \- disk is \s-1OK\s0 but image transfer still holds a lock on the disk .IP "https://bugzilla.redhat.com/1972125" 4 .IX Item "https://bugzilla.redhat.com/1972125" Update privileges for Non-admin vmware role when ESXi host has enabled host encryption mode in virt\-v2v\-input\-vmware man page .IP "https://bugzilla.redhat.com/1967941" 4 .IX Item "https://bugzilla.redhat.com/1967941" virt\-v2v can't install qemu-guest-agent for rhel9 guest during conversion .IP "https://bugzilla.redhat.com/1964324" 4 .IX Item "https://bugzilla.redhat.com/1964324" assertion failed at parse_ova.ml when ova directory ends with '/' .IP "https://bugzilla.redhat.com/1961107" 4 .IX Item "https://bugzilla.redhat.com/1961107" Change video type from qxl to vga after v2v conversion .IP "https://bugzilla.redhat.com/1960087" 4 .IX Item "https://bugzilla.redhat.com/1960087" v2v import from vCenter fails when using interactive password because cookie-script tries to be interactive .IP "https://bugzilla.redhat.com/1949147" 4 .IX Item "https://bugzilla.redhat.com/1949147" Should improve the minimum free space for windows guest in v2v man page and better to improve v2v error message about no space left for windows guest .IP "https://bugzilla.redhat.com/1945549" 4 .IX Item "https://bugzilla.redhat.com/1945549" Delete or improve the warning info about rhev-apt during v2v converting windows guest on rhel9 .IP "https://bugzilla.redhat.com/1942325" 4 .IX Item "https://bugzilla.redhat.com/1942325" Virt\-v2v should add 'model='virtio\-transitional' to \s-1RHEL\s0 <=6 guest virtio devices during conversion if target is rhel9 system .IP "https://bugzilla.redhat.com/1926102" 4 .IX Item "https://bugzilla.redhat.com/1926102" \&\*(L"virt\-v2v: warning: there is no \s-1QXL\s0 driver for this version of Windows\*(R" still shows, even though we copied qxldod driver to the guest .IP "https://bugzilla.redhat.com/1917760" 4 .IX Item "https://bugzilla.redhat.com/1917760" VMware tools not getting uninstalled as part of \s-1IMS\s0 .IP "https://bugzilla.redhat.com/1903960" 4 .IX Item "https://bugzilla.redhat.com/1903960" Should hidden \*(L"virt\-v2v: warning: /usr/share/virt\-tools/pnp_wait.exe is missing..\*(R"during conversion .IP "https://bugzilla.redhat.com/1901489" 4 .IX Item "https://bugzilla.redhat.com/1901489" \&\s-1VDDK 6.7\s0 repeatedly reconnects with nbdkit: vddk[1]: debug: NBD_ClientOpen: attempting to create connection to vpxa\-nfc:// followed by virt\-v2v failure .IP "https://bugzilla.redhat.com/1895323" 4 .IX Item "https://bugzilla.redhat.com/1895323" After virt\-v2v, qemu-ga does not run at Windows firstboot if the timezone is not M/d/yyyy format .IP "https://bugzilla.redhat.com/1872100" 4 .IX Item "https://bugzilla.redhat.com/1872100" Should correct info about '\s-1UEFI\s0 on OpenStack' in virt\-v2v\-support man page .IP "https://bugzilla.redhat.com/1872094" 4 .IX Item "https://bugzilla.redhat.com/1872094" Virt\-v2v should convert \s-1UEFI\s0 guest to openstack via openstack option successfully .IP "https://bugzilla.redhat.com/1871754" 4 .IX Item "https://bugzilla.redhat.com/1871754" \&\s-1RFE:\s0 Should clarify which file is correct authentication file for openstack/glance conversion in virt\-v2v\-output\-openstack man page .IP "https://bugzilla.redhat.com/1868690" 4 .IX Item "https://bugzilla.redhat.com/1868690" Ceph block device will be destroyed if v2v convert guest to ceph block device and guest disk size is greater than ceph block device .IP "https://bugzilla.redhat.com/1858775" 4 .IX Item "https://bugzilla.redhat.com/1858775" \&\s-1RFE:\s0 virt\-v2v should check the ip info when specify guest's ip .IP "https://bugzilla.redhat.com/1858765" 4 .IX Item "https://bugzilla.redhat.com/1858765" V2V option \-\-keys\-from\-stdin gives error: getline: Inappropriate ioctl for device .IP "https://bugzilla.redhat.com/1854275" 4 .IX Item "https://bugzilla.redhat.com/1854275" document that vmx+ssh \*(L"\-ip\*(R" auth doesn't cover ssh / scp shell commands .IP "https://bugzilla.redhat.com/1842440" 4 .IX Item "https://bugzilla.redhat.com/1842440" nbdkit cannot read the password interactively when started from virt\-v2v .IP "https://bugzilla.redhat.com/1841096" 4 .IX Item "https://bugzilla.redhat.com/1841096" Option \-\-bandwidth and \-\-bandwidth\-file isn't working as expected during v2v conversion .IP "https://bugzilla.redhat.com/1839917" 4 .IX Item "https://bugzilla.redhat.com/1839917" There is no info \*(L"Opening the source \-i libvirt \-ic vpx://...\*(R" shown if any \s-1IP\s0 is wrong in vpx:// \s-1URL\s0 during v2v conversion .IP "https://bugzilla.redhat.com/1838425" 4 .IX Item "https://bugzilla.redhat.com/1838425" V2V doesn't ask password if there is no option about password file in v2v command line .IP "https://bugzilla.redhat.com/1837453" 4 .IX Item "https://bugzilla.redhat.com/1837453" [\s-1RFE\s0]Remove cache=none for guest after v2v converting to libvirt .IP "https://bugzilla.redhat.com/1837328" 4 .IX Item "https://bugzilla.redhat.com/1837328" Virt\-v2v cannot convert guest from \s-1ESXI7.0\s0 server without vddk .IP "https://bugzilla.redhat.com/1832805" 4 .IX Item "https://bugzilla.redhat.com/1832805" v2v conversion will be failed because of memory allocation failure if convert guest from ESXi6.0 or ESXi6.5 via vddk, or use vddk6.5 to convert guest from VMware .IP "https://bugzilla.redhat.com/1789279" 4 .IX Item "https://bugzilla.redhat.com/1789279" virt\-v2v should give more clear error info when use some special invalid uuids for disks .IP "https://bugzilla.redhat.com/1788823" 4 .IX Item "https://bugzilla.redhat.com/1788823" Virt\-v2v firstboot scripts should run in order, with v2v network configuration happening first .IP "https://bugzilla.redhat.com/1764569" 4 .IX Item "https://bugzilla.redhat.com/1764569" V2V conversion fails when a filesystem has no free inodes .IP "https://bugzilla.redhat.com/1658126" 4 .IX Item "https://bugzilla.redhat.com/1658126" Virt\-v2v can't convert guest using LUKS-on-LV .IP "https://bugzilla.redhat.com/1637857" 4 .IX Item "https://bugzilla.redhat.com/1637857" q35 switch caused: error: unsupported configuration: \s-1IDE\s0 controllers are unsupported for this \s-1QEMU\s0 binary or machine type .IP "https://bugzilla.redhat.com/1581428" 4 .IX Item "https://bugzilla.redhat.com/1581428" virt\-v2v use Q35 as default machine-type .IP "https://bugzilla.redhat.com/1534644" 4 .IX Item "https://bugzilla.redhat.com/1534644" New way of parsing \s-1OVF\s0 from \s-1OVA\s0 that was created by VMware fails. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBvirt\-v2v\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.0: .IP "Denis Plotnikov" 4 .IX Item "Denis Plotnikov" .PD 0 .IP "Kevin Locke" 4 .IX Item "Kevin Locke" .IP "Laszlo Ersek" 4 .IX Item "Laszlo Ersek" .IP "Martin Kletzander" 4 .IX Item "Martin Kletzander" .IP "Mikhail Gordeev" 4 .IX Item "Mikhail Gordeev" .IP "Nir Soffer" 4 .IX Item "Nir Soffer" .IP "Pino Toscano" 4 .IX Item "Pino Toscano" .IP "Richard W.M. Jones" 4 .IX Item "Richard W.M. Jones" .IP "Valeriy Vdovin" 4 .IX Item "Valeriy Vdovin" .PD .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (C) 2009\-2022 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 \s-1GNU\s0 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 \&\s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of \&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 See the \s-1GNU\s0 General Public License for more details. .PP You should have received a copy of the \s-1GNU\s0 General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, \s-1MA 02110\-1301 USA.\s0 .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.