Forklift 2.11
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 Forklift.
- Storage copy offload for Infinidat Infinibox (Developer Preview)
-
Forklift provides storage copy offload for Infinidat Infinibox for both cold and warm migrations as a Developer Preview.
Storage copy offload for Infinidat Infinibox is Developer Preview software only. Developer Preview software is not supported by Red Hat in any way and is not functionally complete or production-ready. Do not use Developer Preview software for production or business-critical workloads. Developer Preview software provides early access to upcoming product software in advance of its possible inclusion in a Red Hat product offering. Customers can use this software to test functionality and provide feedback during the development process. This software might not have any documentation, is subject to change or removal at any time, and has received limited testing. Red Hat might provide ways to submit feedback on Developer Preview software without an associated SLA.
For more information about the support scope of Red Hat Developer Preview software, see Developer Preview Support Scope.
New features and enhancements
Forklift 2.11 introduces the following features and enhancements.
- You can configure a custom
ServiceAccountobject for all MTV pods -
You can configure a custom
ServiceAccountobject for all Forklift pods, including CDI pods. This enhancement supports migrating workloads that are run under specific service accounts with well-defined RBAC roles. As a result, feature Forklift can access storage backends, pull secrets, or perform API calls that require a dedicatedServiceAccountobject with specific permissions. - You can define which VMs in a plan are attached to a shared disk
-
In a single migration plan, you can define which VMs share a disk. This enhancement eliminates the need to create two migration plans when migrating shared disks: one where all VMs share a disk and another where none do. This option lets you streamline the process for migrating shared disks.
- Storage copy offload: You can map RDM disks as LUN devices
-
Storage copy offload migrations support mapping Raw Device Mapping (RDM) disks as either Logical Unit Number (LUN) disks or regular disks. This enhancement lets you specify that RDM disks are to be attached as LUN disks in a storage copy offload migration.
- Volume-to-volume copy now supported for HPE Primera and HPE 3PAR, enabling storage copy offload migrations for these storage providers
-
Forklift 2.11.2 supports volume-to-volume copy operations for storage copy offload migrations on HPE Primera and HPE 3PAR arrays. These operations copy the underlying VMware Raw Device Mapping (RDM) or VMware vSphere Virtual Volumes (vVols) volume onto the target volume that the CSI driver creates. This improvement allows storage copy offload migrations for HPE Primera or HPE 3PAR storage providers.
Storage copy offload for HPE Primera and HPE 3PAR, for both cold and warm migrations, is Developer Preview software only. Developer Preview software is not supported by Red Hat in any way and is not functionally complete or production-ready. Do not use Developer Preview software for production or business-critical workloads. This feature provides early access to upcoming product software in advance of its possible inclusion in a Red Hat product offering. For more information about the support scope of Red Hat Developer Preview software, see Developer Preview Support Scope.
- Controlling nested virtualization in migrations
-
In Forklift 2.11.1, you can control nested virtualization behavior during migration with the new
enableNestedVirtualizationoption. This option accepts three values:-
Not set (default): Nested virtualization is automatically detected from the source VM and preserved on the target.
-
true: Force enables nested virtualization on the target VM, regardless of source settings. -
false: Force disables nested virtualization on the target VM, regardless of source settings.This option gives you the flexibility to mitigate performance issues stemming from Virtualization Based Security (VBS) activation.
By disabling VBS on target VMs during the migration of Windows VMs that do not need nested virtualization, you can avoid potential performance degradation, resulting in a more streamlined and efficient migration process.
After you migrate your VMs to KubeVirt, you can re-enable VBS by running the following YAML:
apiVersion: kubevirt.io/v1 kind: VirtualMachine metadata: name: <vm_name> spec: template: spec: domain: cpu: features: - name: vmx policy: optional - name: svm policy: optional
-
- Direct OVA import from local machines to KubeVirt in Forklift UI
-
Previously, this feature was available as Technology Preview. In Forklift 2.11.1, you can import Open Virtual Appliances (OVAs) directly from local machines to KubeVirt by uploading the OVAs to NFS through the web browser in the Forklift UI.
- Customizable service account for pre-plan and post-plan hooks in Create migration plan pages
-
In Forklift 2.11.0, users can set a service account name for pre-plan and post-plan hooks in the Create migration plan pages. This UI setting allows for greater flexibility and control over the service accounts used in these hooks, ensuring they have the necessary permissions to manage cluster resources. The
Service accountfield is a free text field as the service account information is not stored in the inventory for a remote cluster. This enhancement improves the overall security and customization of the user’s deployment. - Enhanced pre-migration issue visibility
-
Forklift 2.11.0 enhances the visibility of pre-migration concerns for individual VMs, providing a clear taxonomy and visual indicators to distinguish between critical issues, VM-specific failures, and ignorable warnings. The updated UI includes new icons, colors, and labels for quick comprehension of validation issue severity. The
Conditionscolumn of the VM table now displays all current concerns impacting the plan, with filters for Name, Severity, Type, and Folder. A total of critical alerts is displayed at the top of the page, with aView all alertsbutton for detailed analysis. This improvement increases the clarity and understanding of pre-migration concerns, simplifying the migration process. - Enhanced learning experience in Forklift UI
-
With this update, the
Tips and trickssection in the Forklift UI is significantly expanded, offering curated learning paths and improved user guidance. This enhancement simplifies complex workflow steps, integrates with Red Hat KubeVirt LightSpeed AI for dynamic guidance, and reorganizes content for a better learning process for Forklift administrators. - Technology Preview: Performance metrics during migration
-
With this update, Forklift provides performance metrics during migration, including network and storage throughput. This enhancement aims to assist users in making informed decisions about system configuration for better performance tuning. Real-time insights into these metrics during migration plans are now available in the Forklift UI.
- Add descriptive notes to migration plans
-
In Forklift 2.11.0, cluster administrators can now add descriptive notes to their migration plans during creation. The new
Descriptionfield allows easy differentiation and management of various plans within the web console. Users can identify the purpose, scope, and owner of each plan by adding reasons for each migration in the Description field. The added context is visible in the plan table and Plan details page for long-term management and auditing purposes. - Unified interaction model for form editing
-
Forklift 2.11.0 introduces a unified, consistent interaction model for editing forms and fields across the Forklift web console, streamlining tasks for cluster administrators. The new design includes an edit button that opens a modal for inputs, promoting clarity and reducing configuration errors. This update aims to reduce cognitive load and eliminate varying UI behaviors on different pages, making administrative tasks easier and quicker.
- Enhanced Create provider form for source providers
-
In Forklift 2.11.0, the Create provider form in the Forklift UI has unique authentication and validation fields for source providers such as OKD, OpenStack, oVirt (oVirt), and VMware vSphere. The new form provides a cleaner and more user-friendly experience when creating providers, making it easier for cluster administrators to create plans for migrating their VMs.
- Validation alert for VDDK for VMware warm migrations
-
Forklift 2.11.0 introduces visible validation checks for warm migration from VMware environments in the web console. Users are alerted if the VMware vSphere Virtual Disk Development Kit (VDDK) is missing or incorrectly configured, preventing silent failures and saving time on migration plans. Updated Forklift documentation provides guidance on VDDK installation.
- Improved data migration error handling and diagnostics
-
Forklift 2.11.0 enhances data integrity during VM migration by using features introduced in RHEL 10.1. This release introduces filesystem-level consistency checks, improved system error handling, and internal diagnostics. Warm migration and features like storage offload minimize downtime with efficient disk migration and data transfer.
- Storage Offload Copy
-
In Forklift 2.11.0, the Storage Offload Copy feature accelerates disk transfer in the storage array by bypassing the network, enabling snapshot creation and base disk copying. Storage Offload Copy results in reduced network usage, improved overall performance, and enhanced migration efficiency.
-
Technology Preview: Storage Offload Copy for warm migration enables snapshot creation and base disk copying while the VM is running. Delta changes can be copied over the network post-base disk storage offload copy, reducing the need for VM shutdowns.
-
Storage Offload Copy for cold migration is generally available.
-
- Native alerting with OKD monitoring stack
-
Forklift 2.11.0 introduces native alerting, integrating with OKD’s Prometheus-based monitoring stack. Administrators now receive notifications for migration plan failures or critical issues, reducing manual monitoring. Users can configure alerts for email, Slack, or PagerDuty, ensuring timely notifications and minimizing downtime.
- Developer Preview: Pre-migration test for dual-boot VMs
-
Forklift introduces a more accurate conversion assessment before migration by fetching additional information from guest machines. With this enhancement, users can perform a pre-migration check for dual-boot VMs, ensuring a successful conversion before the migration process begins.
- Developer Preview: Importing VMs from Amazon EC2
-
With this update, users can import VMs directly from Amazon EC2, streamlining the process and expanding the platform’s compatibility. This enhancement supports cold migration to ROSA, with storage mapping limited to the same storage. It does not currently support targeting non-ROSA, different accounts, different regions, warm or live migrations.
- Developer Preview: Customizable firstboot scripts for VM migrations
-
Forklift 2.11.0 introduces customizable firstboot scripts for VM migrations, enhancing deployment flexibility and personalization. Users can now specify these scripts in their migration plans for per-plan customization. Scripts are executed by
virt-customizeduring the guest conversion process, eliminating the need for SSH keys for VM migration and integratingvirt-customizefor script injection during VM conversion and startup. - Enhanced network assignment for Forklift Controller pods
-
In Forklift 2.11.0, the assignment of a secondary network to Forklift Controller pods is now supported, similar to Importer and Populator pods. This update addresses connectivity issues with the OKD default node network and VMware or oVirt providers, reducing the need for cluster-wide changes. The existing CRD flag is reused for network assignment, simplifying setup for network configuration and communication between the Forklift Controller and external providers.
- Direct default gateway configuration in Network Attachment Definition
-
In Forklift 2.11.0, migration admins can set the default gateway directly in the Network Attachment Definition (NAD) configuration. In cases where the default route annotation is not set, the software now attempts to fetch the default gateway from the NAD configuration.
- Technology Preview: Customizing ephemeral storage for improved migration stability
-
In Forklift 2.11.0, you can customize ephemeral storage during migration, preventing failures due to insufficient node storage in large-scale migrations, Open Virtualization Format (OVA) imports, and nodes with limited storage. Users can define a
storageClassfor temporary storage, enablingvirt-v2vpods to mount a temporary Persistent Volume Claim (PVC) on the definedstorageClass, improving migration stability and success. This update reduces the likelihood of migration failures caused by limited node storage. - OS-specific VM configuration for improved performance
-
With this update, Forklift detects the operating system that VMs are running on automatically. This enhancement optimizes VM performance in Forklift and reduces the need for manual adjustments, saving time and reducing potential errors.
- Enhanced IP preservation in VM migration
-
In Forklift 2.11.0, IP preservation for VM migration now verifies that IPs are from the correct subnet before assignment. Forklift preserves and assigns IPs from the subnet for VMs with explicitly assigned IPs during migration to KubeVirt, ensuring accurate IP assignment and preventing IP mismatches during migration.
- Updated virtio-win drivers for improved migration stability
-
The
virtio-winpackage, which provides drivers for Microsoft Windows virtual machines, is rebased to version 1.9.57. With this update, virtual machine migrations are more stable and include security updates. This update also resolves rare instances of stop errors that occurred during migrations.
Resolved issues
Forklift 2.11 has the following resolved issues.
Resolved issues 2.11.4
Review the resolved issues in this release of Forklift.
- Skipping
fstrimstage improves migration times forxfsCompatibilityon RHEL 9 -
Before this update, virtual machine migrations with the
xfsCompatibilityparameter enabled to RHEL 9-based platforms encountered issues because the--no-fstrimoption was incorrectly applied to the migration process. With this release, the--no-fstrimoption is removed for these migrations. As a result, migrations based on RHEL 9 platforms run correctly.
Resolved issues 2.11.3
Review the resolved issues in this release of Forklift.
- Storage copy offload: Unclear error message for PowerMax migrations replaced
-
Before this update, if an ESXi host’s Fibre Channel or iSCSI initiators were not registered as a host object in Dell PowerMax during a storage copy offload migration, the migration proceeded with an empty
hostIDvalue. As a consequence, the system displayed an unclearCreateMaskingViewerror message.With this update, the system validates the initiator registration. As a result, if the initiators are not registered, the system displays the following message to help you resolve the problem:
Can't find a host on Symmetrix %s with initiators matching %v. Ensure the ESXi host has a corresponding host object in PowerMax with the correct FC/iSCSI initiators registered. - Storage copy offload: Pure Storage FlashArray HTTP client timeout is configurable
-
Before this update, the timeout for a Pure Storage FlashArray HTTP client was hard-coded to 30 seconds. As a consequence, during migrations of VMs with many disks, simultaneous
CopyVolumerequests to the Pure Storage FlashArray timed out, leaving PVCs stuck inPendingstatus.With this update, you can configure the timeout by setting the new
STORAGE_HTTP_TIMEOUT_SECONDSkey and value in the Pure Storage FlashArraySecret. As a result, migrations complete successfully without timing out. Note that the key’s default value is 30 seconds. - The
fstrimstage ofvirt-v2vis now skipped for warm migrations -
Before this update, large (multi-terabyte) warm migrations took a long time during the
fstrimstage ofvirt-v2v.With this update, Forklift uses the
--no-fstrimoption forvirt-v2v. As a result, large warm migrations run correctly. The converted guest might use more space after the conversion.
Resolved issues 2.11.1
Review the resolved issues in this release of Forklift.
- VM migration prevented with duplicate NAD mappings
-
Before this update, VM migration succeeded when two Network Interface Controllers (NICs) were connected to the same Network Attachment Definition (NAD). As a consequence, users could not boot the VM after successful migration because both NICs were connected to the same target NAD. This update prevents the assignment of multiple NICs to the same NAD during VM migration, avoiding potential boot failures and failed migrations.
- Misleading
ConnectionTestFailederrors for OVA providers now hidden -
Before this update, misleading
ConnectionTestFailederror messages were displayed for Open Virtual Appliance (OVA) providers during creation, due to an issue with the readiness probe in the OVA provider’s pod specification. This update hides misleadingConnectionTestFailederror messages, allowing for accurate progress visualization during provider creation. - Forklift-controller no longer unexpectedly shuts down due to map deletion
-
Before this update, the deletion of network or storage maps in the
forklift-controllercould cause unexpected shutdowns. With this update, deletion of these maps now results in migration plans moving to aNotReadystate, as opposed to actively terminating associated pods. - Increased memory limits for
forklift-cli-downloadpod to preventOOMKillederrors -
Before this update, insufficient memory limits in the
forklift-cli-downloadpod caused KubernetesOOMKilledmemory errors after an update of the Forklift Operator. As a result, the pod enteredCrashLoopBackOffstate. This update increases memory limits for theforklift-cli-downloadpod to preventOOMKillederrors, improving deployment stability. - NetApp ONTAP initiator group filtering for XCOPY consistency
-
Before this update, VM migrations on ESXi hosts with both FC and iSCSI adapters could experience issues with XCOPY usage because NetApp ONTAP initiator groups contained both FC and iSCSI initiators. With this update, you can filter initiators in ONTAP initiator groups by protocol for XCOPY consistency.
- Correct LUN path detection during copy offload for PVCs with economy storage class
-
Before this update, copy offload for Persistent Volume Claims (PVCs) that use the
ontap-san-economystorage class assumed all PVCs used dedicated FlexVols with a specific LUN path. With this update, Forklift detects the economy storage class and extracts the correct LUN path from the PV attributes, ensuring copy offload functionality. - Shared PVCs now labeled
Shareable: truein storage offload migrations -
Before this update, shared PersistentVolumeClaims (PVCs) were not labeled
Shareable: trueduring migration with storage offload. As a consequence, shareable disks were not automatically attached to VMs. With this release, shared PVCs have theShareable: truelabel, and shared disks are correctly attached to VMs. - SATA CD-ROM disks skipped during warm migration
-
Before this update, warm migration with SATA CD-ROM and SATA disks failed because of incorrect disk assignment. With this release, the SATA CD-ROM disks are intentionally skipped during warm migration because these disks are not migrated, resulting in successful conversion.
- Consistent disk order in multi-boot VMs
-
Before this update, there were disk order inconsistencies in the
virt-v2v-inspectorbecause of a conflict in howlibvirtand VMware order the disks. As a consequence, users experienced unpredictable boot failures during VM conversion. With this release, thevirt-v2v-inspectorpresents disks in a consistent order, reducing conversion failures in multi-boot VMs. - XFSv4 migrations failed
-
Forklift 2.11.0 was rebased to Red Hat Enterprise Linux (RHEL) 10, which does not support XFS version 4 (XFSv4). As a result, a new
spec.xfsCompatibilityoption is available on the migration plan. When set tofalse, the default setting, the plan uses the standard conversion image. When set totrue, the plan uses the XFS-compatible conversion image instead of the standard conversion image.If you enable XFS support for a migration plan, then the plan cannot support Btrfs migration.
- Active blocking of migration when target namespaces lack transfer network permissions
-
Before this update, during VM migration to Red Hat OpenShift Container Platform (OCP) with Fibre Channel, migration could stall when target namespaces lacked permission to transfer networks. This update enhances error handling with active blocking of migration when target namespaces lack transfer network permissions.
Resolved issues 2.11.0
Review the resolved issues in this release of Forklift.
- Target cluster namespaces now visible for cross-cluster live migration
-
Before this update, during cross-cluster live migration, projects were fetched from the host cluster instead of the target cluster. As a consequence, target cluster namespaces were not visible in the UI, causing user inconvenience. With this release, cross-cluster live migration fetches project data from the target cluster, making target cluster namespaces visible in the UI during migration.
- VDDK image archive upload succeeds in private namespaces
-
Before this update, VMware Virtual Disk Development Kit (VDDK) image archive upload failure occurred in private namespaces due to incorrect namespace usage. As a consequence, users experienced VDDK image upload failure in private namespaces during source provider creation. With this release, you can upload VDDK tar archives successfully in private namespaces.
- Correct UI display of migration type after change
-
Before this update, if you changed the
Migration typeon thePlan detailspage in the Forklift UI from warm to cold, the YAML file was updated correctly but the UI did not display the updated migration type. With this release, the UI edit field forMigration typeupdates the migration type in the YAML file and the UI correctly displays the updated migration type. - Correct VM name display in migration progress
-
Before this update, during the migration of a VM with a non-conformant name in OKD, the name was standardized. However, the migration progress in the Forklift UI showed the original non-conformant VM name. As a consequence, users saw incorrect VM names in the
Migration progresslist, with links causing404errors. With this release, the migration progress now shows accurate VM names and links. - Resolved
Unable to retrieve dataerror in cold migration plans with static IP preservation -
Before this update, users encountered an
Unable to retrieve dataerror during VM listing in cold migration plans created with static IP preservation on vCenter7. With this release, cold migration plans now retrieve VM data correctly, eliminatingUnable to retrieve dataerrors. - Improved
DiskTransferwarm migration progress indicator -
Before this update, the warm migration progress indicator for
DiskTransferremained unchecked due to incomplete progress evaluation. As a consequence, users saw incomplete migration progress for theDiskTransferstep. With this release, theDiskTransferprogress indicator shows a checkmark when all tasks are completed, improving migration visibility. - Fetch and populate volumes for storage mappings during plan creation for OKD provider
-
Before this update, you could not fetch and populate volumes for storage mappings from OKD during plan creation for an OKD provider. With this release, plan creation for host-to-host plans includes fetching and populating source storage, improving the selection of storage mappings during plan creation.
- Improved cluster-to-cluster live migration network mapping in OKD
-
Before this update, incorrect management of network attachments in OKD target networks during updates led to complications with network mapping during live migration, resulting in inaccurate network configurations. With this release, the target network mapping issue in Forklift for an OKD source provider is resolved. As a result, cluster-to-cluster live migration now correctly maps networks, improving migration accuracy.
- Removed misleading VM shutdown message during migrations for OVA providers
-
Before this update, users received a misleading message about VM shutdown during Open Virtual Appliance (OVA) migration, even though no VMs are sourced for OVA providers. With this release, the incorrect message for OVA providers during plan migration is removed.
- Adjusted
Tips and trickslink placement to avoid conflict with reserved UI elements -
Before this update, the
Tips and trickslink placement in the upper-right corner of the Forklift UI conflicted with reserved UI elements. As a consequence, UI elements were misaligned, causing content shift and potential confusion. With this release, theTips and trickslink is displayed to the left side of the reserved UI element. As a result, the UI now has improved consistency. - Topic selector consistency improvement
-
Before this update, the topic selector in the
Tips and trickspanel in the Forklift UI displayed the active topic while it was pointing to the active topic. As a consequence, end users saw duplicate topic headings in the topic selector and the top area of theTips and trickspanel. With this release, the topic selector defaults toNo topic selected, enhancing the overall UI consistency. - Improved Migration plan page visibility for target projects
-
Before this update, the
Migration planpage in the Forklift UI displayed theopenshift-mtvproject by default, but the target project was not displayed by default. With this update, the default view of theMigration planpage now includes theTarget projectcolumn, enhancing visibility and navigation for migration plans. - Restoration of
Target namecolumn on Virtual machines tab -
Before this update, the removal of the
Target namecolumn during Forklift product updates caused the column to disappear from theVirtual machinestab on thePlan detailspage in the Forklift UI. With this release, theTarget namecolumn on theVirtual machinestab is now restored. - Removal of invalid NADs during network map creation
-
Before this update, the Forklift UI became unresponsive when trying to remove an invalid Network Attachment Definition (NAD) during network map creation from YAML. With this release, you can remove network maps with invalid NAD IDs and manage network maps more effectively.
- Write permission check for OVA upload
-
Before this update, users encountered permission denied errors during OVA file upload. With this release, there is a check for write permissions before OVA upload. As a result, OVA uploads no longer fail due to permission errors.
- Warm migration with insecure TLS in oVirt provider
-
Before this update, warm migrations with a oVirt provider failed due to missing support for insecure TLS. As a consequence, warm migration failed with TLS insecure (skip cert validation) in Forklift 2.8.5. With this release,
InsecureSkipVerifyis added to CDI for warm migrations with a oVirt provider. As a result, warm migration with TLS insecure (skip cert validation) now succeeds. - Improved VDDK connection processing for warm migrations from VMware vSphere
-
Before this update, warm migrations from VMware vSphere intermittently failed during the
Disk transferphase with a VDDK connection error. With this release, VDDK connection processing is improved, with warm migrations from VMware vSphere now completing successfully during the disk transfer phase. - Improved network interface detection for legacy RHEL 5 32-bit VMs in VMware migration
-
Before this update, Forklift did not recognize the
VirtualPCNet32network type in VMware during migration. As a consequence, legacy RHEL 5 32-bit VMs were migrated without network interfaces, causing connectivity issues for users. With this release, Forklift supportsVirtualPCNet32NICs and detects 32-bit RHEL5 VMs with theVirtualPCNet32network type, enhancing network interface visibility during migration. - NVMe disk support for VMware vSphere VM migration validation
-
Before this update, NVMe disk support was missing for VMware vSphere VM migration, meaning NVMe migration could be successful but not validated. With this update, NVMe disk support is added for successful NVMe migration and validation from VMware vSphere.
- VM migration stability with multiple interfaces in pod networks
-
Before this update, VM migration failure occurred when multiple interfaces were connected to a pod network in KubeVirt. With this release, Forklift now supports multiple interfaces per VM.
- Elimination of orphaned PVCs in OVA migrations
-
Before this update, OVA migration left orphaned
ova-store-pvc-*PVCs on target clusters, consuming resources. As a consequence, excess OVA-store PVCs could cause potential resource exhaustion for users. With this update, OVA migration no longer leaves leftover PVCs on target clusters, improving resource utilization and reducing potential data loss. - Changes in device identification during OVA to OKD migration
-
Before this update, the migration of VMs with DHCP settings from an OVA provider to an OKD cluster resulted in the loss of interface settings in the VM YAML file, causing only one default interface with a pod network to remain in the VM. As a consequence, users experienced VMs with incorrect interface settings after migration. The issue occurred because the OVA scanner identified NICs and other device types based on the display name, which was unreliable. With this update, device identification is based on the resource type provided in the OVF specification, preserving interface settings during migration and preventing incorrect configurations.
Known issues
Forklift 2.11 has the following known issues.
- VMware migrations fail when the disk count exceeds the ESXi host LUN ID limit
-
VMware migrations with many disks fail if the disk count exceeds the host limit for discoverable SCSI LUN IDs.
Workaround: Increase the
Disk.MaxLUNvalue on each ESXi host to support discovery of a higher number of LUN IDs during migrations. - Live migration support limit in custom namespaces with host providers
-
Host providers in custom namespaces operate with restricted permissions that prevent Forklift from accessing resources for live migration support, for example, verifying a feature gate is enabled or synchronizing certificates between namespaces. As a result, live migration currently has limited supported in custom namespaces with host providers.
Workaround: Use the default host provider or create a provider with an appropriate access token.
- Forklift console plugin fails to load on IPv6-only OKD clusters
-
When Forklift 2.9.1 is deployed on an IPv6-only OKD cluster, an incorrect API endpoint prevents the forklift-console-plugin from serving a valid plugin manifest, displaying the error
Failed to get a valid plugin manifest from /api/plugins/forklift-console-plugins/. While the forklift-ui-plugin pod runs successfully, the console plugin cannot load, preventing access to the Forklift user interface in the OKD web console. This issue affects all IPv6-only cluster deployments with OKD 4.19.7 and CNV 4.19.1.Workaround: Deploy Forklift on dual-stack or IPv4 clusters until this issue is resolved.
- Incorrect labeling of inactive migration plans
-
Inactive migration plans are incorrectly labeled as
Runningwhenmax_vms_inflightexceeds the total number of disks per migration. This label leads to confusion about the actual state of the plans, as all migration plans appear to beRunningin the user interface.Workaround: Currently, there is no workaround for this issue.
- Migration between OKD namespaces causes MAC address collisions
-
During migration between OKD namespaces in a cluster, MAC address collisions result in VM creation failure.
Workaround: Disable the KubeMacPool. For more information, see Managing KubeMacPool by using the CLI in the OKD documentation.
- VMware vSphere 6 or 7 migration fails on FIPS-enabled clusters
-
In Forklift 2.11.0, an update to Golang 1.25 causes a connection failure on FIPS-enabled clusters with VMware vSphere 6 or 7, due to unsupported TLS 1.2 with Extended Master Secret. As a consequence, users cannot migrate VMware vSphere 6 or 7 VMs to a FIPS-compliant cluster.
Workaround: Disable FIPS mode on the cluster or use a VMware vSphere version that supports TLS 1.2 with Extended Master Secret to migrate VMs.
- Second migration plan with shared RDM disks fails when shared disk migration is disabled
-
When migrating two VMs with shared RDM disks using copyoffload in separate migration plans, the second migration plan fails at the
ImageConversionstep if shared disk migration is disabled. After successfully migrating the first VM with shared disk migration enabled, creating a second migration plan with shared disk migration disabled incorrectly creates two populate pods—one for the OS disk and one for the shared RDM disk—instead of creating only the OS disk populate pod. This causes the second migration to fail.Workaround: Currently, there is no workaround for this issue.
- VDDK image only in
openshift-mtvnamespace -
When you upload a VMware Virtual Disk Development Kit (VDDK) init image, the image URL is located in the
openshift-mtvnamespace. If you create a provider in a different namespace, there is an error when pulling the image. - Fibre Channel (FC) protocol VM migration fails to identify existing FC host objects in Infinibox
-
Fibre Channel (FC) protocol VM migration fails to identify existing FC host objects in Infinibox due to incorrect adapter ID comparison. As a consequence, FC protocol VM migration fails to identify existing FC hosts, causing volume creation failure due to incorrect
port_name.Workaround: Currently, there is no workaround for this issue.