YUM/DNF/Zypper
You can install Intel oneAPI packages via YUM, DNF, or Zypper package managers (whichever works best for your system configuration).
Pre-installation Steps
- If you have an existing installation of Intel® oneAPI Beta, remove
- it with the following command:# If using YUM or DNF: sudo -E {yum|dnf} autoremove <package_name> # If using Zypper: sudo -E zypper rm <package_name>
- When upgrading from 2021.1 to 2021.2, apply automatic removal of conflicting packages during the upgrade process as described in the Upgrade Toolkit/Component section.
- Check the System Requirements page to make sure that your OS is supported. You can get your OS version using the following command depending on your Linux distribution:# Redhat, Fedora, CentOS and related more /etc/redhat-release # Ubuntu, Debian, others more /etc/lsb-release
- If you plan to use Intel GPU, install the Intel GPU drivers.
- Set up the repository:If using YUM/DNF:
- Create the YUM or DNF repo file in the /temp directory as a normal user:tee > /tmp/oneAPI.repo << EOF [oneAPI] name=Intel® oneAPI repository baseurl=https://yum.repos.intel.com/oneapi enabled=1 gpgcheck=1 repo_gpgcheck=1 gpgkey=https://yum.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB EOF
- Move the newly createdoneAPI.repofile to the YUM/DNF configuration directory/etc/yum.repos.d:sudo mv /tmp/oneAPI.repo /etc/yum.repos.d
If using Zypper:Add the Intel oneAPI repository public key with the following command:sudo zypper addrepo https://yum.repos.intel.com/oneapi oneAPIBy 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
Install Packages
If you are on a company intranet or behind a firewall,
set the
http_proxy
and https_proxy
environment
variables to allow YUM/DNF/Zypper access the repository servers using HTTPS
protocol. - Get the name of a toolkit package that you need to install from the list of Intel oneAPI packages. Write down or copy your package name for future reference.
- Install the needed package with the following command:sudo {yum|dnf|zypper} install <package_name>For example, to install the Intel® oneAPI Base Toolkit package from YUM, use:sudo yum install intel-basekitIf you need to install on a machine with no internet access, or in case of a large distributed installation on a cluster, you can download a package without installing it with the--download-onlyoption. For more details, refer to YUM instructions or Zypper man pages.
Installation is complete! For next steps, refer to the Get Started for your toolkit:
If you have applications with long-running GPU compute workloads
in native environments, you must disable the hangcheck timeout
period to
avoid terminating workloads.
Upgrade Toolkit/Component
Intel oneAPI packages of version 2021.2 (and higher) have conflicts
with 2021.1 packages. Before installing 2021.2, you need to remove the
2021.1 packages from your system. If you use YUM v4/DNF/Zypper, you can apply
automatic removal of conflicting packages during upgrade with the following commands:
# If using YUM:
sudo yum upgrade --allowerasing --best <package_name>
# If using DNF:
sudo dnf upgrade --allowerasing --best <package_name>
# If using Zypper:
sudo zypper update --force-resolution <package_name>
For lower versions of YUM, remove the 2021.1 packages manually:
sudo yum autoremove <package_name>
For more information about the issue and workarounds, refer to the
YUM/DNF and ZYPPER Packages oneAPI 2021.1 Gold (Initial Release) issue will Prevent Upgrades
article.
To re-install 2021.1 packages, use web and local installers as described in the Installation section of this document.
You can upgrade toolkit or component package to the latest version
using the following instructions:
- Toolkit:{yum|dnf|zypper} upgrade <toolkit package>For example, to upgrade the Intel oneAPI Base Toolkit package to the latest version, use the following command:# If using YUM: sudo yum upgrade intel-basekit # If using DNF: sudo dnf upgrade intel-basekit # If using Zypper: sudo zypper upgrade intel-basekit
- Component:{yum|dnf|zypper} upgrade <component package>For example, to upgrade the Intel Distribution for GDB* package, use the following command:# If using YUM: sudo yum upgrade intel-oneapi-dpcpp-debugger # If using DNF: sudo dnf upgrade intel-oneapi-dpcpp-debugger # If using Zypper: sudo zypper upgrade intel-oneapi-dpcpp-debugger
List of Intel® oneAPI Packages
Toolkit Packages
The following toolkits and associated versions are available for
installation via YUM repositories:
The repositories always contain the latest released version.
Toolkit Name | 64-bit Meta Package Name (default) | 32-bit Meta Package Name* |
---|---|---|
Intel® oneAPI Base Toolkit | intel-basekit | intel-basekit-32bit |
Intel® oneAPI HPC Toolkit | intel-hpckit | intel-hpckit-32bit |
Intel® oneAPI IoT Toolkit | intel-iotkit | intel-iotkit-32bit |
Intel® oneAPI DL Framework Developer Toolkit | intel-dlfdkit | intel-dlfdkit-32bit |
Intel® AI Analytics Toolkit | intel-aikit | intel-aikit-32bit |
Intel® oneAPI Rendering Toolkit | intel-renderkit | intel-renderkit-32bit |
Intel® FPGA Add-On for oneAPI Base Toolkit | intel-oneapi-intelfpgadpcpp-a10gx-s10sx intel-oneapi-intelfpgadpcpp-custom-platforms-quartus19.4 intel-oneapi-intelfpgadpcpp-custom-platforms-quartus20.2 intel-oneapi-intelfpgadpcpp-custom-platforms-quartus20.3 intel-oneapi-intelfpgadpcpp-custom-platforms-quartus20.4 intel-oneapi-intelfpgadpcpp-custom-platforms-quartus21.1 intel-oneapi-intelfpgadpcpp-custom-platforms-quartus21.2 intel-oneapi-intelfpgadpcpp-custom-platforms-quartus21.3 intel-oneapi-intelfpgadpcpp-custom-platforms-quartus21.4 |
* - only required if you deploy and deploy 32-bit applications
When installing Intel® FPGA Add-on for oneAPI Base Toolkit on CentOS 7 or RHEL 7, add
intel-basekit
to the installation command to avoid installation
conflicts. For example: yum install intel-oneapi-intelfpgadpcpp-custom-platforms-quartus20.2 intel-basekit
Intel® System Bring-Up Toolkit is not distributed via a repository,
see
details.
Runtime Library Packages
The oneAPI repository provides runtime library packages. Install
these packages on systems where you run oneAPI applications but do
not do development, compilation, or runtime profiling. The following
runtime library packages are available:
- oneAPI runtime libraries package, which is a superset of all runtimes for oneAPI components:
- 64-bit:intel-oneapi-runtime-libs
- 32-bit:intel-oneapi-runtime-libs-32bit
- Component runtime library packages. For instructions on how to get the list of all available standalone runtime packages, refer to the List Standalone Runtime Library Packages section.