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>
3.0 KiB
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)
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:
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:
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:
sudo scripts/enable-lan.sh
Błąd: 401 / Invalid API key
Przyczyna: Zły klucz w URL lub brak nagłówka.
Naprawa:
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
Błąd: Zmieniam .env w repo i nic się nie dzieje
Przyczyna: Produkcja czyta /opt/control-plane/.env, nie stacks/control-plane/.env.
Naprawa:
sudo nano /opt/control-plane/.env
sudo systemctl restart gpu-fan
Albo pełna reinstalacja kodu (nie nadpisuje istniejącego .env):
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:
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.
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.
Pełny reset (ostateczność)
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:
journalctl -u gpu-fan -f