Introduction
System requirements for the Intel® Embree component of Intel® oneAPI Rendering Toolkit
Version History
Date | Toolkit Version | Component Version | Major Change Summary |
September 2023 | 2023.2.1 | 4.1.0 | Library rebuild with 2023.2.2 Intel® oneAPI DPC++ Compiler. No other library change. |
July 2023 | 2023.2.0 | 4.1.0 | Intel® Data Center GPU Max Series support |
May 2023 | 2023.1.1 | 4.0.1-beta | Script fixes, please use 2023.2 |
March 2023 | 2023.1 | 4.0.1-beta | Initial Embree GPU support introduced at BETA. CPU functionality still GOLD. Major revision yields some API changes. |
December 2022 | 2023.0 | 3.13.5 | No Change |
September 2022 | 2022.3.1 | 3.13.5 | Bug Fixes |
September 2022 | 2022.3 | 3.13.4 | Apple* M1 NEON performance, TBB namespace, Intel® oneAPI DPC++ compatibility updates |
April 2022 | 2022.2 | 3.13.3 | Bug fixes |
December 2021 | 2022.1 | 3.13.2 | rcp accuracy, out of bounds geometry fixes, rtcGetGeometryThreadSafe function, BVH bugfixes |
September 2021 | 2021.4 | 3.13.1 | Bug Fixes |
June 2021 | 2021.3 | 3.13.0 | Feature Updates |
March 2021 | 2021.2 | 3.12.2 | Bug Fixes |
November 2020 | 2021.1 | 3.12.0 | Initial Release |
2023.2.1
The Intel® oneAPI 2023.2.1 release only features use of an updated compiler toolchain with no other changes. See 2023.2.0 for system requirements.
2023.2.0
Supported Operating Systems (Host and Target)
Linux* CPU Host
- Ubuntu* LTS 22.04, 20.04
- Rocky* Linux 8, 9
- Red Hat* Enterprise Linux* (RHEL*) 8, 9
- SUSE Linux Enterprise Server* (SLES) 15 SP3, SP4
- Fedora* 36,37
- Debian* 9, 10, 11
- Amazon 2, 2022
- WSL 2
Linux* GPU Host (Xe-HPG or Xe-HPC architectures and higher)
- Ubuntu* LTS 22.04, 20.04
- Intel® Arc™ A-Series Graphics, Intel® Data Center GPU Flex Series
- Red Hat* Enterprise Linux* (RHEL*) 8.5
- Intel® Data Center GPU Flex Series
- Red Hat* Enterprise Linux* (RHEL*) 8.6
- Intel® Data Center GPU MAX Series, Intel® Data Center GPU Flex Series
- SUSE Linux Enterprise Server* (SLES) 15 SP3, SP4
- Intel® Data Center GPU MAX Series
Updates to OS and driver support for discrete GPU are occurring rapidly. Please see https://dgpu-docs.intel.com/ for OS support updates. To target discrete GPU, a compatible discrete GPU device is currently required both at client program build-time and at run-time. Intel® processor graphics Gen12, Intel® Iris Xe MAX(codename DG1) devices are not compatible with Render Kit.
Windows* CPU/GPU Host
- Windows* 10
- Windows* 11
- Windows* Server 2019, 2022
- Using Microsoft’s Windows Subsystem for Linux 2 (WSL2) in Windows 10 and Windows 11, you can install the native Linux distribution of Intel oneAPI toolkits and libraries on Windows for CPU and GPU workflows: Details.
macOS* CPU Only Host
- Intel® 64 based systems:
- macOS* 12.0 Monterey
- macOS* 13.0
- Apple* M1 based systems:
- macOS* 12.0 Monterey or higher
Supported Target Hardware Platforms
The following platforms are supported by most software components.
NOTE: Intel® 64 hardware platforms must support at least Intel® Streaming SIMD Extensions 4.2. Full software optimization is implemented for Intel® Advanced Vector Extensions 512. See ark.intel.com to search device capabilities.
- Intel® 64
- Intel Atom® processors
- Intel® Core™ processor family
- Intel® Xeon® processor family
- Intel® Xeon® Scalable processor family
- ARM
- Apple* M1
- Xe-HPG or Xe-HPC architectures and higher (Embree Only)
- Intel® Arc™ A-Series Graphics
- Intel® Data Center GPU MAX Series
- Intel® Data Center GPU Flex Series
Software Requirements
GPU support
Windows Intel® Graphics Driver
To install the driver follow the directions in the article appropriate for your device
- Intel® Arc™ A-Series Graphics (DG2)
- Intel® Data Center GPU Flex Series (ATS-M)
- Contact your OEM representative for access to the Intel Registration Center.
- Intel® processor graphics Gen12, Intel® Iris Xe MAX(codename DG1) devices are not compatible with Embree.
Linux General Purpose Intel GPUs (GPGPU) Driver
For all Intel GPUs, see this article, https://dgpu-docs.intel.com/, and follow the directions for your device.
Prerequisites
- Intel oneTBB version 2021.9 or higher (installed automatically with toolkit)
- Intel rkcommon library version 1.11.0 (installed automatically with toolkit)
- Discrete GPU support: Intel® oneAPI DPC++/C++ Compiler found in the Base Kit (explained in toolkit configuration instructions)
- Included: Intel® Implicit SPMD Program Compiler (Intel® ISPC) version 1.20.0 or higher (included)
- Required for Intel optimized CPU code paths
- A C99 and C++11 capable system compiler (C++17 or higher recommended)
Development Environment
Windows* OS:
- Microsoft Visual Studio* 2019 or higher is recommended
macOS*:
-
XCode* & XCode* command line tools
2023.1
Supported Operating Systems (Host and Target)
Linux* CPU Host
- Ubuntu* LTS 22.04, 20.04
- Rocky* Linux 8, 9
- Red Hat* Enterprise Linux* (RHEL*) 8, 9
- SUSE Linux Enterprise Server* (SLES) 15 SP3, SP4
- Fedora* 36,37
- Debian* 9, 10, 11
- Amazon 2, 2022
- WSL 2
Linux* GPU Host (Xe-HPG or Xe-HPC architectures and higher)
NOTE: As of 2023.1, only the Embree library component has discrete GPU support.
- Ubuntu* LTS 22.04, 20.04
- Intel® Arc™ A-Series Graphics, Intel® Data Center GPU Flex Series
- Red Hat* Enterprise Linux* (RHEL*) 8.5
- Intel® Data Center GPU Flex Series
- Red Hat* Enterprise Linux* (RHEL*) 8.6
- Intel® Data Center GPU MAX Series, Intel® Data Center GPU Flex Series
- SUSE Linux Enterprise Server* (SLES) 15 SP3, SP4
- Intel® Data Center GPU MAX Series
Updates to OS and driver support for discrete GPU are occurring rapidly. Please see https://dgpu-docs.intel.com/ for OS support updates. To target discrete GPU, a compatible discrete GPU device is currently required both at client program build-time and at run-time. Intel® processor graphics Gen12, Intel® Iris Xe MAX(codename DG1) devices are not compatible with Render Kit.
Known Issues
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/Distribution | Problem Occurs | Problem Does Not Occur |
RedHat Enterprise Linux | RHEL 8.4 (kernel 4.18.0-305) and older | RHEL 8.5 (kernel 4.18.0-348) |
SUSE Linux | SLES15 SP3 and older | SLES15 SP4 beta |
Ubuntu Linux | Ubuntu releases older than 20.04.03 | Ubuntu 20.04.03 (kernel 5.11.0-40-generic #44~20.04.2-ubuntu)* |
Workaround
- Preferred: 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: 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.
Windows* CPU/GPU Host
- Windows* 10
- Windows* 11
- Windows* Server 2019, 2022
- Using Microsoft’s Windows Subsystem for Linux 2 (WSL2) in Windows 10 and Windows 11, you can install the native Linux distribution of Intel oneAPI toolkits and libraries on Windows for CPU and GPU workflows: Details.
macOS* CPU Only Host
- Intel® 64 based systems:
- macOS* 12.0 Monterey
- macOS* 13.0
- Apple* M1 based systems:
- macOS* 12.0 Monterey or higher
Supported Target Hardware Platforms
The following platforms are supported by most software components.
NOTE: Intel® 64 hardware platforms must support at least Intel® Streaming SIMD Extensions 4.2. Full software optimization is implemented for Intel® Advanced Vector Extensions 512. See ark.intel.com to search device capabilities.
- Intel® 64
- Intel Atom® processors
- Intel® Core™ processor family
- Intel® Xeon® processor family
- Intel® Xeon® Scalable processor family
- ARM
- Apple* M1
- Xe-HPG or Xe-HPC architectures and higher (Embree Only)
- Intel® Arc™ A-Series Graphics
- Intel® Data Center GPU MAX Series
- Intel® Data Center GPU Flex Series
Software Requirements
GPU support
Windows Intel® Graphics Driver
To install the driver follow the directions in the article appropriate for your device
- Intel® Arc™ A-Series Graphics (DG2)
- Intel® Data Center GPU Flex Series (ATS-M)
- Contact your OEM representative for access to the Intel Registration Center.
- Intel® processor graphics Gen12, Intel® Iris Xe MAX(codename DG1) devices are not compatible with Render Kit.
Linux General Purpose Intel GPUs (GPGPU) Driver
For all Intel GPUs, see this article, https://dgpu-docs.intel.com/, and follow the directions for your device.
Prerequisites
- Intel oneTBB version 2021.8 or higher (installed automatically with toolkit)
- Intel rkcommon library version 1.11.0 (installed automatically with toolkit)
- Discrete GPU support: Intel® oneAPI DPC++/C++ Compiler found in the Base Kit (explained in toolkit configuration instructions)
- Included: Intel® Implicit SPMD Program Compiler (Intel® ISPC) version 1.19.0 or higher (included)
- Required for Intel optimized CPU code paths
- A C99 and C++11 capable compiler (C++17 recommended)
Development Environment
Windows* OS:
- Microsoft Visual Studio* 2019 or higher is recommended
macOS*:
-
XCode* & XCode* command line tools
2023.0
Supported Operating Systems (Host and Target)
NOTE: The following distributions are supported by most components. 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.
Linux* Host
- Ubuntu* LTS 22.04, 20.04
- Rocky* Linux 8, 9
- Arch Linux*
- Red Hat* Enterprise Linux* (RHEL*) 8, 9
- SUSE Linux Enterprise Server* (SLES) 15 SP3, SP4
- Fedora* 36,37
- Debian* 11
- Amazon 2022
Windows* Host
- Windows* 10
- Windows* 11
- Windows* Server 2019, 2022
macOS* Host
- Intel® 64 based systems:
- macOS* 12.0 Monterey
- macOS* 13.0
- Apple* M1 based systems:
- macOS* 12.0 Monterey or higher
Supported Target Hardware Platforms
The following platforms are supported by most software components.
NOTE: Intel® 64 hardware platforms must support at least Intel® Streaming SIMD Extensions 4.2. Full software optimization is implemented for Intel® Advanced Vector Extensions 512. See ark.intel.com to search device capabilities.
- Intel® 64
- Intel Atom® processors
- Intel® Core™ processor family
- Intel® Xeon® processor family
- Intel® Xeon® Scalable processor family
- ARM
- Apple* M1
Software Requirements
Prerequisites
- Included: Intel® oneAPI Threading Building Blocks (oneTBB) 2021.5.0 or higher
- Included: Intel® Implicit SPMD Program Compiler version 1.18.0
- Required for Intel optimized code paths
- A C99 and C++11 capable compiler (C++17 recommended)
Development Environment
Windows* OS:
- Microsoft Visual Studio* 2019 or higher is recommended
macOS*:
-
XCode* & XCode* command line tools
2022.x
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.