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:
You may also add a flag for more information:
If no issues are found you will see a message similar to this:
If a problem is found, you will see a message similar to this:
|
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.
After you set the proxy, return to the instructions for Running a Sample Using the Command Line and try again.
|
Eclipse* did not install correctly or has errors when running Eclipse.
| Install or update the Eclipse plug-ins from
Eclipse or from the Command Line. For the Command Line, use the
install-eclipse-plugins.sh script. Go to:
The script does not require arguments to run. You can get a help message using any of the following:
Running the
setvars.sh script will add
install-eclipse-plugins.sh to your path (for the current terminal session):
The script supports a verbose mode which can be helpful if you are having issues running the script, especially if the script is failing to do its work. Use verbose mode as follows:
The script will ask for the location of the Eclipse binary into which you want to install or update the Intel plug-ins for Eclipse.
Enter the path to the eclipse executable, not just to the folder that contains the executable. Please make sure you enter the full absolute path to the eclipse executable. Relative paths with tilde '~' are not supported.
The script performs the following operations:
To install using the Eclipse interface:
|
OpenCL* drivers are not found
| Refer to the
GPU Drivers section of the Installation Guide for information on downloading and installing OpenCL drivers.
|