Skip to main content
Version: 3.1

Manage storage for KubeVirt VMs

KubeVirt is an extension for Kubernetes that offers the flexibility to manage traditional VM-based workloads alongside modern containerized applications within a Kubernetes framework.

Portworx provides resources that VMs can use for both their initial startup process and for retaining data even when they are not running. To utilize OpenShift features, such as live migration, these volumes must have the ReadWriteMany access mode.

Follow the instructions on this page to create a StorageClass, which you can use to create the necessary PVCs.


Create a StorageClass

To ensure PVCs are compatible with KubeVirt virtual machines, they must be configured with the ReadWriteMany access mode and use NFS version 3.0 with nolock mount option as shown below in the sharedv4_mount_options parameter. To meet these requirements, create PVCs from the StorageClass with the following parameters configured:

  • sharedv4: "true"
  • sharedv4_mount_options: vers=3.0,nolock
  1. Create the px-kubevirt-sc.yaml file:

    kind: StorageClass
    name: portworx-rwx-kubevirt
    repl: "3"
    sharedv4: "true"
    sharedv4_mount_options: vers=3.0,nolock
    volumeBindingMode: WaitForFirstConsumer
    allowVolumeExpansion: true
    Toggle me to know more about volumeBindingMode!

    The volumeBindingMode=WaitForFirstConsumer flag enables Portworx to intelligently place the volumes. For more information, see the KubeVirt page.

    Note that the PVCs used by the VMs directly should not include the annotation This is because such an annotation overrides the WaitForFirstConsumer setting in the StorageClass.

  2. Run the following command to apply your StorageClass:

    kubectl apply -f px-kubevirt-sc.yaml

Create a PVC

Use the KuberVirt webconsole to create PVCs, and ensure that the created PVCs have the RWX access mode.

Once PVCs are created, run the following command to verify if they have the RWX access mode:

kubectl get pvc -n <vm-namespace>
NAME                  STATUS   VOLUME             CAPACITY   ACCESS MODES   STORAGECLASS             AGE
<your-kubevirt-pvc> Bound pvc-xxxx-xxx-xxx 1Gi RWX portworx-rwx-kubevirt 15h

Create a VM

Create a KuberVirt VM using the OpenShift documentation.

Once the VMs are created, each VM will start running in a virt-launcher pod.

KubeVirt facilitates the Live Migration of VMs with Portworx ReadWriteMany volumes. However, the underlying libvirtd lacks this capability, prohibiting such live migrations. To address this, the Stork webhook controller modifies the virt-launcher pod manifest. It achieves this by inserting a special shared library through LD_PRELOAD. This library intercepts the statfs() system call made by libvirtd when accessing a Portworx volume. Here is the code of this shared library.

Further reads

Was this page helpful?