Last Updated:12/04/2020
This page provides general installation and support notes about the Intel oneAPI toolkits distributed via Zypper repository.
LEGAL NOTICE: By downloading and using these packages and the included software, you agree to the terms and conditions of the software license agreements located at the End User License Agreements page.
By proceeding you acknowledge that you have read the EULA and agree to the terms and conditions of this agreement.
Important: If you have an existing installation of Intel® oneAPI Beta, you should remove it before installing the Gold version.
Note: The YUM (DNF) repository is a public repository on the general Internet. If you are on a company intranet behind a firewall you may need to set environment variables https_proxy and http_proxy to your company's proxy server and port. Please contact your local network or system administrators for assistance if you are unfamiliar with using proxy servers.
The following toolkits and associated versions are available
THE REPOSITORIES ALWAYS CONTAIN THE LATEST RELEASED VERSION
|
|
|
32-bit Meta Package Name |
Intel® oneAPI Base Toolkit |
2021.1.0 |
intel-basekit |
intel-basekit-32bit |
Intel® oneAPI HPC Toolkit |
2021.1.0 |
intel-hpckit |
intel-hpckit-32bit |
Intel® oneAPI IoT Toolkit |
2021.1.0 |
intel-iotkit |
intel-iotkit-32bit |
Intel® oneAPI DL Framework Developer Toolkit |
2021.1.0 |
intel-dlfdkit |
intel-dlfdkit-32bit |
Intel® AI Analytics Toolkit |
2021.1.0 |
intel-aikit |
intel-aikit-32bit |
Intel® oneAPI Rendering Toolkit |
2021.1.0 |
intel-renderkit |
intel-renderkit-32bit |
Intel® FPGA Add-On for oneAPI Base Toolkit | 2021.1 |
|
|
The Intel® System Bring-Up Toolkit |
|||
The Intel® Distribution of OpenVINO™ toolkit for Linux* |
|
The oneAPI repository provides runtime library packages. These packages can be installed on systems that will host oneAPI applications: hosts where you do not want to install the oneAPI Development Toolkits. These are hosts where you run applications but do not do development, compilation, or runtime profiling. The following runtime library packages are available:
Installation of Intel® oneAPI Toolkits on a supported Linux system requires the following steps:
# Redhat, Fedora, CentOS and related
more /etc/redhat-release
# Ubuntu, Debian, others
more /etc/lsb-release
Intel provides access to all of its oneAPI toolkits and packages through a public Zypper repository. Zypper is a command line package manager which provides functions like repository access, dependency solving, package installation, etc. for openSUSE* and SUSE* Linux* Enterprise. See below for instructions on how to pull the latest versions of the Intel tools. For more information, visit the official zypper command cheat sheet.
1. If you have an existing Intel oneAPI Beta installation, use zypper rm <packages> to remove it. For example:
sudo -E zypper rm intel-hpckit intel-basekit
2. Add the Intel oneAPI repository public key:
sudo zypper addrepo https://yum.repos.intel.com/oneapi oneAPI
By adding this new repository, Zypper had to automatically import the public repo key. For some cases rpm might require explicit key import by:
rpm --import https://yum.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB
3. Install the desired package. Determine which Intel oneAPI toolkit package or packages you require using the Table of Packages. If you are on a company intranet or behind a firewall make sure to set environment variables http_proxy and https_proxy appropriate to allow Zypper access the repository servers using https protocol.
To install a Toolkit, for example, the Intel® oneAPI Base Toolkit, which meta package name is intel-basekit, use the following command:
sudo zypper install intel-basekit
4. [Optional] When installing on a machine with no internet access, or in the case of a large distributed installation on a cluster, zypper supports downloading a package without installing it through the --download-only option. Visit the Zypper man pages for more details.
5. Set up the user environment. After oneAPI tools are installed, before accessing the tools, you must set up environment variables to access the tools.
6. (Optional) If you also want to integrate tools into the Eclipse* IDE, Open Eclipse and verify that a menu titled “Intel” is present. If the menu is not present read this guide to Installing Eclipse* Plugins from the IDE.
7. Installation complete! What's next? Get Started with the Intel® oneAPI Toolkits for Linux*
NOTE: If you have applications with long-running GPU compute workloads in native environments, you must disable the hangcheck timeout period to avoid terminating workloads.
You can upgrade toolkit or component package to the latest version using the following instructions:
sudo zypper upgrade intel-basekit
sudo zypper upgrade intel-oneapi-dpcpp-debugger
If you are using a discrete Intel GPU, you will need to install the latest drivers because they are not included in oneAPI toolkit installation package.
This section applies only to applications with long-running GPU compute workloads in native environments. Not recommended for virtualizations or other standard usages of GPU, such as gaming.
A workload that takes more than four seconds for GPU hardware to execute is a long running workload. By default, individual threads that qualify as long-running workloads are considered hung and are terminated. Disabling the hangcheck timeout period avoids this problem.
NOTE: If the system is rebooted, hangcheck is automatically enabled. You must disable hangcheck again after every reboot or follow the directions below to disable hangcheck persistently (across multiple reboots).
To disable hangcheck until the next reboot:
sudo sh -c "echo N> /sys/module/i915/parameters/enable_hangcheck"
To disable hangcheck across multiple reboots:
Append i915.enable_hangcheck=0 to GRUB_CMDLINE_LINUX_DEFAULT in /etc/default/grub
Run sudo update-grub
Use the queries provided below to find and install specific toolkits, standalone components, standalone runtime library packages, or simply to see all available packages in oneAPI repository.
To query the Zypper repository for available toolkit packages, use the following command:
sudo -E zypper pa -ir oneAPI | grep kit | grep -v runtime
The oneAPI repository also contains standalone components, which are packages that provide a specific tool for cases where you do not need an entire toolkit. For these packages, if there is a <component>-runtime package, make sure to get and install both the component package and its runtime package. Not all standalone components need an additional runtime package. If you do not see a runtime package for your standalone component, then you do not need one.
To query the Zypper repository for available standalone components and their runtime packages, use the following command:
sudo -E zypper pa -ir oneAPI | grep intel-oneapi | grep -v intel-oneapi-runtime
The oneAPI repository provides standalone runtime library packages. These packages can be installed on systems that will host oneAPI applications: hosts where you do not want to install the oneAPI Development Toolkits. These are hosts where you run applications but do not do development, compilation, or runtime profiling. In this case, you only need the shared libraries dynamically linked to by executables, provided by these packages.
To query the Zypper repository for available component runtime libraries, use the following command:
sudo -E zypper pa -ir oneAPI | grep intel-oneapi-runtime
To query all available Intel® oneAPI packages provided in the repository, use the following command:
sudo -E zypper pa -ir oneAPI
Check out the FAQ
See our Get Help page for your support options.
Notices and Disclaimers
Intel technologies may require enabled hardware, software or service activation.
No product or component can be absolutely secure.
Your costs and results may vary.
© Intel Corporation. Intel, the Intel logo, and other Intel marks are trademarks of Intel Corporation or its subsidiaries. Other names and brands may be claimed as the property of others.
No license (express or implied, by estoppel or otherwise) to any intellectual property rights is granted by this document.
The products described may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request.
Intel disclaims all express and implied warranties, including without limitation, the implied warranties of merchantability, fitness for a particular purpose, and non-infringement, as well as any warranty arising from course of performance, course of dealing, or usage in trade.
Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.