.\" -*- 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-1.42 1" .TH virt-v2v-release-notes-1.42 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 1.42 .SH DESCRIPTION .IX Header "DESCRIPTION" These are the release notes for \fBvirt\-v2v\ 1.42\fR, released on \fB16th\ April\ 2020\fR. .SS "New features" .IX Subsection "New features" This is the first release where virt\-v2v lives in a separate repository from libguestfs. The two projects are now broadly decoupled from one another. .PP Add a new \fI\-o json\fR output mode. Primarily this is used to do conversions to KubeVirt (Pino Toscano). .PP Use new libvirt \f(CW\*(C`\*(C'\fR feature to get the source guest firmware (Pino Toscano). .PP virt\-v2v \fI\-o rhv-upload\fR new option \fI\-oo rhv-disk-uuid\fR allows disk UUIDs to be specified. Also \fI\-oo rhv-cafile\fR is now optional (Pino Toscano). .PP Conversions over ssh now use \fBnbdkit\-ssh\-plugin\fR\|(1) instead of the QEMU ssh driver. Similarly \fBnbdkit\-curl\-plugin\fR\|(1) is used instead of the QEMU curl driver. This allowed us to add more flexible features such as password authentication, bandwidth throttling (new \&\fI\-\-bandwidth\fR option), readahead, and automatic retry on network failures. .PP For Windows guests, QEMU Guest Agent MSI may now be installed (Tomáš Golembiovský). .SS "Other fixes" .IX Subsection "Other fixes" In \fI\-o libvirt\fR mode, support Windows Server 2019 (Pino Toscano). .PP Fix Ubuntu Server conversions (Pino Toscano). .PP Fix installation of qemu-ga by only installing arch-specific files in the guest (Pino Toscano). .PP Delay installation of qemu-ga until after virtio-win drivers have been installed and rebooted (Tomáš Golembiovský). .PP Save the log from running RHEV-APT installer to allow debugging (Tomáš Golembiovský). .PP Check RHV cluster exists before trying to convert when using \&\fI\-o rhv-upload\fR mode. Also allows us to detect and reject various other conditions early. (Pino Toscano). .PP Label nbdkit sockets correctly for SELinux/sVirt (Martin Kletzander). .PP You can use a block device as the Windows virtio driver ISO. .PP Multiple fixes to RHV uploads: Set \f(CW\*(C`DISKTYPE\*(C'\fR field correctly when converting to RHV and VDSM. Properly clean up on failure. Display disk ID in error messages, and log script parameters, to help with debugging. Multiple code cleanups. (Nir Soffer). .PP Support conversions to RHV in qcow2 format (Nir Soffer). .PP Fix detection of disk status and failures after conversion to RHV (Daniel Erez). .PP Cancel disk transfer and remove uploaded disks on failure of conversion to RHV (Pino Toscano). .PP Images containing small holes (sparse regions) should now convert faster (Nir Soffer). .PP The \fBnbdkit\-cacheextents\-filter\fR\|(1) is used to accelerate sources which have slow sparseness detection, primarily this means VMware sources using VDDK (Martin Kletzander). .PP Require at least 100 free inodes on each guest filesystem before doing conversion, since lack of inodes could cause conversion failures (Pino Toscano). .PP Fix osinfo output for CentOS 8 conversions (Pino Toscano). .PP VMware tools are now removed from Windows guests automatically in most cases (Pino Toscano). .PP \&\fI\-i ova\fR mode no longer reads the whole input OVF into memory, but parses it off disk (Pino Toscano). .PP When converting to OpenStack, we now wait up to 5 minutes (instead of 60 seconds) for the Cinder volume to get attached to the conversion appliance, since in some cases it was taking a long time. .PP If using a new enough version of nbdkit, virt\-v2v logs should be much less verbose. .SS Security .IX Subsection "Security" There were no security-related bugs found in this release. .SS "Build changes" .IX Subsection "Build changes" Libguestfs ≥ 1.40 is required, it is now packaged and distributed separately from virt\-v2v. For developers you can use a locally built (and not installed) copy of libguestfs. .PP Libvirt is now required to build virt\-v2v. Additionally you will require the OCaml bindings to libvirt (https://libvirt.org/ocaml/), although a copy is bundled for now (it will be removed later). (Pino Toscano). .PP Libosinfo is required to build virt\-v2v. It is used to query information about guest drivers. (Pino Toscano). .PP Fixes for OCaml ≥ 4.10. The minimum version of OCaml required is still 4.01, but may be increased to 4.05 in future. .PP Test conversions of Debian 9 and Fedora 29 (Pino Toscano). .PP Various fixes to srcdir != builddir (Pino Toscano). .PP Remove gnulib modules not used by virt\-v2v (Pino Toscano). .SS Internals .IX Subsection "Internals" When converting SUSE guests, always try to install QXL driver (Mike Latimer). .PP Two new modules (Nbdkit and Nbdkit_sources) factor out generic nbdkit operations and nbdkit source operations respectively. .PP Format Python code to comply with PEP 8 / pycodestyle (Pino Toscano). .PP Tests have been moved to the \fItests/\fR subdirectory, and manuals to the \fIdocs/\fR subdirectory. .SS "Bugs fixed" .IX Subsection "Bugs fixed" .IP https://bugzilla.redhat.com/1791802 4 .IX Item "https://bugzilla.redhat.com/1791802" virt\-v2v does not install qemu-ga on EL8 guest .IP https://bugzilla.redhat.com/1791257 4 .IX Item "https://bugzilla.redhat.com/1791257" update-crypto-policies command example is incorrect in virt\-v2v\-input\-xen .IP https://bugzilla.redhat.com/1791240 4 .IX Item "https://bugzilla.redhat.com/1791240" [RFE] Make the rhv-cafile optional .IP https://bugzilla.redhat.com/1785528 4 .IX Item "https://bugzilla.redhat.com/1785528" Should remove info about "Remove VMware tools from Windows guests" in virt\-v2v\-input\-vmware man page .IP https://bugzilla.redhat.com/1746699 4 .IX Item "https://bugzilla.redhat.com/1746699" Can't import guest from export domain to data domain on rhv4.3 due to error "Invalid parameter: 'DiskType=1'" .IP https://bugzilla.redhat.com/1733168 4 .IX Item "https://bugzilla.redhat.com/1733168" virt\-v2v: Use scp \-T in \-i vmx \-it ssh mode .IP https://bugzilla.redhat.com/1723305 4 .IX Item "https://bugzilla.redhat.com/1723305" Delete info "export PATH=/path/to/nbdkit\-1.1.x:$PATH" in virt\-v2v\-input\-vmware manual page .IP https://bugzilla.redhat.com/1691659 4 .IX Item "https://bugzilla.redhat.com/1691659" virt\-v2v should show a message when qemu-guest-agent is installed in guest successfully during conversion .IP https://bugzilla.redhat.com/1690574 4 .IX Item "https://bugzilla.redhat.com/1690574" virt\-v2v fails to import a guest while cannot find `file_architecture` for a file .IP https://bugzilla.redhat.com/1680361 4 .IX Item "https://bugzilla.redhat.com/1680361" [v2v][RHV][Scale] v2v Migration to RHV failed on timed out waiting for transfer to finalize .IP https://bugzilla.redhat.com/1626503 4 .IX Item "https://bugzilla.redhat.com/1626503" Unable to maintain static IP address configuration post VM migration .IP https://bugzilla.redhat.com/1612653 4 .IX Item "https://bugzilla.redhat.com/1612653" Guest has no disk after rhv-upload converting if target data domain has similar name with other data domain on rhv4.2 .IP https://bugzilla.redhat.com/1605242 4 .IX Item "https://bugzilla.redhat.com/1605242" Update nbdkit info for vddk in v2v man page .IP https://bugzilla.redhat.com/1584678 4 .IX Item "https://bugzilla.redhat.com/1584678" On W2K12r2 rhev-apt does not run non-interactively, causing race when starting rhev-apt service from the command line .IP https://bugzilla.redhat.com/1518539 4 .IX Item "https://bugzilla.redhat.com/1518539" Macvtap network will be lost during v2v conversion .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBvirt\-v2v\fR\|(1). .PP Previous release notes covering virt\-v2v can be found in the libguestfs project: \fBguestfs\-release\-notes\-1.40\fR\|(1). .SH AUTHORS .IX Header "AUTHORS" Daniel Erez .PP Richard W.M. Jones .PP Tomáš Golembiovský .PP Martin Kletzander .PP Mike Latimer .PP Nir Soffer .PP Pino Toscano .PP Ming Xie .SH COPYRIGHT .IX Header "COPYRIGHT" Copyright (C) 2009\-2020 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.