Start / Administration

Administration und Betrieb

Für IT und Betrieb · Aufbau, Sicherheit, Dienste, Updates, Fehlersuche

1. Aufbau und Datenflüsse

Alle Verbindungen zwischen ERP und 3CX baut das ERP auf, per HTTPS auf Port 443. Die Telefonanlage meldet sich nie von sich aus beim ERP. Dadurch kann das ERP im internen Netz bleiben, und auf der 3CX läuft keine Zusatzsoftware, die ein Update der Anlage überstehen müsste.

2. Sicherheitskonzept

3. Hintergrunddienste und Zeitpläne

Die Scheduler-Jobs laufen nur, wenn der Frappe-Scheduler der Site aktiv ist (bench --site … scheduler status).

4. Der Listener im Betrieb

Steuern

sudo supervisorctl status frappe-3cx-callcontrol
sudo supervisorctl restart frappe-3cx-callcontrol

Ein Neustart ist jederzeit unkritisch. Beim Beenden gibt der Listener seine Sperre sofort frei, der neue Prozess übernimmt ohne Wartezeit. Beim Start liest er die gerade laufenden Gespräche ein, sodass auch Anrufe während des Neustarts korrekt enden.

Nur ein aktiver Listener

Je Site ist immer nur ein Listener aktiv, abgesichert über eine Sperre im Redis-Cache. Startet ein zweiter Prozess, etwa auf einem weiteren Anwendungsserver, wartet er im Zustand Bereitschaft und springt ein, wenn der erste ausfällt.

Verbindungsabbrüche

Reißt die Verbindung zur 3CX ab, zum Beispiel bei einem Update der Anlage, versucht der Listener es erneut: zuerst nach 5 Sekunden, dann mit wachsendem Abstand bis höchstens 5 Minuten. Anrufe aus dieser Zeit ergänzt der 5-Minuten-Abgleich.

Die zweite Verbindung, auf die das Popup angewiesen ist, ist die zwischen Browser und ERP-Server (Realtime über node-socketio). Frappe selbst versucht nach einem Abbruch nur dreimal, sie wieder aufzubauen; danach bekäme ein offener Tab bis zum Neuladen keine Ereignisse mehr, ohne dass der Benutzer etwas merkt. Die Integration prüft deshalb in jedem Tab alle 15 Sekunden die Verbindung und baut sie bei Bedarf neu auf, auch nach Ruhezustand oder Netzwechsel. Ein Neustart von node-socketio ist trotzdem ein Eingriff, der alle Tabs kurz trennt, siehe Updates.

Status und Protokolle

Den aktuellen Zustand zeigt Status des Listeners in den Einstellungen:

Die Statusseite

ThreeCX → 3CX Status (/app/threecx-status) fasst alles zusammen, was für Popups stimmen muss: Zustand des Listeners, Zahl der verbundenen Browser und je Benutzer mit Nebenstelle, ob das ERP geöffnet ist, ob die Realtime-Verbindung steht und ob das Popup eingeschaltet ist, dazu die letzten Anrufe mit Zuordnung. Grundlage ist ein Lebenszeichen, das jeder geöffnete ERP-Tab einmal pro Minute und bei jedem Verbindungswechsel an den Server schickt; wer länger als zweieinhalb Minuten nichts gemeldet hat, gilt als geschlossen. Die Seite dürfen alle Desk-Benutzer sehen, sie ist bei Meldungen wie „bei mir kam kein Popup" der schnellste Weg zur Ursache.

Zum Mitlesen bei einem Testanruf:

tail -f ~/frappe-bench/logs/frappe_3cx.callcontrol.log

5. Updates

cd ~/frappe-bench
bench --site erp.example.com backup
cd apps/frappe_3cx && git pull && cd ../..
bench --site erp.example.com migrate
bench build --app frappe_3cx
bench --site erp.example.com clear-cache
sudo supervisorctl restart frappe-bench-web: frappe-bench-workers: frappe-3cx-callcontrol

Neu gestartet werden nur Web, Worker und der Listener. Nicht restart all verwenden: Das startet auch node-socketio und Redis neu und trennt damit alle offenen Browser-Tabs von den Live-Ereignissen. Ältere Tabs ohne die Selbstheilung bekommen dann bis zum Neuladen kein Popup mehr. Mehrere Änderungen lieber bündeln, als mehrmals hintereinander durchzustarten.

Die Oberflächen-Dateien tragen nach dem Build einen neuen Namen, deshalb laden die Browser die neue Version beim nächsten Seitenaufruf automatisch. Bis dahin läuft in offenen Tabs noch der alte Stand. Nach Änderungen an der Oberfläche die Benutzer deshalb einmal um Strg+F5 bitten.

6. Testsysteme und Backups

• Für ein Testsystem in der 3CX einen eigenen API-Zugang anlegen.
• Wird ein Backup des Produktivsystems als Testsystem eingespielt, übernimmt es die produktiven Zugangsdaten. Direkt nach dem Einspielen dort die Integration deaktivieren oder die Zugangsdaten austauschen, bevor Scheduler und Listener laufen.
• Den Telefonbuch-Abgleich immer nur von einem System aus betreiben. Zwei Systeme würden sich die verwalteten Einträge gegenseitig überschreiben.

7. Einstellungen im Überblick

8. Fehlersuche

Hilfe bei der Einrichtung oder im Betrieb gibt es bei itsdave.