CDR-Eingang, Aufbewahrung und Export

Wozu dient das

Der CUCM schreibt zu jedem Anruf einen Call Detail Record (CDR) und überträgt die Dateien regelmäßig an einen Billing-Server. EasyUC stellt dafür je CUCM-Verbindung ein eigenes SFTP-Ziel bereit. Aus den empfangenen Dateien entstehen die Anrufauswertungen unter Berichte.

Beim Speichern legt EasyUC den FTP-Benutzer cdr- plus Verbindungs-ID mit einem eigenen Verzeichnis an und setzt das eingetragene Passwort. Die Hintergrundaufgabe cdr:import liest die eingegangenen Dateien ein (Standard: alle acht Minuten), übernimmt die Anrufe in die CDR-Datenbank und löscht die Datei danach.

Die Aufbewahrung ist begrenzt. Jede Nacht schreibt die Aufgabe cdr:csv alle Anrufe, die älter als die eingestellte Zahl von Tagen sind, in eine CSV-Datei und entfernt sie aus der Datenbank (Standard: 02:00 Uhr). Ist der Export eingeschaltet, überträgt EasyUC diese Datei per SFTP an Ihren Server und löscht sie danach lokal.

Voraussetzungen

• Lizenz mit dem Modul cucm und der Funktion provisioning. Ohne provisioning fehlt der Eintrag im Menü Aktionen.
• EasyUC-Konto mit der Rolle ROLE_APP_ADMIN. Nur Administratoren sehen das Menü Verwaltung.
• Die CUCM-Verbindung ist angelegt und aktiviert. Bei einer deaktivierten Verbindung zeigt Aktionen nur Verbindung aktivieren.
• Im CUCM ist EasyUC als Billing-Server für den CDR-Versand eingetragen, mit dem Benutzer cdr-<Verbindungs-ID> und dem hier vergebenen Passwort. Der Dialog zeigt den Benutzernamen und als Ziel sftp:// plus die Adresse der EasyUC-Appliance.
• Im CUCM ist das Schreiben von CDRs eingeschaltet (Service Parameter CDR Enabled Flag).
• Für den Export: ein SFTP-Server mit Benutzer und Passwort, den EasyUC erreicht.
• Die Hintergrundaufgaben cdr:import, cdr:csv und cdr:old:data sind unter Verwaltung → System & Betrieb → Hintergrundaufgaben aktiv.

Schritt für Schritt

1. Wählen Sie in der Kopfzeile den Arbeitsbereich EasyUC Cisco.
2. Öffnen Sie im Menü Verwaltung → CUCM & Bereitstellung → CUCM-Verbindungen. Die Seite CUCM-Verbindungen verwalten zeigt alle Verbindungen.
3. Klicken Sie in der Zeile der gewünschten Verbindung auf Aktionen. Das Popover Menü öffnet sich.
4. Klicken Sie auf CDR. Der Dialog CDR öffnet sich.
5. Schalten Sie Aktivieren ein. Die weiteren Felder erscheinen.
6. Wählen Sie unter Anzahl der zu anonymisierenden Ziffern einen Wert von 0 bis 15.
7. Notieren Sie den Benutzernamen aus der Überschrift des FTP-Bereichs (cdr- plus Verbindungs-ID). Das Feld FTP-Benutzer ist gesperrt.
8. Tragen Sie FTP-Passwort und FTP Passwort wiederholen ein.
9. Tragen Sie im Bereich Alte Daten löschen unter How many days to keep the data die Aufbewahrungsdauer in Tagen ein.
10. Sollen alte Daten vor dem Löschen gesichert werden, schalten Sie Gelöschte Daten auf einen sFTP-Server exportieren? ein und füllen Ftp Ip, FTP-Benutzer, FTP-Passwort und FTP Passwort wiederholen für Ihren Server aus.
11. Klicken Sie auf Speichern (oben rechts oder unten im Dialog). Der Dialog schließt sich und EasyUC zeigt eine Erfolgsmeldung („Success“). Mit Abbrechen verlassen Sie den Dialog ohne Änderung.
12. Tragen Sie im CUCM den Billing-Server mit Benutzer cdr-<Verbindungs-ID> und dem vergebenen Passwort ein.
13. Klicken Sie nach einigen Testanrufen in der Liste CUCM-Verbindungen verwalten in der Spalte CDR auf Logs und prüfen Sie die Register Ausstehende Dateien und Verarbeitete Dateien.

Schritt für Schritt: CDR-Datenbank sofort leeren

1. Öffnen Sie den Dialog CDR wie oben beschrieben.
2. Schalten Sie im Bereich Alte Daten löschen den Schalter CDR-Datenbank jetzt leeren? ein. Ein Warnhinweis erscheint: „Alle CDR-Dateien und alle Anrufe aus der CDR-Datenbank löschen“ und „Dieser Vorgang startet jetzt und läuft im Hintergrund“.
3. Klicken Sie auf Speichern. EasyUC startet die Aufgabe cdr:csv sofort. Sie schreibt alle Anrufe in eine CSV-Datei, entfernt sie aus der Datenbank und setzt den Schalter zurück.

Felder und Optionen

Ergebnis prüfen und Fehler eingrenzen

• Erfolg: In der Liste CUCM-Verbindungen verwalten zeigt die Spalte CDR den Status und den Link Logs. Der Dialog CDR-Logs zeigt unter Ausstehende Dateien eingegangene, noch nicht eingelesene Dateien mit Größe und Zeitpunkt, unter Verarbeitete Dateien die eingelesenen und unter Alte CDR-Daten die CSV-Dateien der Bereinigung.
• Ausstehende Dateien bleibt leer: Der CUCM liefert nichts. Prüfen Sie im CUCM den Billing-Server, Benutzername und Passwort sowie die Erreichbarkeit von EasyUC.
• Dateien bleiben unter Ausstehende Dateien liegen: Prüfen Sie unter Hintergrundaufgaben, ob cdr:import läuft, und sehen Sie in dessen Protokoll nach.
• Meldung „This value should not be blank.“ im Exportbereich: Bei eingeschaltetem Export sind Adresse, Benutzer und Passwort Pflicht.
• Das Speichern scheitert am Passwort: Passwort und Wiederholung stimmen nicht überein.
• Die CSV-Dateien kommen nicht auf dem Export-Server an: Die Anmeldung per SFTP ist fehlgeschlagen. Die Dateien bleiben dann lokal unter Alte CDR-Daten liegen.
• Berichte sind leer: Mögliche Ursachen sind fehlende Dateien, ein noch nicht gelaufener Import, der Zeitfilter des Berichts oder die Aufbewahrungsdauer.