1. Documentation
×

Enabling cross-cluster live migration for virtual machines

Cross-cluster live migration enables users to move a virtual machine (VM) workload from one OKD cluster to another cluster without disruption.

Prerequisites

  • OpenShift Virtualization 4.20 or later must be installed.

  • The OKD and OpenShift Virtualization minor release versions must match. For example, if the OKD version is 4.20.0, the OpenShift Virtualization must also be 4.20.0.

  • Two OKD clusters are required, and the migration network for both clusters must be connected to the same L2 network segment.

  • You must have cluster administration privileges and appropriate RBAC privileges to manage VMs on both clusters.

Setting a live migration feature gate for each cluster in OpenShift Virtualization

To enable cross-cluster live migration, you must set a feature gate for each of the two clusters in OpenShift Virtualization.

Prerequisites

  • You have installed the OpenShift CLI (oc).

  • You must have cluster admin privileges.

  • The virt-synchronization-controller pods must be running.

Procedure

  • Set the feature gate by running the following command for each cluster:

    $ oc patch hyperconverged kubevirt-hyperconverged -n openshift-cnv --type json -p '[{"op":"replace", "path": "/spec/featureGates/decentralizedLiveMigration", "value": true}]'
Verification

  • To verify that the feature gate enablement is successful for each cluster, run the following command in the OpenShift Virtualization namespace to locate the synchronization pods:

    $ oc get -n {CNVNamespace} pod | grep virt-synchronization

    Example output:

    virt-synchronization-controller-898789f8fc-nsbsm      1/1     Running   0               5d1h
virt-synchronization-controller-898789f8fc-vmmfj      1/1     Running   0               5d1h