Visible to Intel only — GUID: GUID-19891F94-CBE8-48D6-ABC3-C1BCC690EB85
Configure Your CPU or GPU System
Configure Your FPGA System
Build and Run a Sample Project Using the Command Line
Build and Run a Sample Project Using Eclipse*
Build and Run a Sample Project Using Visual Studio Code
Using Containers
Using Cloud CI Systems
Troubleshooting
Next Steps
Notices and Disclaimers
Visible to Intel only — GUID: GUID-19891F94-CBE8-48D6-ABC3-C1BCC690EB85
Troubleshooting
Potential errors and how to avoid or fix them.
| Issue | How to fix |
|---|---|
| Errors that occur during installation or directly after installation. | See the Troubleshooting page of the Intel® oneAPI Toolkits Installation Guide for Linux* OS. |
| Undefined error appears when building a sample. | If the sample was built by using cmake and then make, more details to diagnose the reason for your error are available by rebuilding with the VERBOSE option: make VERBOSE=1 For more comprehensive troubleshooting, use the Diagnostics Utility for Intel® oneAPI Toolkits, which provides system checks to find missing dependencies and permissions errors. Learn more. |
Developing with Offline Systems: I need to develop on a system that is not connected to the internet. |
If you are using an offline system, download the samples from a system that is internet connected and transfer the sample files to your offline system. After you have downloaded the samples, follow the instructions in the README.md file. The readme file is located in the folder of the sample you are interested in. The samples can be downloaded from the code samples repository. The full set of documentation can be downloaded from Downloadable Documentation. |
| Errors due to missing dependencies, missing environment variables or missing machine capabilities. | The Diagnostics Utility for Intel oneAPI Toolkits provides the ability to find missing dependencies and permissions errors and is already installed with this tooklit. Learn more. |
| Unable to install toolkits or access libraries. | Verify that you meet the System Requirements listed on the Intel® oneAPI Base Toolkit product page |
| Problems connecting from behind a proxy | The oneAPI CLI Samples Browser does not work with system proxy settings and does not support WPAD proxy. If you are unable to access the samples from the oneAPI CLI Samples Browser, set the value of https_proxy and http_proxy, then run oneapi-cli in the same terminal. To set the proxy enter this command, where your.proxy is the name of your proxy server and 8080 is your default port. export http_proxy=http://your.proxy:8080 After you set the proxy, return to the instructions for Running a Sample Using the Command Line and try again. |
The Intel plug-ins for Eclipse did not install correctly, or the Intel menu is missing from Eclipse. |
|
OpenCL* drivers are not found |
Refer to the GPU Drivers section of the Installation Guide for Intel® oneAPI Toolkits for information on downloading and installing OpenCL drivers. |