Fehlersuche Troubleshooting Debugging

Probleme bei SIP oder RTP Verbindungen

Mit einem SSH-Fernzugriffsprogramm auf eine Serverkonsole zugreifen. (z.B. PuTTY oder das davon abgewandelte KiTTY für Windows)

Einloggen mit Benutzername gsmaster und dem bei der Installation vergebenen Passwort. Es können mehrere SSH-Sitzungen gleichzeitig gestartet werden - z.B. um FreeSWITCH Debuglog und SIP-Trace parallel anzusehen. PuTTY kann so konfiguriert werden, dass es nicht automatisch weiter scrollt wenn neue Daten auf den Bildschirm geschrieben wurden.

FreeSWITCH Debuglog ansehen:

Logdatei freeswitch.log ansehen:

• Logdatei mit Texteditor nano öffnen:
  nano /var/log/freeswitch/freeswitch.log

• Logdatei Liveansicht:
  tail -f -n 100 /var/log/freeswitch/freeswitch.log
  (zeigt live die 100 letzten Zeilen in der Logdatei an)

FreeSWITCH Konsole debugging:

• Meldungen beobachten:
  fs_cli
fsctl loglevel 7
  
  (Beides in einem: fs_cli -l 7 )
  
  Außerdem: console loglevel 7
  Liste der verschiedenen Loglevel:
  0 "CONSOLE", 1 "ALERT", 2 "CRIT", 3 "ERR", 4 "WARNING", 5 "NOTICE", 6 "INFO", 7 "DEBUG"

• Erweitertes Troubleshooting / Debugging:
  http://wiki.freeswitch.org/wiki/Troubleshooting_Freeswitch
  http://wiki.freeswitch.org/wiki/Debugging_Freeswitch

Trace der SIP-Pakete beobachten:

sudo tcpdump -i eth0 port 5060

oder mit Paketinhalt:

sudo tcpdump -i eth0 port 5060 -v

SIP - Perimeter Firewall abschalten (shorewall)

Hilfreich während Test- und Versuchsphasen, wenn Telefone wegen Fehlkonfigurationen schnell mal auf der Blacklist landen.

• temporär:
  sudo service shorewall stop

• permanent: z.B.:
  sudo nano /etc/shorewall/shorewall.conf gleich am Anfang den Parameter STARTUP_ENABLED auf NO setzen

• Blacklist:
  Die Daten der SIP - Perimeter Firewall werden zweigeteilt abgespeichert: Einmal in der Datenbank und zweitens die wirksam geblacklisteten IPs in der Datei:
  
  sudo nano /var/opt/gemeinschaft/firewall/blacklist
  Die zugehörige Webseite lautet: http://-GS5-IP-/intruders/

Weitere hilfreiche Befehle

• "dummes" Serverprogramm starten, was anstelle von FreeSWITCH auf UDP-Port 5060 hört und einfach nur eingehende Pakete anzeigt (vorher sudo service freeswitch stop):
  
  sudo nc -lup 5060

* aktuell laufende Netzwerkverbindungen:

`sudo lsof -i`

Um z.B. zu überprüfen ob alle Serverdienste auf der gewünschten Netzwerkkarte laufen/an die richtige IP gebunden sind:

• Active Internet connections (only servers) - IP und Port aufgelöst:
  
  sudo netstat -lptu

• Active Internet connections (only servers) - IP und Port numerisch:
  
  sudo netstat -tulpn

Routingprobleme analysieren

Routentest

Folgende versteckte Seite hilft beim testen der LUA Regex (Regular Expressions/Regüläre Ausdrücke): (Es darf nur eine Regex zutreffen sonst ist scheinbar nicht garantiert welche Route z.B. ein unmittelbarer Folgeanruf nach einem Anruf nimmt.)
http://-GS5-IP-/call_routes/test?sip_account_id=1&destination_number=%2b491234998877662&routing_table=outbound

Channel Variablen anzeigen (Interne Datenverwendung bei einem Anruf)

Dafür: http://-GS5-IP-/gs_parameters dump_variables -> true
Dann die FreeSWITCH Konsole aufrufen (siehe oben): fs_cli -l 7

Hinterher sollte der gs_paramter dump_variables wieder zurückgesetzt werden.

Weitere Infos:

• https://wiki.freeswitch.org/wiki/Variable_sip_to_user
• https://freeswitch.org/confluence/display/FREESWITCH/Channel+Variables
• https://freeswitch.org/confluence/display/FREESWITCH/Variables

Dateisystem durchforsten und GEMEINSCHAFT verstehen lernen:

Visuellen Dateimanager Midnight Commander installieren (beide Befehle ausführen):

sudo apt-get update

sudo apt-get install mc

Starten von Midnight Commander per Eingabe von mc. In einem SSH-Terminal gibt es sogar Mausunterstützung.

Debugging

Production images use lower debugging and logging settings to avoid too big logfiles. Additionally only static Ruby assets are used, dynamic creation is turned off for performance reasons. You may use command gs-change-state.sh to switch between development and production logging/debugging settings. The script will change settings for:

Gemeinschaft Ruby/Rails scripts
monAMI
Apache2 Passenger
FreeSwitch
Cron

Installtionseinstellungen nachträglich bearbeiten

Unter http://-GS5-IP-/tenants/2/edit kann man den:

• Tenanten-/Mandentennamen
• die -Beschreibung
• Land
• Sprache
• SIP-Domain
• Absender Sprachnachrichten
• Absender PIN Änderung
  ändern.