Set up the machine for debugging

Graphics driver

Install drivers using the following guides:

The user should be in the “video” group (on Ubuntu* 18, Fedora* 30, and SLES* 15 SP1) or “render” group (on Ubuntu* 19 and higher, CentOS* 8, and Fedora* 31). An administrator with sudo or root privileges can change the group owner of /dev/dri/renderD* and /dev/dri/card* to a group ID used by your user base:

sudo usermod -a -G video <username>

NEO driver

NEO driver 21.15.19533 or higher is required to make the debugger work correctly.

  1. Download the driver from GitHub.

  2. Install the NEO driver on the system or locally.

    • To install the driver on the system, use the command:

      sudo dpkg -i *.deb

    • To install the driver locally:

      1. Add the path to NEO files in LD_LIBRARY_PATH:

        cd /path/to/my/neo
for file in `ls *.deb`; do dpkg -x $file .; done
export MY_ACTIVE_NEO=/path/to/my/neo/usr/local/lib
export LD_LIBRARY_PATH=${MY_ACTIVE_NEO}:${MY_ACTIVE_NEO}/intel-opencl:$LD_LIBRARY_PATH
      2. Add environment variables to change the behavior of the Installable Client Driver (ICD).

        ICD uses the system implementation for OpenCL™ by default. To install the driver locally, add all needed from “/etc/OpenCL/vendors/” and custom to OCL_ICD_FILENAMES. To overwrite the default behavior, use export OCL_ICD_VENDORS=:

        export OCL_ICD_FILENAMES=/path/to/my/neo/usr/local/lib/intel-opencl/libigdrcl.so:/optional/from/vendors/libintelocl.so
export OCL_ICD_VENDORS=

See also:

Debug companion driver (DCD)

  1. To install the DCD from oneAPI into the system, use the following command:

    sudo dpkg -i /path/to/oneapi/debugger/latest/igfxdcd-*-Linux.deb

  2. Activate the driver:

    sudo modinfo igfxdcd

Remove the driver from the system if you want to install a different version:

sudo dpkg -r igfxdcd

If you are installing DCD for the first time, create keys. For details, see the link at the end of this page.

See also: