rahulunair / xpu_setup

Setup Ubuntu 22.04 with Intel dGPUs and components from Intel OneAPI

Unofficial Setup Guide for Intel discrete GPU on Linux*

This guide provides step-by-step instructions for setting up an Intel discrete GPUs on Ubuntu 22.04. The repository contains a series of scripts that automate the configuration process, making it easier and more efficient. Depending on your specific dGPU, you can use one of the following branches:

- For Intel Data Center GPU Max Series (PVC) setup, use the 'main' branch (default).
- For Intel Arc (Alchemist) GPUs setup, use the 'arc' branch.
- For Intel Data Center GPU Flex Series (ATS) setup, use the 'flex' branch.

Select one from (default is 'main' for GPU Max):

Prerequisites

Make sure to setup the base operating system on your machine using a variant of Ubuntu 22.04 (Jammy). For servers, download the Ubuntu 22.04 cloud image (jammy). Additionally, ensure that your machine is connected to the internet before proceeding.

xpu_setup Repository Structure

The essential components for setting up a GPU device in the repo has the following structure:

File Name	Description
├── LICENSE
├── Readme.md
├── base
│   ├── 01_init_setup.sh	Initialize the server
│   ├── 02_kernel_setup.sh	Install and setup the required kernel version
│   ├── 03_gpu_drivers_setup.sh	Install the Intel GPU drivers, runtimes
│   ├── 04_hold-packages.sh	Prevent package updates from breaking compatibility
│   ├── 05_env_dev_utils_setup.sh	Setup the reqd tools & env (use '--no-docker' flag to not install docker)
│   ├── 06_conda_setup.sh	Install and configure the Conda package manager
│   ├── 07_basekit_setup.sh	Install the required development toolkits
│   ├── 08_motd_setup.sh	Customize the server login message
│   ├── 09_cleanup.sh	Clean up any unnecessary packages and files
│   └── Readme.md
├── test.md
└── utils

└── update_kernel.py

How to setup and configure the base image.

To follow along and setup a server with intel descrete GPUs and base configuration:

Clone the repository:

git clone https://github/rahulunair/xpu_setup

Optional step:

Switch branch to 'arc' or 'flex' if you are setting up either Intel Arc GPUs or Intel Data Center GPU Flex Series.

git checkout arc # for Intel Arc GPUs

Change directory to base inside xpu_setup and follow the Readme.md inside 'base':

cd xpu_verify/base

After the setup is complete, you can verify if the GPU is setup correctly using the tool xpu_verify.Additionally, you can use clinfo and hwinfo to confirm that the GPU can be successfully enumerated.

Conclusion

The provided documentation covers each step in detail, ensuring a smooth setup process. If you encounter any issues during the setup or have any questions, please do not hesitate to raise an issue on the GitHub repository. This will help us improve the documentation and address any potential problems promptly.

* I have tried to be as faithful as I can to the official guide, but added some additional bits to make life easier.