Target Installation Fails

Error message: Another version of this product is already installed.

You see this error when Intel® Distribution for GDB* Target from previous releases included in Intel® oneAPI Base Toolkit are installed on your system.

To avoid this error, remove previously installed packages using Add/Remove Programs on the Control Panel.

Unable to start debugging

Error message:

Unable to start debugging. Unexpected GDB output from command
"-target-select remote <server name>:1234". Remote
communication error. Target disconnected.: No such file or directory.

Check whether in Tools > Options > Intel oneAPI > Intel® Distribution for GDB* **, the **Server field is set correctly.

Error message:

Unable to start debugging. Unexpected GDB output from command
"-target-select remote <server name>:1234". <remote
machine IP address>:1234 Connection timed out.

Please ensure that the latest GPU drivers are installed on the target machine. If you are debugging the GPU locally, ensure that the latest GPU drivers are installed on the host machine.

Also, ensure that the device you are trying to offload the kernel to, is present in the list of supported devices.

Deployment errors

Error message:

There were deployment errors.Continue?

1. Check if the “Remote Debugger” is running on the target.

2. If the “Remote Debugger” is running and the error persists, please restart the target and try again.

WMI operation failed

If the following error message appears:

Unable to connect to remote target <target-name>:
The RPC server is unavailable.

Or a pop-up “Windows* Management Instrumentation (WMI) operation failed” window is shown, disable the Remote User Account Control (UAC) by executing the following command in the console as Administrator:

reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System /v LocalAccountTokenFilterPolicy /t REG_DWORD /d 1 /f

Try to connect again.

Breakpoint Is Not Hit

No error messages are displayed but a breakpoint inside the kernel is not hit.

Check whether in Tools > Options > Intel oneAPI > Intel® Distribution for GDB*, the Enable Debugging field is set to True.

For OpenCL™ applications, verify the following:

• -s flag in clBuildprogram defines the absolute path of the kernel source file.

• The kernel source file is accessible on both host and target systems.

• Debugging option is enabled for Intel Distribution for GDB with Enhanced GPU Offload. Refer to the setup instruction.

• Intel Distribution for GDB may not have started and the default version is still running, which does not support GPU breakpoints. See step 2 under Cannot Connect to Target to perform a manual launch.

Unhandled Exception in igc64.so

You can get an unhandled exception coming from IGC at the runtime when the Debug information format is set. To resolve this issue, set Property pages > Linker > Pass additional options to device compilers to /Od.