Visible to Intel only — GUID: GUID-1DC74DD2-0341-40A1-9717-14FACCB1B091
Visible to Intel only — GUID: GUID-1DC74DD2-0341-40A1-9717-14FACCB1B091
Installing Intel® SDK for OpenCL™ Applications - GPU Kernel Debugger for Windows*
This topic provides a walkthrough for the installation of the Intel® SDK for OpenCL™ Applications - GPU Kernel Debugger on a Microsoft Windows* OS.
Supported OSs and Prerequisites
Intel SDK for OpenCL Applications - GPU Kernel Debugger for Windows* can be installed and run on the following operating systems:
Windows 7 (64-bit)
Windows 8.1 (64-bit)
Windows 10 (64-bit) (preferred)
Host machine
As a host machine, you can use any machine with an Intel® CPU running a supported Windows* OS.
Target machine
A target machine is a 6th, 7th, or 8th Generation Intel® Core™ Processors machine running a supported Windows OS (Windows 10 is preferred) with the latest Graphics Driver installed.
Installing Intel® SDK for OpenCL™ Applications - GPU Kernel Debugger
Installation of the Intel SDK for OpenCL Applications - GPU Kernel Debugger on Windows machine requires installation on both host and target machines.
Installing on the Host
To install the debugger on the host machine, use the following steps:
- Launch the Intel® SDK for OpenCL™ Applications installer and ensure that Intel Debugger for Heterogeneous Compute is selected in the list of components to install.
- Select either option you like and click Install:
- Check the Open target installer folder option. Pay attention to the location of the target installer (in this instance, it is C:\Intel\OpenCL\debugger), you will need it for installing on the target machine:
NOTE:Reboot is required (usually for environment variables to propagate after setup), so make sure you reboot prior to the first usage.
Installing on the Target
The target machine is the machine used for running the OpenCL host application under debug. This is usually a different machine (not the host), unless you have a discrete graphics card used for displaying the Windows Desktop, in which case host and target can be the same machine. Complete the following steps to install the debugger on your target machine:
- Copy the gen_debugger_target_*.msi installer file from the host machine (from C:\Intel\OpenCL\debugger by default) to your target machine.
Launch the installer and follow the instructions:
Click Finish and reboot the machine:
If you want to (remotely) debug your OpenCL kernels using Microsoft Visual Studio* 2015/2017, the following additional steps are required.
To debug through Visual Studio 2015, do the following:
- Open an elevated command prompt on your target machine
- Create the Remote Debugger directory: mkdir C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\Remote Debugger
- Copy the entire folder C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\Remote Debugger from your host machine to your target machine (into the same directory hierarchy)
Create a desktop shortcut (optional):
- Open C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\Remote Debugger\x64
- Right-click on msvsmon.exe > Send to > Desktop (create shortcut), rename the shortcut to VS2015 Remote Debugger.
If you wish to debug through Visual Studio 2017, do the following:
- Open an elevated command prompt on your target machine
- Create the Remote Debugger directory: mkdir C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\Common7\IDE\Remote Debugger
- Copy the entire folder C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\Common7\IDE\Remote Debugger from your host machine to your target machine (into the same directory hierarchy)
Create a desktop shortcut (optional):
- Open C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\Common7\IDE\Remote Debugger\x64
- Right-click on msvsmon.exe > Send to > Desktop (create shortcut), rename the shortcut to VS2017 Remote Debugger.