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
- The web console user interface now supports multiple languages
-
This update introduces comprehensive multi-language translation and internationalization to the MTV web console user interface. This enhancement allows global administrators and infrastructure teams to navigate migration plans, view provider status, and manage virtual machine (VM) migrations natively in their preferred language. As a result, the console plugin automatically matches the user’s language preference configured in the Red Hat OpenShift Container Platform web console to support the following languages:
-
Spanish
-
French
-
Japanese
-
Korean
-
Simplified Chinese
-
Resolved issues
Migration Toolkit for Virtualization (MTV) 2.11 has the following resolved issues.
Resolved issues 2.12.0
Review the resolved issues in this release of MTV.
- RDM disks converted to a LUN now have the correct SCSI interface type
-
Before this update, setting
spec.rdmAsLun=truein aMigrationPlanconverted the Raw Device Mapping (RDM) disk to a logical unit number (LUN) but kept thevirtiointerface instead of changing it to Small Computer System Interface (SCSI). As a consequence, the LUN disk type was incompatible with the user interface (UI). With this release, the interface type conversion for RDM disks in aMigrationPlanis corrected. As a result, RDM disks converted to a LUN have the requiredSCSIinterface type. - VMs with multiple IPv4 addresses on a single NIC no longer lose network connectivity
-
Before this update, migrating a Red Hat Enterprise Linux (RHEL) virtual machine (VM) from VMware to OpenShift Virtualization with the Preserve static IPs option enabled caused the post-conversion script to incorrectly treat multiple IPv4 addresses on a single network interface controller (NIC) sharing the same 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, which 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 persistentudevrules, preserves original interface names, 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, which caused migration plans to fail. As a consequence, users performed unnecessary repairs. With this release, MTV adds the
feature_xfs_repair_ignoreoption to theForkliftControllercustom resource to ignore thexfs_repairexit status for XFSv5 on RHEL 7. As a result, enabling this option prevents XFSv5 from falsely reporting corrupted file systems and failing migration plans. This option is disabled by default; 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 because they used .NET methods blocked by CLM. As a consequence, MTV 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, MTV reliably configures static IP addresses, subnet masks, gateways, and Domain Name System (DNS) settings on migrated Windows VMs.
- PVCs are now cleaned up after XCOPY migration failures
-
Before this update, MTV 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, MTV automatically cleans up PVCs after a migration failure, which prevents unnecessary LUN utilization and operational issues.
- Migrations no longer fail unexpectedly due to memory issues on ESXi hosts
-
Before this update, MTV 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, MTV removes the automatic VIB installation. As a result, memory failures no longer occur during clone operations. Thevmkfstools-wrapperVIB is only needed for storage copy offload migrations. For 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, when using VMware Virtual Volume (vVol) copy offload, the volume populator pod could not find the vVol volume on Hewlett Packard Enterprise (HPE) Primera storage because of volume name differences. As a consequence, volume cloning failed with an error indicating that the volume ID could not be found. With this release, the volume populator is updated to correctly handle volume name matching for HPE Primera storage. As a result, MTV 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) from VMware ESXi to a Red Hat OpenShift Container Platform cluster caused the network interface names and static IP address settings to change. As a consequence, the migrated VMs did not retain their original network configuration. With this release, MTV updates the network configuration process 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 with insufficient default memory limits. As a consequence, the pod repeatedly terminated with out-of-memory (OOM) errors, which 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 theforklift-cli-downloadpod. As a result, the deployment successfully starts without triggering OOM errors, and the MTV infrastructure remains in a healthy state.
Known issues
Migration Toolkit for Virtualization (MTV) 2.12 has the following known issues.
- Virtual machine migrations with XFS v4 file systems no longer fail unexpectedly during conversion
-
Before this update, migrating a virtual machine (VM) with an XFS v4 file system and
xfsCompatibility: trueused a Red Hat Enterprise Linux 9virt-v2vimage that did not support thevirt_v2v_memsizeandvirt_v2v_smpparameters. As a consequence, if these parameters were set, the migration failed during the conversion phase. With this release, MTV prevents migrations that combinexfsCompatibility: truewith thevirt_v2v_memsizeorvirt_v2v_smpparameters. As a result, MTV avoids unexpected conversion failures by forbidding incompatible configurations. - Inactive migration plans incorrectly display as running
-
When the number of concurrent virtual machine (VM) migrations or migrating disks exceeds the limit set by the
max_vms_inflightparameter, MTV 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 high pod ready latency and node failures
-
When migrating from VMware to OpenShift Virtualization or deploying User Defined Networks (UDNs), creating more than 72 UDNs and their attached resources simultaneously causes heavy resource contention. Open vSwitch (OVS) becomes starved for CPU time, and there is no observable way to determine if a UDN is fully created before resources are attached. 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 deployments requiring more UDNs, create the UDNs upfront and wait for Open Virtual Network Kubernetes (OVNK) utilization to settle before deploying any resources attached to the UDNs. As a result, you maintain stable pod ready latency and prevent node failures.