4.11. Installing a vGPU on a Virtual Machine

download PDF

You can use a host with a compatible graphics processing unit (GPU) to run virtual machines with virtual GPUs (vGPUs). A virtual machine with a vGPU is better suited for graphics-intensive tasks than a virtual machine without a vGPU. A virtual machine with a vGPU can also run software that cannot run without a GPU, such as CAD.

vGPU Requirements

If you plan to configure a host to allow virtual machines on that host to install a vGPU, the following requirements must be met:

  • vGPU-compatible GPU
  • GPU-enabled host kernel
  • Installed GPU with correct drivers
  • Predefined mdev_type set to correspond with one of the mdev types supported by the device
  • vGPU-capable drivers installed on each host in the cluster
  • vGPU-supported virtual machine operating system with vGPU drivers installed

Preparing a Host for vGPU Installation

  1. Install vGPU-capable drivers onto your host. Consult the documentation for your GPU card for more information.
  2. Install vdsm-hook-vfio-mdev:

    # yum install vdsm-hook-vfio-mdev

You can now install vGPUs on the virtual machines running on this host.

Installing a vGPU on a Virtual Machine

  1. Confirm the vGPU instance to use:

    • Click Compute Hosts, click the required host’s name to go to the details view, and click the Host Devices tab. Available vGPU instances appear in the Mdev Types column.
    • Alternatively, run the following command on the host:

      # vdsm-client Host hostdevListByCaps

      Available vGPU instances appear in the mdev key available_instances.

  2. Install the required virtual machine operating system. See ] or xref:chap-Installing_Windows_Virtual_Machines[.
  3. Shut down the virtual machine.
  4. Add the vGPU instance to the virtual machine:

    1. Select the virtual machine and click Edit.
    2. Click Show Advanced Options, then click the Custom Properties tab.
    3. Select mdev_type from the drop-down list and enter the vGPU instance in the text field.
    4. Click OK.
  5. Start the virtual machine and install the vGPU driver through the vendor’s installer. Consult the documentation for your GPU card for more information.
  6. Restart the virtual machine.
  7. Verify that the vGPU is recognized by checking the virtual machine operating system’s device manager.

You cannot migrate a virtual machine using a vGPU to a different host. When upgrading the virtual machine, verify the operating system and GPU vendor support in the vendor’s documentation.

Red Hat logoGithubRedditYoutubeTwitter


Try, buy, & sell


About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.