75 lines
2.5 KiB
Markdown
75 lines
2.5 KiB
Markdown
# Troubleshooting
|
|
|
|
All rights reserved - Thomas / TuxiNet
|
|
|
|
## OLA kan ikke se USB
|
|
|
|
- Bekræft `lsusb`, `systemctl status olad` og at korrekt OLA-plugin er aktivt.
|
|
- Genstart OLA før du genpatcher porten i UI.
|
|
|
|
## Permission denied på `/dev/ttyUSB*`
|
|
|
|
- Sørg for at `tuxdmx` er medlem af `dialout` og `plugdev`.
|
|
- Bekræft udev-rettigheder eller device-ejerskab.
|
|
|
|
## Ingen DMX-output
|
|
|
|
- Bekræft universe, port og fixtureaddress.
|
|
- Kontroller, at blackout ikke er aktiv.
|
|
- Se DMX monitor for current/target/source.
|
|
|
|
## Flimren
|
|
|
|
- Reducér frame rate til 25 eller 30 fps.
|
|
- Kontroller at ingen overliggende effekt skriver LTP/HTP utilsigtet.
|
|
|
|
## Web UI virker ikke
|
|
|
|
- Kontroller `tuxdmx.service`.
|
|
- Brug `/api/v1/health` og se browser-konsol for WebSocket-fejl.
|
|
- Kør `systemctl status tuxdmx.service --no-pager --full`.
|
|
- Kør `journalctl -u tuxdmx.service -n 200 --no-pager`.
|
|
|
|
## Frontend-build eller pnpm fejler
|
|
|
|
- Kontroller `node --version` og bekræft Node 20.
|
|
- Kontroller `pnpm --version` og bekræft `10.28.2`.
|
|
- Kontroller at `package.json` har `packageManager: pnpm@10.28.2`.
|
|
- Hvis build skal genbruges fra en CI-artefakt, brug `--skip-frontend-build` kun naar `frontend/dist/index.html` allerede findes.
|
|
|
|
## No module named `app`
|
|
|
|
- Kontroller at backend er landet som `/opt/tuxdmx/backend/app`.
|
|
- Kontroller `test -f /opt/tuxdmx/backend/app/main.py`.
|
|
- Kør importtesten som servicebrugeren:
|
|
`sudo -u tuxdmx /opt/tuxdmx/.venv/bin/python -c "import sys; sys.path.insert(0, '/opt/tuxdmx/backend'); import app.main"`
|
|
|
|
## PermissionError på `frontend/dist` eller `data/backups`
|
|
|
|
- Installeren normaliserer rettigheder til `root:tuxdmx` for appkode og `tuxdmx:tuxdmx` for runtime-data.
|
|
- Kontroller `sudo -u tuxdmx test -r /opt/tuxdmx/frontend/dist/index.html`.
|
|
- Kontroller `namei -l /opt/tuxdmx/frontend/dist/index.html`.
|
|
|
|
## MixItUp timeout
|
|
|
|
- Bekræft at endpointet returnerer `202 Accepted`.
|
|
- Kontroller rate limiting, token og netværksrute.
|
|
|
|
## BPM finder forkert tempo
|
|
|
|
- Justér BPM-range og half/double.
|
|
- Brug syntetiske click tracks for at isolere lydinputproblemer.
|
|
|
|
## Databasefejl
|
|
|
|
- Kontroller diskplads og SQLite WAL-filer.
|
|
- Kør backup før restore eller manuel reparation.
|
|
- Kontroller at `tuxdmx` kan skrive til `/var/lib/tuxdmx`.
|
|
- Kontroller `sqlite3 /var/lib/tuxdmx/tuxdmx.db "PRAGMA integrity_check;"`.
|
|
|
|
## OLA kan ikke importeres i virtualenv
|
|
|
|
- Virtualenv skal oprettes med `python3 -m venv --system-site-packages /opt/tuxdmx/.venv`.
|
|
- Kontroller:
|
|
`sudo -u tuxdmx /opt/tuxdmx/.venv/bin/python -c "import ola; print(ola.__file__)"`
|