Troubleshooting

This document provides guidance on identifying and resolving common issues with General-Purpose GPUs.

Resolving installation issues caused by package mismatches

The DKMS version of the Intel graphics kernel driver for Linux requires the kernel headers and development package for the currently running kernel. In a default configuration, the versions installed would be the latest available from the operating system provider.

If you are not running the latest kernel from your operating system provider and need to install the Intel graphics kernel driver for an older version, you need to explicitly install the version of the kernel headers and development package via:

dnf|apt|zypper install kernel-headers-$(uname -r)

Using uname -r installs the version of the actively running kernel. If you will be booting into a different kernel version than the actively running kernel, change $(uname -r) to the version you wish to target.

Resolving issues with DKMS driver installation failure

If you encounter problems when trying to install any of the DKMS modules provided by Intel, ensure your running kernel matches those listed on the OS Support page. Older kernels may not be compatible with the DKMS source provided by Intel.

If you happen to be running a kernel version from your distributor that is newer than Intel has supplied, please file an issue and let us know the kernel version you are running. You can find kernel version by running this command:

uname -a