tomasz-syn-grzegorza
359afb3a59
Infrastructure configs for GMKtec K11 (Docker, vLLM, LocalAI, ComfyUI, control-plane, gpu-fan agent, Server UI with CLI/file explorer/GPU fan curve). Co-authored-by: Cursor <cursoragent@cursor.com>
164 lines
3.0 KiB
Markdown
164 lines
3.0 KiB
Markdown
# Częste błędy GPU Fan
|
||
|
||
**Cel:** Naprawić typowe problemy bez zgadywania.
|
||
**Czas:** zależy od problemu (2–15 min)
|
||
**Wymagania:** Dostęp SSH do serwera, `sudo`
|
||
|
||
---
|
||
|
||
## Szybka diagnostyka (zrób to najpierw)
|
||
|
||
```bash
|
||
sudo systemctl status gpu-fan
|
||
nvidia-smi
|
||
scripts/status.sh
|
||
```
|
||
|
||
Skopiuj wynik jeśli dalej nie działa.
|
||
|
||
---
|
||
|
||
## Błąd: `Insufficient Permissions` w logach
|
||
|
||
**Przyczyna:** Program nie działa jako root.
|
||
|
||
**Naprawa:**
|
||
|
||
```bash
|
||
sudo systemctl restart gpu-fan
|
||
sudo systemctl status gpu-fan
|
||
```
|
||
|
||
Nie uruchamiaj `python app.py` bez sudo (chyba że `DRY_RUN=true` tylko do testów).
|
||
|
||
---
|
||
|
||
## Błąd: `address already in use` / port 8090 zajęty
|
||
|
||
**Przyczyna:** Dwie kopie programu naraz (najczęściej systemd + `scripts/start.sh`).
|
||
|
||
**Naprawa:**
|
||
|
||
```bash
|
||
sudo systemctl stop gpu-fan
|
||
sudo scripts/status.sh --cleanup
|
||
sudo systemctl start gpu-fan
|
||
```
|
||
|
||
**Nie zmieniaj portu na 8091** — to maskuje problem, nie go rozwiązuje.
|
||
|
||
---
|
||
|
||
## Błąd: Strona w przeglądarce się nie ładuje
|
||
|
||
| Sprawdź | Komenda |
|
||
|---------|---------|
|
||
| Usługa działa? | `sudo systemctl status gpu-fan` |
|
||
| Port nasłuchuje? | `ss -tlnp \| grep 8090` |
|
||
| LAN włączony? | `grep GPU_FAN_HOST /opt/control-plane/.env` → powinno być `0.0.0.0` |
|
||
| Firewall? | Upewnij się że LAN może dojść do 8090 |
|
||
|
||
Włącz LAN:
|
||
|
||
```bash
|
||
sudo scripts/enable-lan.sh
|
||
```
|
||
|
||
---
|
||
|
||
## Błąd: `401` / Invalid API key
|
||
|
||
**Przyczyna:** Zły klucz w URL lub brak nagłówka.
|
||
|
||
**Naprawa:**
|
||
|
||
```bash
|
||
grep ^API_KEY= /opt/control-plane/.env
|
||
```
|
||
|
||
Użyj w przeglądarce:
|
||
|
||
```
|
||
http://IP_SERWERA:8090/?api_key=KLUCZ_Z_PLIKU
|
||
```
|
||
|
||
Patrz: [02-OTWIERANIE-UI-W-PRZEGLADARCE.md](02-OTWIERANIE-UI-W-PRZEGLADARCE.md)
|
||
|
||
---
|
||
|
||
## Błąd: Zmieniam `.env` w repo i nic się nie dzieje
|
||
|
||
**Przyczyna:** Produkcja czyta **`/opt/control-plane/.env`**, nie `stacks/control-plane/.env`.
|
||
|
||
**Naprawa:**
|
||
|
||
```bash
|
||
sudo nano /opt/control-plane/.env
|
||
sudo systemctl restart gpu-fan
|
||
```
|
||
|
||
Albo pełna reinstalacja kodu (nie nadpisuje istniejącego `.env`):
|
||
|
||
```bash
|
||
sudo scripts/install.sh
|
||
```
|
||
|
||
---
|
||
|
||
## Błąd: `nvidia-smi` nie działa
|
||
|
||
**Przyczyna:** Brak / zły sterownik NVIDIA.
|
||
|
||
GPU Fan **nie naprawi** drivera. Najpierw napraw GPU w systemie, potem wróć do instalacji.
|
||
|
||
---
|
||
|
||
## Błąd: Po Ctrl+Z w terminalu port zajęty
|
||
|
||
**Przyczyna:** Proces zawieszony w tle nadal trzyma port.
|
||
|
||
**Naprawa:**
|
||
|
||
```bash
|
||
jobs -l # zobacz zawieszone
|
||
kill %1 # numer z jobs
|
||
# albo:
|
||
sudo scripts/status.sh --cleanup
|
||
```
|
||
|
||
---
|
||
|
||
## Błąd: Krzywa się nie zapisuje
|
||
|
||
Sprawdź format JSON — 3–7 punktów, temp unikalne, speed 0 lub 30–100.
|
||
|
||
```bash
|
||
sudo cat /etc/gpu-fan/curve.json
|
||
journalctl -u gpu-fan -n 30
|
||
```
|
||
|
||
---
|
||
|
||
## Błąd: Chcę uruchomić w Dockerze
|
||
|
||
**Odpowiedź:** Nie rób tego. Patrz [05-DLACZEGO-NIE-DOCKER.md](05-DLACZEGO-NIE-DOCKER.md).
|
||
|
||
---
|
||
|
||
## Pełny reset (ostateczność)
|
||
|
||
```bash
|
||
sudo systemctl stop gpu-fan
|
||
sudo scripts/status.sh --cleanup
|
||
cd ~/cursor/ubuntu-bare-metal/stacks/gpu-fan
|
||
sudo scripts/install.sh
|
||
sudo scripts/enable-lan.sh
|
||
sudo systemctl start gpu-fan
|
||
```
|
||
|
||
Logi:
|
||
|
||
```bash
|
||
journalctl -u gpu-fan -f
|
||
```
|