Learning
Learning paths provide you with a curated set of training modules that help you learn specific tools and technologies. You learn the code and practice using Intel® DevCloud.
Common Hardware Requirements
CPU Processor:
Systems based on Intel® 64 architectures below are supported both as host and target platforms.
- Intel® Core™ processor family or higher
- Intel® Xeon® processor family
- Intel® Xeon® Scalable processor family
Accelerators:
- Integrated GEN9 or higher GPUs including latest Intel® Iris® Xe MAX graphics (DG1)
- FPGA Card: see Intel(R) DPC++ Compiler System Requirements.
Disk Space:
- ~3 GB of disk space (minimum) if only installing compiler and its libraries: Intel oneAPI DPC++/C++ Compiler, Intel® DPC++ Compatibility Tool, Intel® oneAPI DPC++ Library and Intel® Threading Building Block
- Maximum of ~24 GB diskspace if installing all components
NOTE: During the installation process, the installer may need up to 6 GB of additional temporary disk storage to manage the download and intermediate installation files.
Memory:
- 8 GB RAM recommended
- For FPGA development, see Intel(R) DPC++ Compiler System Requirements.
Common Software Requirements
Operating System Requirements
The operating systems listed below are supported on Intel® 64 Architecture. Individual tools may support additional operating systems and architecture configurations. See the individual tool release notes for full details.
For developing applications for offloading to accelerators like GPU or FPGA, a specific version of GPU driver is required for the supported operating system. Please visit Installation Guide for Intel® oneAPI Toolkits "Install Intel GPU Drivers" section for up to date information.
Note: These OS distributions are tested by Intel or known to work; other distributions may or may not work and are not recommended. If you have questions, access the Intel Community Forums when you need assistance. If you have Commercial Support, create a support ticket.
For Linux*
- GNU* Bash is required for local installation and for setting up the environment to use the toolkit.
For CPU Host/Target Support
Linux distrubtion for CPU Host/Target | Supported Components |
---|---|
Red Hat Enterprise Linux* 7.x | Intel® VTune™ Profiler, Intel® Advisor, Intel® Threading Building Blocks (oneTBB) |
Red Hat Enterprise Linux* 8.x | All |
Rocky Linux 8 | All except Intel® oneAPI DPC++/C++ Compiler |
Oracle Linux 8 | All except Intel® oneAPI DPC++/C++ Compiler |
SUSE Linux Enterprise Server* 15 SP2, SP3 | All except Intel® oneAPI Video Processing Library (oneVPL) |
Fedora* 34, 35 | All except FPGA |
Ubuntu* 18.04 LTS | All |
Ubuntu* 20.04 LTS | All |
CentOS* 7 | All except Intel® oneAPI DPC++/C++ Compiler |
Debian* 9, 10 | All except Intel® oneAPI DPC++/C++ Compiler and FPGA |
Clear Linux | only oneTBB |
For GPU Accelerator Support for GPU
Linux distribution for GPU Accelerators | Supported Components | Additional Software Requirements |
---|---|---|
Red Hat Enterprise Linux* 8.2, 8.3, 8.4 | All except oneVPL, Intel® Integrated Performance Primitives (Intel IPP) | kernel 4.11 or higher |
Ubuntu 20.04 LTS | All except oneVPL & Intel IPP | kernel 4.11 or higher |
SUSE Linux Enterprize Server* 15 SP2, SP3 | All except oneVPL & Intel IPP | kernel 4.11 or higher |
Please follow the instructions on how to install the driver.
For Windows*
For CPU Support
OS (for CPU) | Supported Components |
---|---|
Windows* 11 | All |
Windows* 10 | All except oneCCL |
Windows Server 2016* | All |
Windows Server 2019* | All |
For GPU Accelerator Support for iGPU
OS (for GPU) | Supported Components |
---|---|
Windows* 11 | All except oneCCL, oneVPL & Intel IPP |
Windows* 10 | All except oneCCL, oneVPL & Intel IPP |
For macOS*
for CPU only | Supported Components |
macOS* 12 & macOS 11.0 | Intel® oneAPI Data Analytics LibraryIntel® oneAPI Deep Neural Network LibraryIntel® oneAPI Math Kernel LibraryIntel® oneAPI Threading Building BlocksIntel® Advisor (viewer only)Intel® Distribution for Python*Intel® Integrated Performance PrimitivesIntel® Integrated Performance Primitives CryptographyIntel® VTune™ Profiler (viewer only) |
macOS 10 | Deprecated started with 2022.1 release |
Development Tools
Diagnostics Utility for Intel® oneAPI Toolkits
The Diagnostics Utility for Intel® oneAPI Toolkits is designed to diagnose the system status for using Intel® products. With this utility, you can identify errors such as:
- Permissions errors for the current user
- Missing driver or an incompatible version of a driver
- Incompatible version of the Operating System
To learn more, see the Diagnostics Utility for Intel® oneAPI Toolkits User Guide.
Visual Studio Code (VS Code) Extensions for Intel® oneAPI Toolkits
The VS Code extensions for oneAPI Toolkits provide assistance to developers who are creating, debugging and profiling oneAPI applications. The Using Visual Studio Code with Intel® oneAPI Toolkits User Guide provides additional detail.
The following VS Code extensions are available in the VS Code marketplace:
- Sample Browser for Intel® oneAPI Toolkits
- Environment Configurator for Intel® oneAPI Toolkits
- Analysis Configurator for Intel® oneAPI Toolkits
- GDB GPU Support for Intel® oneAPI Toolkits
- DevCloud Connector for Intel® oneAPI Toolkits
See also:
- Get Started with Intel® oneAPI Base Toolkit for Linux
- Get Started with Intel® oneAPI Base Toolkit for Windows
- Get Started with Intel® oneAPI Base and HPC Toolkit for MacOS*
Eclipse*
- The latest version of the Eclipse IDE for C/C++ Developers install package available at https://www.eclipse.org/downloads/packages/.
Micsosoft Visual Studio*
- Microsoft Visual Studio* 2017, 2019 or 2022 Community, Enterprise and Professional Editions with 'Desktop development with C++' component installed
oneAPI Toolkits on Microsoft* Windows Subsystem for Linux 2 (WSL 2)
- With Microsoft* Windows Subsystem for Linux 2 (WSL2), you can use native Linux distribution of Intel® oneAPI tools and libraries on Windows*. For more information on usage, refer to Use Intel® oneAPI Toolkits on Microsoft* Windows Subsystem for Linux 2 (WSL 2)
Known Issues
- When installing on Rocky Linux using the YUM repository or the binary package, the installer prints an unsupported OS warning message. That can be safely ignored for this release.
- GPU offload applications using extensive multi-threading (>2 threads) may experience hangs or time out which can be recovered only though a hard reset or power cycling of the system for the following Linux Distributions. The issue occurs when reading/writing data to the Intel GPU while making extensive use of multi-threading due to a defect in older Linux kernels. Kernel/distributionProblem occursProblem does not occurRedHat Enterprise LinuxRHEL 8.4 (kernel 4.18.0-305) and olderRHEL 8.5 (kernel 4.18.0-348)SUSE LinuxSLES15 SP3 and olderSLES15 SP4 betaUbuntu LinuxUbuntu releases older than 20.04.03Ubuntu 20.04.03 (kernel 5.11.0-40-generic #44~20.04.2-ubuntu)*
Preferred Workaround: Upgrade to a Linux distribution where the defect has been fixed. Note that the software will run, but a warning message will appear in kernel logs.
GPU software for Ubuntu 20.04.03 is available now via https://dgpu-docs.intel.com. Note that the software will run, but a warning message will appear in kernel logs.
GPU software for RHEL 8.5. will be available in Q1 2022 at the same location.
GPU software for SLES15 SP4 will be available shortly after general availability of SLES15 SP4.
Alternative Workaround: Do not use extensive multi-threading in GPU-enabled applications, i.e. keep the number of threads no more than 2. For example, for applications using the oneAPI MPI library, use the single threaded version of the MPI run-time library, rather than the multi-threaded version. Set the environment variable I_MPI_THREAD_SPLIT=0 to use the single threaded version of MPI. - In 2022.1 release oneCCL, oneVPL, Advisor and Vtune are not supported on WSL2 for GPU.
Deprecation Notices
- These operating systems are deprecated in the Intel oneAPI 2022.1 release, and will be removed in a future release:
- Windows Server 2016*
- Red Hat* Enterprise Linux 7
- SUSE Linux Enterprise Server* 15 SP2
- Ubuntu* 18.04 LTS
- CentOS*
- Fedora 34
- Fedora 35
- Clear Linux*
- Yocto
- macOS* 11
- Microsoft Visual Studio* 2017 integration is deprecated starting in 2022.0 release and will be removed in a future release.
System Requirements of All Included Tools
One common requirements for Linux*: GNU* Bash is required for local installation and for setting up the environment to use the toolkit.
- Intel® oneAPI DPC++/C++ Compiler System Requirements
- Intel® DPC++ Compatibility Tool System Requirements
- Intel® oneAPI DPC++ Library (oneDPL) System Requirements
- Intel® Distribution for GDB* System Requirements
- Intel® oneAPI Math Kernel Library (oneMKL) System Requirements
- Intel® oneAPI Threading Building Blocks (oneTBB) Library System Requirements
- Intel® Integrated Performance Primitives System Requirements
- Intel® oneAPI Data Analytics Library (oneDAL) System Requirements
- Intel® Distribution for Python* System Requirements
- Intel® VTune™ Profiler System Requirements
- Intel® Advisor System Requirements
- Intel® oneAPI Deep Neural Network Library (oneDNN) System Requirements
- Intel® oneAPI Collective Communications Library (oneCCL) System Requirements
- Intel® oneAPI Video Processing Library (oneVPL) System Requirements
For new features or known issues, please read the Intel® oneAPI Base Toolkit Release Notes.
Intel® oneAPI introduces the use of hardware accelerator devices that can be leveraged with the Intel oneAPI DPC++ (DPC++) Compiler. This necessitates the use of specific hardware for offload. This article will help you determine what options you have with either physical hardware or the use of a cloud service provider.
The oneAPI DPC++ Compiler is included in the Intel® oneAPI Base Toolkit (Base Kit), which brings us the ability to use hardware accelerators to run computing tasks optimally. This compiler targets specific hardware for optimization tasks.
What is Intel oneAPI Data Parallel C++
Intel oneAPI Data Parallel C++ (DPC++) is based on the C++ language and incorporates SYCL* from the Kronos Group to provide parallel programming productivity and performance across CPUs and accelerators. The goal is to simplify programming and enable code reuse across hardware targets while allowing tuning for specific accelerators.
The oneAPI DPC++ compiler is designed specifically to offload workloads to various accelerators for performance optimization. The Intel oneAPI beta supports offloading to the following accelerators.
- FPGA accelerator offloads: Enables the developer to show performance increases for various workloads, compared to pure CPU solutions
- GPU accelerator offloads: Currently, only Intel® Processor Graphics gen9 is supported and used as a proxy graphics processing unit (GPU. This usage is specifically for familiarization and testing purposes; as an Intel® DevCloud reference
Compiler Requirements
There are no specific hardware requirements for the oneAPI DPC++ compiler. However, for exercising CPU, GPU, or field-programmable gate array (FPGA) accelerator offload, specific hardware is required.
Compiler Download
The oneAPI DPC++ compiler is part of the Intel oneAPI Base Toolkit (Base Kit).
Hardware Requirements for Accelerator Support
The oneAPI specification is designed to support a broad range of CPUs and accelerators from multiple vendors. The oneAPI Beta reference implementation currently supports Intel CPUs, including Intel® Xeon® processors, Intel® Core™ processors, and Intel® Arria® FPGAs with Intel Processor Graphics gen9 as a proxy development platform for future Intel discrete data center GPUs. Additional Intel accelerator architectures will be added over time.
The following development platforms are supported accelerators for oneAPI beta.
GPU Accelerator Support
Physical hardware support—Desktop/Mobile/Server:
- Minimum support requirements would be any Intel Core processors or Intel Xeon processors. The processor model number must be 6000 or higher and does not have “F” or “P” in the model number (for example, I5-6402P) or non-integrated graphics parts
- One hardware example is the Intel® NUC (next unit of computing) computer kit SKU# NUC8i7BEH
Cloud support—Server only:
- Intel DevCloud—support for GPU offload uses Intel® Xeon® E-2176 processor product family processors with Intel® HD graphics P630 graphics. Intel DevCloud is a sandbox environment used for development purposes only
FPGA Accelerators
For FPGA offload, a PCI Express* FPGA accelerator card is required. For development purposes, developers can use on-premises devices or cloud servers.
Physical hardware supported—Server only:
- Minimum support requirements are Intel Xeon processor-based servers that support 10 GX Intel Arria FPGA
Cloud support—Server only:
- Intel DevCloud—Support for FPGA offload uses Intel Xeon E-2176 processor product family processors with Intel HD P630 graphics and 10 GX Intel Arria FPGA. DevCloud is a sandbox environment used for development purposes only
Additional Links
Intel® FPGAs and Programmable Devices
About Intel® Processor Numbers
About Intel® Xeon® Processor Numbers
Specific Intel® Core™ Processor information on Product Specifications
Specific Intel® Xeon® Processor information on Product Specifications
Get Started with the Intel® oneAPI Base Toolkit for Windows*
The following instructions assume you have installed the Intel® oneAPI software. Please see the Intel oneAPI Toolkits page for installation options.
Follow These Steps for the Intel® oneAPI Base Toolkit:
- Configure Your System.
- Build and Run a sample project using one of these methods:
- After you have run a sample, learn more about the Intel® oneAPI Base Toolkit (Base Kit) in Next Steps.
An offline copy of this Get Started is available on the Downloadable Documentation page.
Choose Your Toolkit
If you are using the Intel® oneAPI Base Toolkit, go to Configure Your System, as described in step 1 above.If you are using a toolkit other than the Base Kit, follow the links below to find steps to configure your system and run a sample project: