Zum Inhalt

Fehlersuche

Dieses Kapitel zeigt, wo Sie nachsehen, wenn etwas nicht funktioniert, und beschreibt typische Probleme mit ihrer Lösung.

Wo Sie nachsehen

Startseite

Die Startseite zeigt unter Systemzustand, ob Asterisk und der Manager (AMI) verbunden sind, wie viele Plätze belegt sind und den Zustand der Module. Unten links in der Navigation steht außerdem „Asterisk verbunden“ oder „Asterisk getrennt“.

Anrufe → Weg

Kam ein Anruf nicht dort an, wo er sollte, öffnen Sie Übersicht → Anrufe und klicken beim Anruf auf Weg. Sie sehen jeden Schritt mit Uhrzeit: welche Rufnummer, welcher Zeitplan, welche Ansage, welches Ziel. Oft zeigt das schon, dass etwa ein Zeitplan noch auf „Betriebsferien“ stand.

Unter System → Protokoll läuft live mit, was die Anlage tut. Dafür braucht niemand Zugang zum Server. Sie brauchen das Recht Protokoll ansehen.

Es gibt zwei Reiter:

  • Asterisk: das Protokoll des Telefonie-Kerns, also Anmeldungen, Anrufe, Fehler.
  • Anlage (Backend): Meldungen der Anlage selbst, etwa der Rufsteuerung.

Werkzeuge über dem Protokoll:

  • Filtern: zeigt nur Zeilen mit diesem Text, etwa einer IP-Adresse, einer Rufnummer oder trunk_1.
  • nur Warnungen und Fehler: blendet den Rest aus.
  • Anhalten / Weiter: friert die Anzeige ein, damit Sie in Ruhe lesen können.
  • Mülleimer: leert die Anzeige.

SIP-Mitschnitt

Oben auf der Seite Protokoll starten Sie einen SIP-Mitschnitt. Er schreibt alle SIP-Nachrichten ins Asterisk-Protokoll. So sehen Sie etwa, ob die Anmeldung eines Telefons überhaupt ankommt und was die Anlage antwortet.

  1. Unter Nur mit diesem Telefon / Anbieter eine IP-Adresse oder einen Namen eintragen. Leer heißt: alles.
  2. Die Dauer wählen: 2, 5, 15 oder 30 Minuten.
  3. Mitschnitt starten klicken.

Solange er läuft, steht oben „läuft“ mit der Restzeit. Danach schaltet er sich von selbst ab. Mit Stoppen beenden Sie ihn früher.

Nur mitschneiden, was Sie brauchen

Ein Mitschnitt ohne Filter erzeugt viele Zeilen. Tragen Sie die IP des Telefons oder den Server des Anbieters ein.

Meldet die Seite „Asterisk schreibt noch kein Protokoll für die Oberfläche“, starten Sie Asterisk einmal neu (auf dem Server im Verzeichnis /opt/fonaria: sudo docker compose restart asterisk).

Typische Probleme

Die Amtsleitung meldet sich nicht an

Der Punkt an der Leitung ist gelb, oben steht nicht „Registered“.

  1. Öffnen Sie die Leitung unter Anlage → Amtsleitungen. Unter dem Zustand steht der Grund in Worten, etwa „Benutzername oder Passwort falsch (SIP 401)“. Die Tabelle aller Meldungen steht im Kapitel Amtsleitungen.
  2. Beheben Sie die Ursache im Reiter Verbindung und klicken Sie auf Speichern. Die Leitung meldet sich sofort neu an.
  3. Hat Asterisk nach zu vielen Fehlversuchen aufgegeben, klicken Sie auf Neu anmelden.

Häufige Ursachen:

  • Zugangsdaten: Beim Einfügen ist ein Leerzeichen mitgekommen, oder Benutzername und Anmeldename sind beim Anbieter verschieden (Feld Anmeldename unter Erweiterte Einstellungen).
  • Falscher Server: Nehmen Sie die Vorlage des Anbieters, statt den Server abzutippen.
  • Keine Antwort vom Anbieter: Eine Firewall blockiert ausgehend UDP 5060, oder Port bzw. Transport stimmen nicht. Probieren Sie TCP.
  • Anbieter sperrt: Manche Anbieter sperren nach mehreren Fehlversuchen für eine Weile. Warten Sie und klicken Sie dann Neu anmelden.

Für Details starten Sie einen SIP-Mitschnitt mit dem Server des Anbieters als Filter und klicken währenddessen Neu anmelden.

Gespräch steht, aber kein Ton (oder nur in eine Richtung)

Das ist fast immer ein NAT-Problem.

  1. Prüfen Sie Einstellungen → Anlage → Router und NAT. Steht dort keine Öffentliche Adresse, klicken Sie auf Erkennen und speichern Sie. Ohne sie hört über die Amtsleitung keine Seite etwas.
  2. Hat sich Ihre öffentliche IP geändert (kein fester Anschluss), tragen Sie einen DynDNS-Namen ein.
  3. Liegt das Problem nur bei Telefonen außer Haus: Ist am Router der RTP-Bereich (10000–10200 UDP) an den Server weitergeleitet? Eine Firewall auf dem Server muss ihn ebenfalls zulassen.
  4. Liegt das Problem nur beim Softphone im Mobilfunk- oder Hotelnetz: Tragen Sie unter Softphone unterwegs einen TURN-Server ein.

Kein Ton im Softphone? Prüfen Sie im Desktop-Client unter Einstellungen → Audio:

  • Ist das richtige Mikrofon gewählt? Klicken Sie auf Testen und sprechen Sie drei Sekunden. Bewegt sich der Balken nicht, kommt vom Mikrofon nichts an. Prüfen Sie das Gerät und die Mikrofon-Berechtigung des Betriebssystems.
  • Ist unter Lautsprecher / Headset das richtige Gerät gewählt? Probeton muss im Headset zu hören sein.

Das Telefon meldet sich nicht an

Der Punkt am Telefon bleibt grau, oben steht „offline“.

  1. Prüfen Sie die Zugangsdaten am Telefon: Benutzername und Passwort genau wie unter Anlage → Telefone → Zugangsdaten. Im Zweifel mit Neu erzeugen ein neues Passwort setzen und neu eintragen.
  2. Prüfen Sie Server und Port am Telefon: Adresse der Anlage (wie unter Einstellungen → Anlage) und Port 5060.
  3. Ist der Haken Telefon aktiv gesetzt?
  4. Starten Sie einen SIP-Mitschnitt mit der IP des Telefons und starten Sie das Telefon neu:
    • Erscheint nichts, kommt die Anmeldung gar nicht an. Ursache ist das Netz: falsche Server-Adresse am Telefon, eine Firewall, ein anderes VLAN.
    • Antwortet die Anlage mit 401 oder 403, stimmen Benutzername oder Passwort nicht.

Ohne Weboberfläche können Sie auch direkt auf dem Server nachsehen, ob Pakete ankommen:

sudo tcpdump -n -i any udp port 5060 and host 192.168.1.57

Ersetzen Sie 192.168.1.57 durch die IP des Telefons. Erscheinen keine Zeilen, erreicht das Telefon den Server nicht.

„nicht erreichbar“

Steht beim Telefon „nicht erreichbar:“ mit Adresse, war es angemeldet, antwortet aber nicht mehr. Oft ist das Telefon ausgeschaltet oder hat eine neue IP-Adresse bekommen.

Das Telefon klingelt nicht

Das Telefon ist angemeldet, aber bei Anrufen passiert nichts.

  • Öffnen Sie das Telefon. Steht unter Darauf klingelt „Keine Rufnummer“, ist es beim Besitzer bei keiner Nummer angehakt. Ändern Sie das beim Benutzer im Reiter Rufnummern & Telefone.
  • Steht die Nummer dort als „stumm“, ist der Haken aus.
  • Hat der Benutzer Ruhe eingeschaltet oder eine Umleitung?
  • Hängt an der Rufnummer ein Zeitplan, der den Anruf gerade woandershin schickt? Die Übersicht des Zeitplans zeigt, was Jetzt gültig ist.
  • Den genauen Weg zeigt Anrufe → Weg.

Anrufe nach draußen scheitern

  • Gibt es eine Wählregel, die passt? Prüfen Sie es unter Amtsleitungen → Wählregeln → Regel testen mit der Nummer, wie sie gewählt wurde.
  • Ist die Amtsleitung angemeldet?
  • Lehnt der Anbieter die Absendernummer ab? Manche Anbieter erlauben nur ihre eigenen Nummern. Prüfen Sie Absenderkennung nach außen und die Angezeigte Rufnummer des Benutzers.

Desktop-Client verbindet sich nicht

  • Stimmt die Adresse unter Anlage im Anmeldefenster, mit http:// und Port, etwa http://192.168.1.10:8080?
  • Meldet der Client „Das Zertifikat der Anlage hat sich geändert“, wurde das Zertifikat erneuert (etwa nach einer neuen Adresse der Anlage). War das gewollt, klicken Sie unter Einstellungen auf Zertifikat der Anlage neu lernen und starten den Client neu.

Lizenz wird abgelehnt

  • Laden Sie die Originaldatei hoch, statt Text aus einer E-Mail einzufügen.
  • Vergleichen Sie den Prüfschlüssel unter System → Lizenz mit den Angaben Ihres Lizenzgebers. Passt er nicht, ist die Lizenz für eine andere Anlage ausgestellt.

Mehr dazu im Kapitel Lizenz.

Weboberfläche nicht erreichbar

Auf dem Server im Verzeichnis /opt/fonaria:

sudo docker compose ps
sudo docker compose logs --tail 100 backend

Der erste Befehl zeigt, ob alle Dienste laufen. Der zweite zeigt die letzten Meldungen der Anlage. Startet ein Dienst nicht, hilft oft:

sudo docker compose up -d