Skip to content

Commit a113562

Browse files
crlishkariverliuintel
authored and
guizili0
committed
Update to Arc GPU documentation (experimental release) (#1677)
Co-authored-by: RiverLiu <[email protected]>
1 parent b07c765 commit a113562

File tree

1 file changed

+58
-67
lines changed

1 file changed

+58
-67
lines changed

‎docs/install/experimental/install_for_arc_gpu.md

+58-67
Original file line numberDiff line numberDiff line change
@@ -19,22 +19,23 @@ Hardware Platforms with Experimental Only Support:
1919
### Windows Subsystem for Linux 2 (WSL2)
2020

2121
- 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):
22-
- [Windows Subystem for Linux 2](https://learn.microsoft.com/en-us/windows/wsl/about) (WSL2) with Ubuntu 20.04 (64-bit)
22+
- [Windows Subystem for Linux 2](https://learn.microsoft.com/en-us/windows/wsl/about) (WSL2) with Ubuntu 22.04 (64-bit)
2323
- Windows GPU Drivers: [Intel® Arc™ Graphics Windows Driver 31.0.101.3490](https://www.intel.com/content/www/us/en/download/726609/intel-arc-graphics-windows-dch-driver.html) or later (installation instructions below)
2424

25-
- For Ubuntu Linux 20.04 within WSL2:
26-
- Linux Runtime Libraries: Intel® Arc™ GPU Drivers [419.40](https://dgpu-docs.intel.com/releases/stable_419_40_20220914.html) (installation instructions below)
27-
- Intel® oneAPI Base Toolkit 2022.3 (installation instructions below)
25+
- For Ubuntu Linux 22.04 within WSL2:
26+
- Linux Runtime Libraries: Intel® Arc™ GPU Drivers [540](https://dgpu-docs.intel.com/releases/stable_540_20221205.html) (installation instructions below)
27+
- Intel® oneAPI Base Toolkit 2023.0 (installation instructions below)
2828
- TensorFlow 2.11.0 or 2.10.0
2929
- Python 3.7-3.10
3030
- pip 19.0 or later (requires manylinux2014 support)
3131

3232
### Native Linux Running Directly on Hardware
3333

34-
- Ubuntu 20.04 (64-bit)
34+
- Ubuntu 22.04 (64-bit)
3535
- Intel® GPU Drivers for Linux (installation instructions below)
36-
- Intel® Arc™ GPU Drivers [419.40](https://dgpu-docs.intel.com/releases/stable_419_40_20220914.html)
37-
- Intel® oneAPI Base Toolkit 2022.3 (installation instructions below)
36+
- Intel® Arc™ GPU Drivers [540](https://dgpu-docs.intel.com/releases/stable_540_20221205.html)
37+
- Intel® oneAPI Base Toolkit 2023.0 (installation instructions below)
38+
3839
- TensorFlow 2.11.0 or 2.10.0
3940
- Python 3.7-3.10
4041
- pip 19.0 or later (requires manylinux2014 support)
@@ -44,7 +45,7 @@ Hardware Platforms with Experimental Only Support:
4445

4546
### 1. Install GPU Drivers
4647

47-
* #### Windows Subsystem for Linux 2 (WSL2)
48+
#### Windows Subsystem for Linux 2 (WSL2)
4849

4950
When using WSL2, the GPU drivers are installed in the Windows OS and runtime components such as [Level-Zero](https://github.com/oneapi-src/level-zero) are installed within Linux (in WSL2).
5051

@@ -53,7 +54,7 @@ When using WSL2, the GPU drivers are installed in the Windows OS and runtime com
5354

5455
|Release|OS|Intel GPU|Install Intel GPU Driver|
5556
|-|-|-|-|
56-
|v1.0.0|Windows 10, Windows 11|Intel® Arc™ A-Series GPUs|[Intel® Arc™ Graphics Windows DCH Driver](https://www.intel.com/content/www/us/en/download/726609/intel-arc-graphics-windows-dch-driver.html)|
57+
|v1.1.0|Windows 10, Windows 11|Intel® Arc™ A-Series GPUs|[Intel® Arc™ Graphics Windows DCH Driver](https://www.intel.com/content/www/us/en/download/726609/intel-arc-graphics-windows-dch-driver.html)|
5758

5859
Install the above Intel® Arc™ Graphics Windows DCH Driver in the Windows OS.
5960

@@ -62,82 +63,72 @@ Install the above Intel® Arc™ Graphics Windows DCH Driver in the Windows OS.
6263

6364
|Release|OS|Intel GPU|Install Intel Compute Runtime Components|
6465
|-|-|-|-|
65-
|v1.0.0|Ubuntu 20.04 installed in WSL2|Intel® Arc™ A-Series GPUs|Refer to the instructions below for package installation in Ubuntu 20.04. When installing the Intel® Arc™ A-Series GPU Drivers [419.40](https://dgpu-docs.intel.com/releases/stable_419_40_20220914.html), please be sure to append the specific version after components, as is done below.|
66+
|v1.1.0|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 [540](https://dgpu-docs.intel.com/releases/stable_540_20221205.html), please be sure to append the specific version after components, as is done below.|
6667

67-
The steps to install the runtime components in Ubuntu Linux (within WSL2) are:
68+
The steps to install the runtime components in Ubuntu Linux (within WSL2) are:
6869

69-
- Add the repositories.intel.com/graphics package repository to your Ubuntu installation:
70+
- Add the repositories.intel.com/graphics package repository to your Ubuntu installation:
7071

71-
```bash
72-
sudo apt-get install -y gpg-agent wget
73-
wget -qO - https://repositories.intel.com/graphics/intel-graphics.key |
74-
sudo gpg --dearmor --output /usr/share/keyrings/intel-graphics.gpg
75-
echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/intel-graphics.gpg] https://repositories.intel.com/graphics/ubuntu focal main' | \
76-
sudo tee /etc/apt/sources.list.d/intel.gpu.focal.list
77-
sudo apt-get update
78-
```
72+
```bash
73+
sudo apt-get install -y gpg-agent wget
74+
wget -qO - https://repositories.intel.com/graphics/intel-graphics.key | sudo gpg --dearmor --output /usr/share/keyrings/intel-graphics.gpg
75+
echo 'deb [arch=amd64,i386 signed-by=/usr/share/keyrings/intel-graphics.gpg] https://repositories.intel.com/graphics/ubuntu jammy arc' | sudo tee /etc/apt/sources.list.d/intel.gpu.jammy.list
76+
sudo apt-get update
77+
```
7978

80-
- Install the necessary runtime packages:
79+
- Install the necessary runtime packages:
8180

82-
```bash
83-
sudo apt-get install \
84-
intel-opencl-icd=22.28.23726.1+i419~u20.04 \
85-
intel-level-zero-gpu=1.3.23726.1+i419~u20.04 \
86-
level-zero=1.8.1+i419~u20.04
87-
```
81+
```bash
82+
sudo apt-get install \
83+
intel-opencl-icd=22.43.24595.35+i538~22.04 \
84+
intel-level-zero-gpu=1.3.24595.35+i538~22.04 \
85+
level-zero=1.8.8+i524~u22.04
86+
```
8887

89-
- Add the Intel® oneAPI library repositories to your Ubuntu installation:
88+
- Add the Intel® oneAPI library repositories to your Ubuntu installation:
9089

91-
```bash
92-
wget -O- https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB |
93-
sudo gpg --dearmor --output /usr/share/keyrings/oneapi-archive-keyring.gpg
94-
echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/oneapi all main" | \
95-
sudo tee /etc/apt/sources.list.d/oneAPI.list
96-
sudo apt-get update
97-
```
90+
```bash
91+
wget -O- https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB | sudo gpg --dearmor --output /usr/share/keyrings/oneapi-archive-keyring.gpg
92+
echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/oneapi all main" | sudo tee /etc/apt/sources.list.d/oneAPI.list
93+
sudo apt-get update
94+
```
9895

99-
- Install the necessary Intel® oneAPI library packages:
96+
- Install the necessary Intel® oneAPI library packages:
10097

101-
```bash
102-
sudo apt-get install \
103-
intel-oneapi-runtime-dpcpp-cpp=2022.2.0-8734 \
104-
intel-oneapi-runtime-mkl=2022.2.0-8748
105-
```
98+
```bash
99+
sudo apt-get install intel-oneapi-runtime-dpcpp-cpp intel-oneapi-runtime-mkl
100+
```
106101

107-
The above commands install only runtime libraries for Intel® oneAPI which are used by the Intel® Extension for TensorFlow*. If you would instead prefer to install full Intel® oneAPI, see section [Optional: Install Full Intel® oneAPI Base Toolkit Packages](#optional-install-full-intel®-oneapi).
102+
The above commands install only runtime libraries for Intel® oneAPI which are used by the Intel® Extension for TensorFlow*. If you would instead prefer to install the full Intel® oneAPI, see section [Optional: Install Full Intel® oneAPI Base Toolkit Packages](#optional-install-full-intel®-oneapi).
108103

109104

110-
* #### Native Linux Running Directly on Hardware
105+
#### Native Linux Running Directly on Hardware
111106

112107
|Release|OS|Intel GPU|Install Intel GPU Driver|
113108
|-|-|-|-|
114-
|v1.0.0|Ubuntu 20.04|Intel® Arc™ A-Series GPUs| Refer to the instructions below for package installation in Ubuntu 20.04. When installing the Intel® Arc™ A-Series GPU Drivers [419.40](https://dgpu-docs.intel.com/releases/stable_419_40_20220914.html), please append the specific version after components, such as `sudo apt-get install intel-opencl-icd=22.28.23726.1+i419~u20.04`|
109+
|v1.1.0|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 [540](https://dgpu-docs.intel.com/releases/stable_540_20221205.html), please append the specific version after components, such as `sudo apt-get install intel-opencl-icd_22.43.24595.35+i538~22.04_amd64.deb`|
115110

116-
The steps to install the runtime components in Ubuntu Linux are:
111+
The steps to install the runtime components in Ubuntu Linux are:
117112

118-
- The Intel® Extension for TensorFlow* requires a specific set of drivers for native Linux. Please follow the instructions in [Installation Guides for Intel Data Center GPU Flex Series](https://dgpu-docs.intel.com/installation-guides/ubuntu/ubuntu-focal-dc.html) and use the *Stable Release* for driver installation. When installing the Intel® Arc™ A-Series GPU Drivers [419.40](https://dgpu-docs.intel.com/releases/stable_419_40_20220914.html), please be sure to append the specific version after components, such as `sudo apt-get install intel-opencl-icd=22.28.23726.1+i419~u20.04`|
113+
- 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 [540](https://dgpu-docs.intel.com/releases/stable_540_20221205.html), please be sure to append the specific version after components, such as `sudo apt-get install intel-opencl-icd_22.43.24595.35+i538~22.04_amd64.deb`|
119114

120-
- Install the Intel® oneAPI libraries
115+
- Install the Intel® oneAPI libraries
121116

122-
- Add the Intel® oneAPI library repositories to your Ubuntu installation:
117+
- Add the Intel® oneAPI library repositories to your Ubuntu installation:
123118

124-
```bash
125-
wget -O- https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB |
126-
sudo gpg --dearmor --output /usr/share/keyrings/oneapi-archive-keyring.gpg
127-
echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/oneapi all main" | \
128-
sudo tee /etc/apt/sources.list.d/oneAPI.list
129-
sudo apt-get update
130-
```
119+
```bash
120+
wget -O- https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB | sudo gpg --dearmor --output /usr/share/keyrings/oneapi-archive-keyring.gpg
121+
echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/oneapi all main" | sudo tee /etc/apt/sources.list.d/oneAPI.list
122+
sudo apt-get update
123+
```
131124

132-
- Install the necessary Intel® oneAPI library packages:
125+
- Install the necessary Intel® oneAPI library packages:
133126

134-
```bash
135-
sudo apt-get install \
136-
intel-oneapi-runtime-dpcpp-cpp=2022.2.0-8734 \
137-
intel-oneapi-runtime-mkl=2022.2.0-8748
138-
```
127+
```bash
128+
sudo apt-get install intel-oneapi-runtime-dpcpp-cpp intel-oneapi-runtime-mkl
129+
```
139130

140-
The above commands install only runtime libraries for Intel® oneAPI which are used by the Intel® Extension for TensorFlow*. If you would instead prefer to install full Intel® oneAPI, see section [Optional: Install Full Intel® oneAPI Base Toolkit Packages](#optional-install-full-intel®-oneapi).
131+
The above commands install only runtime libraries for Intel® oneAPI which are used by the Intel® Extension for TensorFlow*. If you would instead prefer to install the full Intel® oneAPI, see section [Optional: Install Full Intel® oneAPI Base Toolkit Packages](#optional-install-full-intel®-oneapi).
141132

142133

143134
### 2. Install TensorFlow* via PyPI Wheel in Linux
@@ -147,9 +138,9 @@ The following steps can be used to install the TensorFlow framework and other ne
147138

148139
#### Install TensorFlow
149140

150-
The Python development and virtual environment setup recommendation by TensorFlow to isolate package installation from the system.
141+
The Python development and virtual environment setup recommendation by TensorFlow is to isolate package installation from the system.
151142

152-
The Intel® Extension for TensorFlow* requires stock TensorFlow, and the version should be == 2.11.0 or 2.10.0.
143+
The Intel® Extension for TensorFlow* requires stock TensorFlow, and the version should be >= 2.10.0.
153144

154145
* ##### Virtual environment install
155146

@@ -162,14 +153,14 @@ The Intel® Extension for TensorFlow* requires stock TensorFlow, and the version
162153

163154
To install in virtual environment, you can run
164155
```bash
165-
(tf)$ pip install tensorflow==2.11.0
156+
(tf)$ pip install 'tensorflow>=2.10.0'
166157
```
167158

168159
* ##### System environment install
169160

170161
If want to system install in $HOME, please append `--user` to the commands.
171162
```bash
172-
$ pip install --user tensorflow==2.11.0
163+
$ pip install --user 'tensorflow>=2.10.0'
173164
```
174165
And the following system environment install for Intel® Extension for TensorFlow* will use the same practice.
175166

@@ -200,7 +191,7 @@ If you prefer to have access to full Intel® oneAPI you need to install at least
200191

201192
- Intel® oneAPI Math Kernel Library (oneMKL)
202193

203-
Download and install the verified DPC++ compiler and oneMKL in Ubuntu 20.04.
194+
Download and install the verified DPC++ compiler and oneMKL in Ubuntu 22.04.
204195

205196
```bash
206197
$ wget https://registrationcenter-download.intel.com/akdlm/irc_nas/18852/l_BaseKit_p_2022.3.0.8767_offline.sh

0 commit comments

Comments
 (0)