ayo/ipex-llm
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

Update BMG troubleshooting guides regarding PPA installation (#13119)

Browse source 
* Update bmg troubleshooting guides regarding PPA installation

* Small fix

* Update based on comments

* Small fix
This commit is contained in:
Yuwen Hu 2025-04-28 15:48:17 +08:00 committed by GitHub
parent ad741503a9
commit f66eee1d1d
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 19 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
docs/mddocs/Quickstart/bmg_quickstart.md
View file

@ -24,6 +24,8 @@ This guide demonstrates how to install and use IPEX-LLM on the Intel Arc B-Serie
3.4 [vLLM](#34-vllm) 3.4 [vLLM](#34-vllm)
4. [Troubleshooting](#4-troubleshooting) 4. [Troubleshooting](#4-troubleshooting)
4.1 [RuntimeError: could not create an engine](#41-runtimeerror-could-not-create-an-engine) 4.1 [RuntimeError: could not create an engine](#41-runtimeerror-could-not-create-an-engine)
4.2 [Connection timeout error when installing the intel-graphics PPA](#42-connection-timeout-error-when-installing-the-intel-graphics-ppa)
--- ---
## 1. Linux ## 1. Linux
@ -176,3 +178,19 @@ unset OCL_ICD_VENDORS
This will remove the conflicting environment variable and allow your program to function correctly. This will remove the conflicting environment variable and allow your program to function correctly.
**Note:** This issue only occurs on Linux systems. It does not affect Windows environments. **Note:** This issue only occurs on Linux systems. It does not affect Windows environments.
### 4.2 Connection timeout error when installing the intel-graphics PPA
While [installting prerequisites on Linux](#11-install-prerequisites), if you encounter a connection timeout error when adding the intel-graphics PPA, consider disabling IPv6 first through:
```bash
sudo sysctl -w net.ipv6.conf.all.disable_ipv6=1
sudo sysctl -w net.ipv6.conf.default.disable_ipv6=1
sudo sysctl -w net.ipv6.conf.lo.disable_ipv6=1
```
Afterward, disconnect and reconnect your network adapter before attempting the installation again.
> [!TIP]
> - The disabling of IPv6 by the above command is temporary and will be reverted after a system reboot.
> - You could find more information about this issue [here](https://github.com/intel/ipex-llm/issues/13112).