Search

Chapter 1. Migration Toolkit for Virtualization 2.7

download PDF

You can use the Migration Toolkit for Virtualization (MTV) to migrate virtual machines from the following source providers to OpenShift Virtualization destination providers:

  • VMware vSphere versions 6, 7, and 8
  • Red Hat Virtualization (RHV)
  • OpenStack
  • Open Virtual Appliances (OVAs) that were created by VMware vSphere
  • Remote OpenShift Virtualization clusters

The release notes describe technical changes, new features and enhancements, known issues, and resolved issues.

1.1. Technical changes

Migration Toolkit for Virtualization (MTV) 2.7 has the following technical changes:

Upgraded virt-v2v to RHEL9 for warm migrations

MTV previously used virt-v2v from Red Hat Enterprise Linux (RHEL) 8, which does not include bug fixes and features that are available in virt-v2v in RHEL9. In MTV 2.7.0, components are updated to RHEL 9 in order to improve the functionality of warm migration. (MTV-1152)

1.2. New features and enhancements

Migration Toolkit for Virtualization (MTV) 2.7 introduces the following features and enhancements:

1.2.1. New features and enhancements 2.7.0

  • In MTV 2.7.0, warm migration is now based on RHEL 9 inheriting features and bug fixes.

1.3. Resolved issues

Migration Toolkit for Virtualization (MTV) 2.7 has the following resolved issues:

1.3.1. Resolved issues 2.7.2

VMNetworksNotMapped error occurs after creating a plan from the UI with the source provider set to OpenShift Virtualization

In earlier releases of MTV, after creating a plan with an OpenShift Virtualization source provider, the Migration Plan failed with the error The plan is not ready - VMNetworksNotMapped. This issue has been resolved in MTV 2.7.2. (MTV-1201)

Migration Plan for OpenShift Virtualization to OpenShift Virtualization missing the source namespace causing VMNetworkNotMapped error

In earlier releases of MTV, when creating a Migration Plan for an OpenShift Virtualization to OpenShift Virtualization migration using the Plan Creation Form, the network map generated was missing the source namespace, which caused a VMNetworkNotMapped error on the plan. This issue has been resolved in MTV 2.7.2. (MTV-1297)

DV, PVC, and PV are not cleaned up and removed if the migration plan is Archived and Deleted

In earlier releases of MTV, the DataVolume (DV), PersistentVolumeClaim (PVC), and PersistentVolume (PV) continued to exist after the migration plan was archived and deleted. This issue has been resolved in MTV 2.7.2. (MTV-1477)

Other migrations are halted from starting as the scheduler is waiting for the complete VM to get transferred

In earlier releases of MTV, when warm migrating a virtual machine (VM) that has several disks, you had to wait for the complete VM to get migrated, and the scheduler was halted until all the disks finished before the migration would be started. This issue has been resolved in MTV 2.7.2. (MTV-1537)

Warm migration is not functioning as expected

In earlier releases of MTV, warm migration did not function as expected. When running the warm migration with VMs larger than the MaxInFlight disks, the VMs over this number did not start the migration until the cutover. This issue has been resolved in MTV 2.7.2. (MTV-1543)

Migration hanging due to error: virt-v2v: error: -i libvirt: expecting a libvirt guest name

In earlier releases of MTV, when attempting to migrate a VMware VM with a non-compliant Kubernetes name, the Openshift console returned a warning that the VM would be renamed. However, after starting the Migration Plan, it hangs since the migration pod is in an Error state. This issue has been resolved in MTV 2.7.2. This issue has been resolved in MTV 2.7.2. (MTV-1555)

VMs are not migrated if they have more disks than MAX_VM_INFLIGHT

In earlier releases of MTV, when migrating the VM using the warm migration, if there were more disks than the MAX_VM_INFLIGHT the VM was not scheduled and the migration was not started. This issue has been resolved in MTV 2.7.2. (MTV-1573)

Migration Plan returns an error even when Changed Block Tracking (CBT) is enabled

In earlier releases of MTV, when running a VM in VMware, if the CBT flag was enabled while the VM was running by adding both ctkEnabled=TRUE and scsi0:0.ctkEnabled=TRUE parameters, an error message Danger alert:The plan is not ready - VMMissingChangedBlockTracking was returned, and the migration plan was prevented from working. This issue has been resolved in MTV 2.7.2. (MTV-1576)

1.3.2. Resolved issues 2.7.0

Change . to - in the names of VMs that are migrated

In earlier releases of MTV, if the name of the virtual machines (VMs) contained ., this was changed to - when they were migrated. This issue has been resolved in MTV 2.7.0. (MTV-1292)

Status condition indicating a failed mapping resource of a plan is not added to the plan

In earlier releases of MTV, a status condition indicating a failed mapping resource of a plan was not added to the plan. This issue has been resolved in MTV 2.7.0, with a status condition indicating the failed mapping being added. (MTV-1461)

ifcfg files with HWaddr cause the NIC name to change

In earlier releases of MTV, interface configuration (ifcfg) files with a hardware address (HWaddr) of the Ethernet interface caused the name of the network interface controller (NIC) to change. This issue has been resolved in MTV 2.7.0. (MTV-1463)

Import fails with special characters in VMX file

In earlier releases of MTV, imports failed when there were special characters in the parameters of the VMX file. This issue has been resolved in MTV 2.7.0. (MTV-1472)

Observed invalid memory address or nil pointer dereference panic

In earlier releases of MTV, an invalid memory address or nil pointer dereference panic was observed, which was caused by a refactor and could be triggered when there was a problem with the inventory pod. This issue has been resolved in MTV 2.7.0. (MTV-1482)

Static IPv4 changed after warm migrating win2022/2019 VMs

In earlier releases of MTV, the static Internet Protocol version 4 (IPv4) address was changed after a warm migration of Windows Server 2022 and Windows Server 2019 VMs. This issue has been resolved in MTV 2.7.0. (MTV-1491)

Warm migration is missing arguments

In earlier releases of MTV, virt-v2v-in-place for the warm migration was missing arguments that were available in virt-v2v for the cold migration. This issue has been resolved in MTV 2.7.0. (MTV-1495)

Default gateway settings changed after migrating Windows Server 2022 VMs with preserve static IPs

In earlier releases of MTV, the default gateway settings were changed after migrating Windows Server 2022 VMs with the preserve static IPs setting. This issue has been resolved in MTV 2.7.0. (MTV-1497)

1.4. Known issues

Migration Toolkit for Virtualization (MTV) 2.7 has the following known issues:

Select Migration Network from the endpoint type ESXi displays multiple incorrect networks

When you choose Select Migration Network, from the endpoint type of ESXi, multiple incorrect networks are displayed. (MTV-1291)

VMs with Secure Boot enabled might not be migrated automatically

Virtual machines (VMs) with Secure Boot enabled currently might not be migrated automatically. This is because Secure Boot, a security standard developed by members of the PC industry to ensure that a device boots using only software that is trusted by the Original Equipment Manufacturer (OEM), would prevent the VMs from booting on the destination provider. 

Workaround: The current workaround is to disable Secure Boot on the destination. For more details, see Disabling Secure Boot. (MTV-1548)

Network and Storage maps in the UI are not correct when created from the command line

When creating Network and Storage maps from the UI, the correct names are not shown in the UI. (MTV-1421)

Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.