Chapter 1. Migration Toolkit for Virtualization 2.7
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)