From c1b634625c784bfe32fe55152b1b74c16e3f80ed Mon Sep 17 00:00:00 2001
From: Ratnam Parikh <114774508+ratnampa@users.noreply.github.com>
Date: Wed, 27 Mar 2024 19:28:02 -0700
Subject: [PATCH] [Docs] Update to Arc GPU documentation (experimental release)
(#2624)
Co-authored-by: Zhefeng, Qiao <zhefeng.qiao@intel.com>
---
.../experimental/install_for_arc_gpu.md | 56 ++++++++++++-------
1 file changed, 36 insertions(+), 20 deletions(-)
diff --git a/docs/install/experimental/install_for_arc_gpu.md b/docs/install/experimental/install_for_arc_gpu.md
index c38458ca..2223e2f9 100644
--- a/docs/install/experimental/install_for_arc_gpu.md
+++ b/docs/install/experimental/install_for_arc_gpu.md
@@ -20,11 +20,11 @@ Hardware Platforms with Experimental Only Support:
- For [Windows 10](https://www.microsoft.com/en-us/windows/get-windows-10) or [Windows 11](https://www.microsoft.com/en-us/windows/windows-11):
- [Windows Subystem for Linux 2](https://learn.microsoft.com/en-us/windows/wsl/about) (WSL2) with Ubuntu 22.04 (64-bit)
- - Windows GPU Drivers: [Intel® Arc™ Graphics Windows Driver 31.0.101.4953](https://www.intel.com/content/www/us/en/download/785597/intel-arc-iris-xe-graphics-windows.html) or later (installation instructions below)
+ - Windows GPU Drivers: [Intel® Arc™ Graphics Windows Driver 31.0.101.5333](https://www.intel.com/content/www/us/en/download/785597/intel-arc-iris-xe-graphics-windows.html) or later (installation instructions below)
- For Ubuntu Linux 22.04 within WSL2:
- - Linux Runtime Libraries: Intel® Arc™ GPU Drivers [736](https://dgpu-docs.intel.com/releases/stable_736_25_20231031.html) (installation instructions below)
- - Intel® oneAPI Base Toolkit 2024.0 (installation instructions below)
+ - Linux Runtime Libraries: Intel® Arc™ GPU Drivers [803](https://dgpu-docs.intel.com/releases/LTS_803.29_20240131.html) (installation instructions below)
+ - Intel® oneAPI Base Toolkit 2024.1 (installation instructions below)
- TensorFlow 2.15.0
- Python 3.9-3.11
- pip 19.0 or later (requires manylinux2014 support)
@@ -33,8 +33,8 @@ Hardware Platforms with Experimental Only Support:
- Ubuntu 22.04 (64-bit)
- Intel® GPU Drivers for Linux (installation instructions below)
- - Intel® Arc™ GPU Drivers [736](https://dgpu-docs.intel.com/releases/stable_736_25_20231031.html)
-- Intel® oneAPI Base Toolkit 2024.0 (installation instructions below)
+- Intel® Arc™ GPU Drivers [803](https://dgpu-docs.intel.com/releases/LTS_803.29_20240131.html)
+- Intel® oneAPI Base Toolkit 2024.1 (installation instructions below)
- TensorFlow 2.15.0
- Python 3.9-3.11
- pip 19.0 or later (requires manylinux2014 support)
@@ -53,7 +53,7 @@ When using WSL2, the GPU drivers are installed in the Windows OS and runtime com
|OS|Intel GPU|Install Intel GPU Driver|
|-|-|-|
-|Windows 10, Windows 11|Intel® Arc™ A-Series GPUs|[Intel® Arc™ Graphics Windows Driver 31.0.101.4953](https://www.intel.com/content/www/us/en/download/785597/intel-arc-iris-xe-graphics-windows.html)|
+|Windows 10, Windows 11|Intel® Arc™ A-Series GPUs|[Intel® Arc™ Graphics Windows Driver 31.0.101.5333](https://www.intel.com/content/www/us/en/download/785597/intel-arc-iris-xe-graphics-windows.html)|
Install the above Intel® Arc™ Graphics Windows DCH Driver in the Windows OS.
@@ -62,7 +62,7 @@ Install the above Intel® Arc™ Graphics Windows DCH Driver in the Windows OS.
|OS|Intel GPU|Install Intel Compute Runtime Components|
|-|-|-|
-|Ubuntu 22.04 installed in WSL2|Intel® Arc™ A-Series GPUs|Refer to the instructions below for package installation in Ubuntu 22.04. When installing the Intel® Arc™ A-Series GPU Drivers [736](https://dgpu-docs.intel.com/releases/stable_736_25_20231031.html), please be sure to append the specific version after components, as is done below.|
+|Ubuntu 22.04 installed in WSL2|Intel® Arc™ A-Series GPUs|Refer to the instructions below for package installation in Ubuntu 22.04. When installing the Intel® Arc™ A-Series GPU Drivers [803](https://dgpu-docs.intel.com/releases/LTS_803.29_20240131.html), please be sure to append the specific version after components, as is done below.|
The steps to install the runtime components in Ubuntu Linux (within WSL2) are:
@@ -70,8 +70,9 @@ The steps to install the runtime components in Ubuntu Linux (within WSL2) are:
```bash
sudo apt-get install -y gpg-agent wget
- wget -qO - https://repositories.intel.com/gpu/intel-graphics.key | sudo gpg --dearmor --output /usr/share/keyrings/intel-graphics.gpg
- echo "deb [arch=amd64,i386 signed-by=/usr/share/keyrings/intel-graphics.gpg] https://repositories.intel.com/gpu/ubuntu jammy client" | sudo tee /etc/apt/sources.list.d/intel.gpu.jammy.list
+ wget -qO - https://repositories.intel.com/gpu/intel-graphics.key |
+ sudo gpg --dearmor --output /usr/share/keyrings/intel-graphics.gpg
+ echo "deb [arch=amd64 signed-by=/usr/share/keyrings/intel-graphics.gpg] https://repositories.intel.com/gpu/ubuntu jammy/lts/2350 unified" | sudo tee /etc/apt/sources.list.d/intel-gpu-jammy.list
sudo apt-get update
```
@@ -79,13 +80,13 @@ The steps to install the runtime components in Ubuntu Linux (within WSL2) are:
```bash
sudo apt-get install \
- intel-igc-cm=1.0.206-736~22.04 \
- intel-level-zero-gpu=1.3.26918.50-736~22.04 \
- intel-opencl-icd=23.30.26918.50-736~22.04 \
- level-zero=1.13.1-719~22.04 \
- libigc1=1.0.14828.26-736~22.04 \
- libigdfcl1=1.0.14828.26-736~22.04 \
- libigdgmm12=22.3.10-712~22.04
+ intel-igc-cm \
+ intel-level-zero-gpu \
+ intel-opencl-icd \
+ level-zero \
+ libigc1 \
+ libigdfcl1 \
+ libigdgmm12
```
- Add the Intel® oneAPI library repositories to your Ubuntu installation:
@@ -109,11 +110,26 @@ The above commands install only runtime libraries for Intel® oneAPI that are us
|OS|Intel GPU|Install Intel GPU Driver|
|-|-|-|
-|Ubuntu 22.04|Intel® Arc™ A-Series GPUs| Refer to the instructions below for package installation in Ubuntu 22.04. When installing the Intel® Arc™ A-Series GPU Drivers [736](https://dgpu-docs.intel.com/releases/stable_736_25_20231031.html), please append the specific version after components, such as `sudo apt-get install intel-opencl-icd=23.30.26918.50-736~22.04`|
+|Ubuntu 22.04|Intel® Arc™ A-Series GPUs| Refer to the instructions below for package installation in Ubuntu 22.04.
The steps to install the runtime components in Ubuntu Linux are:
-- The Intel® Extension for TensorFlow* requires a specific set of drivers for native Linux. Please follow the instructions in [Installation Guides for Intel Arc GPUs](https://dgpu-docs.intel.com/installation-guides/ubuntu/ubuntu-jammy-arc.html). When installing the Intel® Arc™ A-Series GPU Drivers [736](https://dgpu-docs.intel.com/releases/stable_736_25_20231031.html), please be sure to append the specific version after components, such as `sudo apt-get install intel-opencl-icd=23.30.26918.50-736~22.04`|
+- The Intel® Extension for TensorFlow* requires a specific set of drivers for native Linux. Please follow the instructions in [Installation Guides for Intel Arc GPUs](https://dgpu-docs.intel.com/driver/installation.html). When installing the Intel® Arc™ A-Series GPU Drivers [803](https://dgpu-docs.intel.com/releases/LTS_803.29_20240131.html), setup the LTS repository and install runtime components.
+
+- Add the repositories.intel.com/graphics package repository to your Ubuntu installation:
+
+ ```bash
+ sudo apt-get install -y gpg-agent wget
+ wget -qO - https://repositories.intel.com/gpu/intel-graphics.key |
+ sudo gpg --dearmor --output /usr/share/keyrings/intel-graphics.gpg
+ echo "deb [arch=amd64 signed-by=/usr/share/keyrings/intel-graphics.gpg] https://repositories.intel.com/gpu/ubuntu jammy/lts/2350 unified" | sudo tee /etc/apt/sources.list.d/intel-gpu-jammy.list
+ sudo apt-get update
+ ```
+
+- Install the necessary runtime packages:
+ ```bash
+ sudo apt-get install intel-opencl-icd
+ ```
- Install the Intel® oneAPI libraries
@@ -201,10 +217,10 @@ If you prefer to have access to full Intel® oneAPI, you need to install at leas
Download and install the verified DPC++ compiler and oneMKL in Ubuntu 22.04.
```bash
-$ wget https://registrationcenter-download.intel.com/akdlm/IRC_NAS/20f4e6a1-6b0b-4752-b8c1-e5eacba10e01/l_BaseKit_p_2024.0.0.49564.sh
+$ wget https://registrationcenter-download.intel.com/akdlm/IRC_NAS/fdc7a2bc-b7a8-47eb-8876-de6201297144/l_BaseKit_p_2024.1.0.596.sh
# 3 components are necessary: DPC++/C++ Compiler, DPC++ Library and oneMKL
# if you want to run distributed training with Intel® Optimization for Horovod*, oneCCL is needed too (Intel® oneAPI MPI Library will be installed automatically as its dependency)
-$ sudo sh ./l_BaseKit_p_2024.0.0.49564.sh
+$ sudo sh ./l_BaseKit_p_2024.1.0.596.sh
```
For any more details, please follow the procedure in [Intel® oneAPI Base Toolkit](https://www.intel.com/content/www/us/en/developer/tools/oneapi/base-toolkit.html).