Skip to content

Commit

Permalink
[Docs] Update to Arc GPU documentation (experimental release) (#2624)
Browse files Browse the repository at this point in the history
Co-authored-by: Zhefeng, Qiao <zhefeng.qiao@intel.com>
  • Loading branch information
ratnampa and Dboyqiao committed Mar 28, 2024
1 parent d5e2d6e commit c1b6346
Showing 1 changed file with 36 additions and 20 deletions.
56 changes: 36 additions & 20 deletions docs/install/experimental/install_for_arc_gpu.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand All @@ -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)
Expand All @@ -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.

Expand All @@ -62,30 +62,31 @@ 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:

- 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,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
```

- Install the necessary runtime packages:

```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:
Expand All @@ -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

Expand Down Expand Up @@ -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).
Expand Down

0 comments on commit c1b6346

Please sign in to comment.