Get Started with the Intel® oneAPI Base Toolkit for Linux* (Beta)

Get Started

  • 0.08
  • 07/28/2020
  • Public Content
Contents

Troubleshooting

Potential errors and how to avoid or fix them.
Issue
How to fix
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
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.
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: 
 <install_dir>/dev-utilities/latest/bin/
The script does not require arguments to run. You can get a help message using any of the following: 
./install-eclipse-plugins.sh -h
 ./install-eclipse-plugins.sh --help
Running the
setvars.sh
 script will add
install-eclipse-plugins.sh
 to your path (for the current terminal session): 
 <install_dir>/setvars.sh
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: 
./install-eclipse-plugins.sh -v
 ./install-eclipse-plugins.sh -V
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:
  • Looks for Eclipse plug-ins included in the installed toolkit(s) and checks which are already installed in the selected copy of Eclipse.
  • Uninstalls any plug-in conflicts and runs the Eclipse garbage collector to clean up the uninstall.
  • Installs the included toolkit plug-ins into the selected copy of Eclipse.
To install using the Eclipse interface:
  1. Make sure there is a directory called
    dropins
     at
    <install_dir>/intel-eclipse-ide/latest/eclipse
  2. Launch Eclipse, then go to
    Help > Install New Software
    .
  3. Click on
    Add
    , choose
    Archive
    . Browse to location of the plugin you want to install. For advisor, this location will be:
    <install_dir>/advisor/latest/ide-support/
    . Choose the .zip file in that directory.
  4. Click
    Open
    . Click
    Add
    .
  5. Uncheck
    Contact all update sites during install to find the required software
    .
  6. Select the two features listed in text area and click Next.
  7. Follow the instructions in subsequent dialogs to complete installation.
OpenCL* drivers are not found
Refer to the GPU Drivers section of the Installation Guide for information on downloading and installing OpenCL drivers.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804