.\" Automatically generated by Podwrapper::Man 1.44.2 (Pod::Simple 3.40) .\" .\" 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-1.42 1" .TH virt-v2v-release-notes-1.42 1 "2022-01-01" "virt-v2v-1.44.2" "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 .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 \&\s-1QEMU\s0 ssh driver. Similarly \fBnbdkit\-curl\-plugin\fR\|(1) is used instead of the \s-1QEMU\s0 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, \s-1QEMU\s0 Guest Agent \s-1MSI\s0 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 \s-1RHV\s0 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 \s-1ISO.\s0 .PP Multiple fixes to \s-1RHV\s0 uploads: Set \f(CW\*(C`DISKTYPE\*(C'\fR field correctly when converting to \s-1RHV\s0 and \s-1VDSM.\s0 Properly clean up on failure. Display disk \s-1ID\s0 in error messages, and log script parameters, to help with debugging. Multiple code cleanups. (Nir Soffer). .PP Support conversions to \s-1RHV\s0 in qcow2 format (Nir Soffer). .PP Fix detection of disk status and failures after conversion to \s-1RHV\s0 (Daniel Erez). .PP Cancel disk transfer and remove uploaded disks on failure of conversion to \s-1RHV\s0 (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 \s-1VDDK\s0 (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 \s-1OVF\s0 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 \s-1SUSE\s0 guests, always try to install \s-1QXL\s0 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 \s-1PEP 8 /\s0 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 \s-1EL8\s0 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" [\s-1RFE\s0] Make the rhv-cafile optional .IP "https://bugzilla.redhat.com/1785528" 4 .IX Item "https://bugzilla.redhat.com/1785528" Should remove info about \*(L"Remove VMware tools from Windows guests\*(R" 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 \*(L"Invalid parameter: 'DiskType=1'\*(R" .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 \*(L"export PATH=/path/to/nbdkit\-1.1.x:$PATH\*(R" 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][\s-1RHV\s0][Scale] v2v Migration to \s-1RHV\s0 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 \s-1IP\s0 address configuration post \s-1VM\s0 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 \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.