TuxDMX-WebUI/TROUBLESHOOTING.md

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__)"