Felsökning

Alla kommandon körs på servern med sudo.

Läget just nu

sudo eurion-ctl status       # tjänsterna och infrastrukturen
sudo eurion-ctl status -v    # dessutom minne, disk och belastning
sudo eurion-ctl health       # stoppade containrar, omstarter, disk, databasanslutningar, säkerhetskopior
sudo eurion-ctl ps           # alla Eurion-containrar med status och avbildning

Så läser du eurion-ctl status

• healthy: tjänsten svarar på sin hälsokontroll.
• degraded: containern kör men svarar inte på /health.
• not found: containern finns inte. Det är normalt för funktioner som är avstängda i konfigurationen (till exempel ai-service, transcription-service och bridge-service), och sammanfattningen blir då Degraded trots att allt fungerar.

Den mest pålitliga kontrollen:

sudo docker ps --filter health=unhealthy --filter status=restarting

Är listan tom är alla containrar friska. eurion-minio-init som avslutats med kod 0 är normalt: den körs bara en gång.

Installerad version:

grep eurion_version /opt/eurion/deploy/generated/group_vars/all.yml

Loggar

sudo eurion-ctl logs                              # de senaste raderna från alla containrar
sudo eurion-ctl logs messaging-service            # följ en tjänst (Ctrl+C avslutar)
sudo eurion-ctl logs gateway --no-follow -n 500   # de senaste 500 raderna

Namnet är containerns namn utan eurion-. Exempel: gateway, identity-service, messaging-service, file-service, video-service, admin-service, traefik, postgres, coturn.

Andra loggar:

Logg	Var
Uppdateringar	/opt/eurion/logs/upgrade-<tid>.log, och upgrade-history.log med en rad per lyckad uppdatering
Uppdateringstjänsten	journalctl -u eurion-updater
Pågående eller senaste uppdatering från portalen	/var/lib/eurion-updater/job.log
Säkerhetskopior	/opt/eurion/logs/backup.log
Alla containrar, sökbart	Grafana → Explore → Loki, se Övervakning

Starta om

sudo eurion-ctl restart messaging-service   # en tjänst, väntar på hälsokontrollen
sudo eurion-ctl restart all                 # alla Eurion-tjänster
sudo eurion-ctl restart infra               # PostgreSQL, Redis, Kafka, MinIO, sök (kort avbrott)

Vanliga problem

Installationen stannar

Läs den sista uppgiften (TASK [...]) som Ansible skrev ut.

Meddelande	Orsak
Minimum 8GB RAM required / Minimum 4 CPU cores required	Servern är för liten, se krav.
Unsupported OS	Operativsystemet stöds inte.
Fel om avbildningar som saknas, eller pull access denied för eurion-…	eurion_version stämmer inte med installationsfilen, eller avbildningarna är inte inlästa (steg 6 i installationen).
Wait for each service to be healthy misslyckas	En tjänst startar inte. Titta i dess logg med eurion-ctl logs <tjänst> --no-follow.

Installationen går att köra igen när felet är åtgärdat. Lösenorden behålls.

Webbläsaren varnar för certifikatet

• Med tls.method: selfsigned är det väntat. Byt till letsencrypt.

• Med letsencrypt: kontrollera att namnet pekar på servern och att port 80 och 443 nås från internet. Titta i Traefiks logg:

  sudo eurion-ctl logs traefik --no-follow -n 200 | grep -i -E 'acme|certificate'

• Kontrollera vilket certifikat som lämnas ut:

  openssl s_client -connect app.example.se:443 -servername app.example.se </dev/null 2>/dev/null \
    | openssl x509 -noout -issuer -dates

Samtal kopplar upp men utan ljud eller bild

Nästan alltid portar eller adresser:

1. turn.example.se ska peka på serverns publika adress.
2. 3478 TCP/UDP, 49152–65535 UDP och 10000–10100 UDP ska vara öppna, se DNS och brandvägg.
3. server.public_ip ska vara den publika adressen och server.host serverns egen adress.
4. TURN-servern ska köra: sudo docker ps --filter name=eurion-coturn och sudo eurion-ctl logs coturn --no-follow -n 100.

Ingen e-post kommer fram

Se Utgående e-post.

Inga larm

Larm skickas bara om smtp.host är ifyllt. Se Övervakning.

Disken blir full

sudo eurion-ctl disk

Visar vad som tar plats och erbjuder att rensa oanvända Docker-resurser. Gamla versioners avbildningar tar du bort med eurion-ctl prune-images <gammal version> efter en lyckad uppdatering.

Uppdateringen misslyckas

Det du ser	Gör så här
Update to … failed, rolled back to …	Servern kör den gamla versionen igen. Öppna Log på sidan och skicka loggen till support.
Last check failed	Servern når inte uppdateringskanalen. Kontrollera utgående HTTPS till updates.eurion.se och journalctl -u eurion-updater.
latest.json is not signed by a trusted key eller BAD SIGNATURE	Installera inte. Kontakta support.
Can't be installed automatically: no bundle for version …	Det finns inget paket som passar din version. Kontakta support för ett fullständigt paket.
This account signs in with azure; password confirmation is not available	Logga in med ett lokalt superadministratörskonto.
Not enough disk	Frigör utrymme, se ovan.
Cannot reach the server hela tiden	Kontrollera systemctl status eurion-updater och sudo eurion-ctl status.
Sidan visar inget alls	Prova manuell uppdatering.

Samla information till ett supportärende

Kör det här och bifoga filen till ärendet:

OUT=/tmp/eurion-support-$(date +%Y%m%d-%H%M).txt
{
  echo "== Version";    grep eurion_version /opt/eurion/deploy/generated/group_vars/all.yml
  echo "== System";     uname -a; grep PRETTY_NAME /etc/os-release; nproc; free -h; df -h / /var/lib/docker
  echo "== Containrar"; docker ps -a --filter name=eurion- --format '{{.Names}}\t{{.Status}}\t{{.Image}}'
  echo "== Health";     eurion-ctl health
  echo "== Uppdateringar"; tail -n 20 /opt/eurion/logs/upgrade-history.log
  echo "== Senaste uppdateringslogg"; tail -n 200 "$(ls -1t /opt/eurion/logs/upgrade-*.log 2>/dev/null | head -1)"
  echo "== Updater";    journalctl -u eurion-updater --no-pager -n 100
} > "$OUT" 2>&1
echo "$OUT"

Kör blocket som root (sudo -i först). Lägg till loggen för den tjänst som krånglar:

sudo eurion-ctl logs <tjänst> --no-follow -n 500 > /tmp/<tjänst>.log 2>&1

Skicka aldrig lösenord

Bifoga inte secrets.yml, /opt/eurion/compose/.env, /etc/eurion/updater.json eller säkerhetskopior. Läs igenom filerna innan du skickar dem; ta bort lösenord och personuppgifter som syns i loggar.

Skriv också i ärendet:

• vad som hände och när (tid och tidszon),
• vad du gjorde precis innan (uppdatering, ändrad konfiguration, omstart),
• om det gäller alla användare eller några,
• felmeddelanden ordagrant eller som skärmbild.

Se Support.