Get Started

  • 2021.3
  • 06/28/2021
  • Public Content

Troubleshooting

Potential errors and how to avoid or fix them.
Issue
How to fix
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.
Run the
sys_check
script to check and report back on any issues related to environment set up. In oneAPI install root directory, run this command:
./sys_check.sh
You may also add a flag for more information:
  • -v
    verbose output
  • --config=<config file>
    customize specific version of the components
If no issues are found you will see a message similar to this:
Checking system, will report any issues. Pass in the -v flag for verbose output.
If a problem is found, you will see a message similar to this:
Checking system, will report any issues. Pass in the -v flag for verbose output. There are no OpenCL Platforms exposed by any Installable Client Drivers (.icd) files. Apps built with Intel® oneAPI DPC++/C++ Compiler will have all computation executed on CPU, there will be no offloaded computation. Re-run the OneAPI installer.
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.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.