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):
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.
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
To follow along and setup a server with intel descrete GPUs and base configuration:
Clone the repository:
git clone https://github/rahulunair/xpu_setupOptional 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 GPUsChange directory to base inside xpu_setup and follow the Readme.md inside 'base':
cd xpu_verify/baseAfter 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.
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.