12.7. Live migrating a virtual machine with an attached NVIDIA vGPU

Prerequisites

• You have an NVIDIA GPU with an NVIDIA Virtual GPU Software Driver version that supports this functionality. Refer to the relevant NVIDIA vGPU documentation for more details.
• You have a correctly configured NVIDIA vGPU assigned to a VM. For instructions, see: Setting up NVIDIA vGPU devices

• The host uses the Intel 64 or AMD64 CPU architecture.
• All of the vGPU migration prerequisites that are documented by NVIDIA. Refer to the relevant NVIDIA vGPU documentation for more details.
• All of the general VM migration prerequisites. For details, see Migrating a virtual machine by using the command line

• Certain NVIDIA GPU features can disable the migration. For more information, see the specific NVIDIA documentation for your graphics card.
• Some GPU workloads are not compatible with the downtime that happens during a migration. As a consequence, the GPU workloads might stop or crash. It is recommended to test if your workloads are compatible with the downtime before attempting a vGPU live migration.
• Currently, vGPU live migration fails if the vGPU driver version differs on the source and destination hosts.

• Currently, some general virtualization features cannot be used when live migrating a VM with an attached vGPU:

  • Calculating dirty memory page rate generation of the VM.

    Currently, live migration data and statistics provided by virsh domjobinfo and virsh domdirtyrate-calc commands are inaccurate when migrating a VM with an attached vGPU, because the calculations only count guest RAM without including vRAM from the vGPU.

  • Using a post-copy live migration.
  • Using a virtual I/O Memory Management Unit (vIOMMU) device in the VM.

Procedure

• For instructions on how to proceed with the live migration, see: Migrating a virtual machine by using the command line

  No additional parameters for the migration command are required for the attached vGPU device.