Review these release notes for Migration Toolkit for Virtualization (MTV) version 2.12.
Migration Toolkit for Virtualization 2.12
The release notes describe technical changes, new features and enhancements, known issues, and resolved issues.
Technical changes
Review the technical changes in this release of MTV.
New features and enhancements
Migration Toolkit for Virtualization (MTV) 2.12 introduces the following features and enhancements.
MTV 2.12.0
- MTV UI integrates Lightspeed AI
-
With this release, the MTV user interface (UI) integrates Lightspeed AI. As a virtual infrastructure administrator, you can use free-text queries to generate AI-powered results. You can use this AI integration to quickly find specific answers during complex migrations. This feature also aligns Lightspeed across the OpenShift console and the UI. As a result, you can troubleshoot migration issues more efficiently.
- MTV supports AWS EC2 as a source provider (Technology Preview)
-
With this release, MTV supports migrations from Amazon Web Services (AWS) Elastic Compute Cloud (EC2) as a Technology Preview. You can define AWS EC2 as a source provider by using the user interface (UI) or the command-line interface (CLI). To access this capability, you must enable the associated feature flag. As a result, you can migrate workloads from AWS EC2 to a Red Hat-supported environment.
- MTV supports storage copy offload for warm migrations
-
With this release, storage copy offload for warm migrations is fully supported. Before this update, this feature was available as a Technology Preview. You can use this feature to transfer data during a warm migration. As a result, you can migrate virtual machines (VMs) more efficiently.
- Deep inspection assesses VM migratability (Technology Preview)
-
With this release, a deep inspection tool assesses the migratability of virtual machines (VMs) as a Technology Preview. The tool inspects the VM file system, which is particularly useful for dual-boot VMs. The user interface (UI) displays this information so you can choose root mounts and assess VM migratability without manual planning. As a result, you reduce conversion failures and the time required to prepare a VM for migration.
- MTV UI supports adding virtual machines to existing plans
-
With this release, you can add virtual machines (VMs) to existing plans in the MTV user interface (UI). You can use this feature to dynamically scale your infrastructure. As a result, you can optimize your workloads and manage resources more efficiently.
- User interface supports configuring tolerations and nodeSelector for importer pods
-
With this release, you can configure the
tolerationsandnodeSelectorfields for importer pods in the user interface (UI). You can use this feature to customize pod placement and manage resource allocation for importer tasks. As a result, you can optimize workloads for specific infrastructure requirements. - Migration process supports custom firstboot scripts (Technology Preview)
-
With this release, the custom firstboot scripts feature is provided as a Technology Preview. Before this update, this feature was available as a Developer Preview. You can use this feature to customize the initial setup of your virtual machines (VMs). This customization eliminates the need for Secure Shell (SSH) key management. As a result, you streamline the migration process and deploy VMs more efficiently.
- MTV supports direct hook triggers within AAP (Technology Preview)
-
With this release, you can use
{project-short}to trigger hooks directly in the Ansible Automation Platform (AAP) as a Technology Preview. Before this update, you had to specify a hook inside the hook image or the hookconfigmap. These methods lacked a connection to AAP. You no longer need to specify hooks manually. As a result, you streamline the migration process and improve automation workflows. - OpenShift Virtualization migrations support PVC name templates
-
With this release, migration plans support the
pvcNameTemplatefield for OpenShift Virtualization to OpenShift Virtualization migrations. You can use this feature to customize the names of persistent volume claims (PVCs). As a result, you can match the generated PVC names to your storage naming conventions. - The web console user interface supports multiple languages
-
This update introduces comprehensive multilanguage translation and internationalization to the MTV web console user interface. With this enhancement, you can navigate migration plans, view provider status, and manage virtual machine (VM) migrations in your preferred language. As a result, the console plugin matches your language preference in the Red Hat OpenShift Container Platform web console. It supports the following languages:
-
Spanish
-
French
-
Japanese
-
Korean
-
Simplified Chinese
-
- MTV supports real-time monitoring of migration performance
-
With this release, real-time monitoring of migration performance is fully supported. Before this update, this feature was available as a Technology Preview. You can monitor network and storage throughput in real time during a migration. You can use these metrics to make informed decisions about performance tuning and configuration. As a result, you can improve the efficiency of your data migrations.
- You can map a single source network to multiple NADs
-
Currently,
kubevirtprevents mapping multiple network interface controllers (NICs) to a single network attachment definition (NAD). With this enhancement, you can map a single source network to multiple destination NADs.When the NICs are created in the target virtual machine (VM), each receives a different NAD from the mapped pool. As a result, you can successfully migrate VMs with multiple NICs on the same source network. The following example shows the
network-21source network mapped to thenad-aandnad-bdestination NADs:spec: map: - destination: name: nad-a namespace: mtv-5511-test type: multus source: id: network-21 - destination: name: nad-b namespace: mtv-5511-test type: multus source: id: network-21
Resolved issues
Migration Toolkit for Virtualization (MTV) 2.12 has the following resolved issues.
Resolved issues 2.12.0
Review the resolved issues in this release of MTV.
- Deleted migration plans no longer leave orphaned PVCs
-
Before this update, the cleanup process removed only populator pods. It left the original and prime persistent volume claims (PVCs) in the cluster. As a consequence, these orphaned PVCs remained after you archived and deleted a migration plan, so you had to manually remove them. With this release, the cleanup process is updated to handle all associated storage resources. As a result, archiving and deleting a migration plan automatically removes the original and prime PVCs. They no longer remain in the cluster.
DiskTransfericon turns into a checkmark after successful warm migrations-
Before this update, the
DiskTransfericon failed to turn into a checkmark after a successful warm migration. This issue occurred during storage copy offload migrations. As a consequence, you could not visually confirm a successful migration. With this release, the migration process correctly updates the status. As a result, the icon turns into a checkmark when a warm migration succeeds. - Empty
.spec.map.storagefields no longer show unrelated names -
Before this update, leaving the
.spec.map.storagefield empty in a migration plan YAML file caused an issue. A random storage map name appeared in the user interface (UI). As a consequence, an unrelated name incorrectly appeared for an empty storage map. With this release, the migration process correctly handles empty storage maps. As a result, unrelated storage map names no longer appear in the UI. - Network map creation supports Multus NADs across namespaces
-
Before this update, the user interface (UI) did not display certain Multus NADs in the Target network drop-down list. This issue affected Multus NADs outside the installation namespace. As a consequence, you could not create network maps between the vCenter and the host by using these NADs. With this release, the drop-down list includes Multus NADs from all namespaces. As a result, you can successfully create network maps by using these NADs.
- Archived cross-cluster migration plans no longer retain VMIMs
-
Before this update, archiving a cross-cluster live migration plan failed to remove associated virtual machine instance migrations (VMIMs). As a consequence, these VMIMs persisted after you archived and deleted a plan. This persistence caused in-flight migrations to fail. With this release, the cleanup process is updated to handle all associated resources. As a result, archiving and deleting a cross-cluster live migration plan automatically removes the associated VMIMs.
- Migration plans correctly convert RDM disks to SCSI
-
Before this update, setting
spec.rdmAsLun=truein aMigrationPlancustom resource did not convert the interface from virtio to SCSI. As a consequence, you encountered a disk interface mismatch. Logical unit number (LUN) disks retained the virtio interface instead of the required SCSI interface. With this release, settingspec.rdmAsLun=truecorrectly converts the interface type of Raw Device Mapping (RDM) disks to SCSI. As a result, RDM disks converted to LUNs have the correct interface type. - VMs with multiple IPv4 addresses on a single NIC no longer lose network connectivity
-
Before this update, a Red Hat Enterprise Linux (RHEL) virtual machine (VM) migration could fail. This occurred if the Preserve static IPs option was enabled for multiple IPv4 addresses on a single network interface controller (NIC). The post-conversion script incorrectly treated the shared Media Access Control (MAC) address as a duplicate MAC address error. As a consequence, the script generated an empty
/etc/udev/rules.d/70-persistent-net.rulesfile. This file caused the VM to lose network connectivity because NetworkManager failed to activate the profile on boot.With this release, the post-conversion script correctly parses and allows multiple IPv4 addresses assigned to a single MAC address. As a result, the migration process successfully generates persistent
udevrules and preserves original interface names. It also allows NetworkManager profiles to activate correctly and assigns all static IP addresses on the migrated VM. - XFSv5 on RHEL 7 no longer falsely reports corruption
-
Before this update, XFSv5 on Red Hat Enterprise Linux (RHEL) 7 incorrectly reported file system corruption without actual issues. This false reporting caused migration plans to fail. As a consequence, you might have performed unnecessary repairs.
With this release, a new
feature_xfs_repair_ignoreoption in theForkliftControllercustom resource (CR) ignores thexfs_repairexit status. As a result, enabling this option prevents XFSv5 from falsely reporting corrupted file systems and failing migration plans. This option is disabled by default, so you must enable it only when necessary. - PowerShell CLM no longer causes empty subnet masks in Windows VM migrations
-
Before this update, migrating Windows virtual machines (VMs) with PowerShell Constrained Language Mode (CLM) enabled caused firstboot network configuration scripts to fail. This failure occurred because the scripts used .NET methods blocked by CLM. As a consequence, the migration process wrote empty or incorrect subnet masks and network settings to the registry.
With this release, the network configuration scripts use CLM-compatible alternatives. As a result, the process reliably configures static IP addresses, subnet masks, and gateways. It also configures Domain Name System (DNS) settings on migrated Windows VMs.
- PVCs are cleaned up after XCOPY migration failures
-
Before this update, the migration process failed to clean up persistent volume claims (PVCs) after archiving a failed XCOPY migration. As a consequence, orphaned PVCs remained on the cluster, which caused logical unit number (LUN) utilization issues.
With this release, the PVC cleanup process is updated for XCOPY storage copy offload migrations. As a result, the cleanup process automatically removes PVCs after a migration failure. This prevents unnecessary LUN utilization and operational issues.
- Migrations no longer fail unexpectedly due to memory issues on ESXi hosts
-
Before this update, the migration process automatically installed a vSphere Installation Bundle (VIB) called
vmkfstools-wrapperon each clone. As a consequence, this process caused memory issues on ESXi hosts, and migrations failed.With this release, the update removes the automatic VIB installation. As a result, memory failures no longer occur during clone operations. The
vmkfstools-wrapperVIB is only needed for storage copy offload migrations. For more information about VIB installation, see Setting up storage copy offload using the VIB. - Copy offload migrations no longer fail to find vVol volumes on HPE Primera storage
-
Before this update, the volume populator pod could not find the VMware Virtual Volume (vVol) during copy offload. This failure occurred on Hewlett Packard Enterprise (HPE) Primera storage because of volume name differences. As a consequence, volume cloning failed and returned an error about a missing volume ID.
With this release, the volume populator correctly handles volume name matching for HPE Primera storage. As a result, the migration process successfully locates and clones vVol volumes during copy offload migrations.
- VM interface names and static IP settings no longer change after migration
-
Before this update, migrating a Red Hat Enterprise Linux (RHEL) 7.2 virtual machine (VM) caused network configuration changes. This issue occurred when migrating from VMware ESXi to a Red Hat OpenShift Container Platform cluster. The network interface names and static IP address settings changed. As a consequence, the migrated VMs did not retain their original network configuration.
With this release, the network configuration process is updated to preserve the source settings. As a result, interface names and static IP address settings remain unchanged after the migration.
- The forklift-cli-download pod no longer fails with OOM errors after an upgrade
-
Before this update, upgrading the MTV Operator to version 2.10.2 or 2.10.3 introduced a
forklift-cli-downloaddeployment. This deployment had insufficient default memory limits. As a consequence, the pod repeatedly terminated with out-of-memory (OOM) errors. These errors caused the Red Hat OpenShift Container Platform cluster to report the MTV infrastructure as unhealthy.With this release, the operator logic increases the default memory allocations for the
forklift-cli-downloadpod. As a result, the deployment successfully starts without triggering OOM errors, and the MTV infrastructure remains healthy.
Known issues
Migration Toolkit for Virtualization (MTV) 2.12 has the following known issues.
- VM migrations with XFS v4 file systems fail during conversion
-
Migrating a virtual machine (VM) with an XFS v4 file system uses a Red Hat Enterprise Linux 9
virt-v2vimage. This image does not support thevirt_v2v_memsizeandvirt_v2v_smpparameters. As a consequence, the migration fails during the conversion phase if you set these parameters withxfsCompatibility: true.To work around this problem, do not combine
xfsCompatibility: truewith thevirt_v2v_memsizeorvirt_v2v_smpparameters. As a result, you avoid unexpected conversion failures. - Inactive migration plans incorrectly display as running
-
The
max_vms_inflightparameter sets a limit for concurrent virtual machine (VM) migrations or migrating disks. When migrations exceed this limit, the migration process queues the excess migration plans. As a consequence, the user interface (UI) incorrectly displays the status of these inactive, queued plans as "Running".No known workaround exists.
- Deploying many User Defined Networks simultaneously causes node failures
-
Migrating from VMware to OpenShift Virtualization or deploying User Defined Networks (UDNs) can cause heavy resource contention. This contention occurs if you create more than 72 UDNs and their attached resources simultaneously. Open vSwitch (OVS) becomes starved for CPU time. Additionally, there is no way to determine if a UDN is fully created before attaching resources. As a consequence, high pod ready latency occurs, and nodes might enter a
NotReadystate.To work around this problem, limit simultaneous UDN creation to 72 or fewer. For larger deployments, create the UDNs upfront. Wait for Open Virtual Network Kubernetes (OVNK) utilization to settle before you deploy attached resources. As a result, you maintain stable pod ready latency and prevent node failures.
- Warm migrations of NBDE VMs fail during preflight inspection
-
A warm migration of a Network-Bound Disk Encryption (NBDE) virtual machine (VM) uses a DI pod. This pod cannot connect to the Tang server. As a consequence, the preflight inspection fails, and the migration plan fails.
To work around this problem, disable the preflight inspection step by adding
runPreflightInspection: falseto the migration planspec:spec: ... runPreflightInspection: false ...As a result, the migration proceeds without the preflight inspection. Potential issues in the plan might not be caught before execution.