Installation Guide

  • 2021.2
  • 03/27/2021
  • Public Content

YUM, DNF, Zypper

Pre-installation Steps

Complete the steps below before installing Intel oneAPI packages:
  • If you have an existing installation of Intel® oneAPI Beta, remove it with the following command:
    # YUM, DNF: sudo -E {yum|dnf} autoremove <package_name> #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.
  1. Make sure that your OS is supported. You can get your OS version using one of the commands in a terminal window:
    # Redhat, Fedora, CentOS and related more /etc/redhat-release # Ubuntu, Debian, others more /etc/lsb-release
    For compatibility details, refer to the System Requirements page.
  2. If you plan to use Intel GPU, install the Intel GPU drivers.
  3. (Skip this step if you installed Intel oneAPI packages before) Set up your package manager to use the Intel repository:
    YUM/DNF
    :
    1. Create the YUM (DNF) repo file in the
      /temp
      directory as a normal user:
      tee > /tmp/oneAPI.repo << EOF [oneAPI] name=Intel(R) 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
    2. Move the newly created
      oneAPI.repo
      file to the YUM/DNF configuration directory
      /etc/yum.repos.d
      :
      sudo mv /tmp/oneAPI.repo /etc/yum.repos.d
    Zypper
    :
    Add the Intel oneAPI repository public key with the following command:
    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
  4. Get the name of the toolkit package that you need to install using the list of Intel oneAPI packages. Write down or copy your package name for future reference.

Install Packages

  1. Before installing oneAPI packages, complete the pre-installation steps listed above.
  2. (Optional) If you are on a company intranet or behind a firewall, make sure to set the
    http_proxy
    and
    https_proxy
    environment variables to allow YUM access the repository servers using HTTPS protocol.
  3. 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-basekit
    To get your package name, refer to the list of Intel oneAPI packages.
    When installing 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-only
    option. For more details, refer to YUM instructions or Zypper man pages.
  4. After oneAPI tools are installed, set up environment variables to access the tools:
    • See the Before You Begin page for setting up environment. To confirm that the environment is set up correctly, run a sample project using the command line.
    • Consider adding the
      source
      of
      setvars.sh
      to your
      ~/.bash_profile
      startup script. If you manage a multi-user system, consider how to source this script for all login users, such as adding to your
      /etc/profile
      startup script or add it to user tools environment using module files or similar.
  5. (Optional) If you 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, see Installing Eclipse* Plugins from the IDE.
  6. Installation is complete! For next steps, refer to Get Started with the Intel® oneAPI Toolkits for Linux*.
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:
# YUM: sudo yum upgrade --allowerasing --best <package_name> # DNF: sudo dnf upgrade --allowerasing --best <package_name> # 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 a toolkit or component package to the latest version using the following instructions:
  • Toolkit:
    {yum|dnf} upgrade <toolkit package>
    or
    zypper update <toolkit package>
    For example, to upgrade the Intel oneAPI Base Toolkit package to the latest version, use the following command:
    # YUM: sudo yum upgrade intel-basekit # DNF: sudo dnf upgrade intel-basekit # Zypper: sudo zypper update intel-basekit
  • Component:
    {yum|dnf|zypper} upgrade <component package>
    For example, to upgrade the Intel Distribution for GDB* package, use the following command:
    # YUM: sudo yum upgrade intel-oneapi-dpcpp-debugger # DNF: sudo dnf upgrade intel-oneapi-dpcpp-debugger # Zypper: sudo zypper update 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
* - only required if you deploy and deploy 32-bit applications
Intel® System Bring-Up Toolkit is not distributed via a repository, see details.
Intel® Distribution of OpenVINO™ toolkit for Linux* is distributed via separate YUM and APT repositories.
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.

Product and Performance Information

1

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