Réception, conservation et export des CDR

Objet

Le CUCM écrit un call detail record (CDR) pour chaque appel et transfère régulièrement les fichiers vers un serveur de facturation. À cet effet, EasyUC met à disposition une destination SFTP distincte par connexion CUCM. Les rapports d’appels sous Reporting sont construits à partir des fichiers reçus.

À l’enregistrement, EasyUC crée l’utilisateur FTP cdr- suivi de l’ID de connexion, avec son propre répertoire, et définit le mot de passe que vous avez saisi. Le job d’arrière-plan cdr:import lit les fichiers reçus (par défaut : toutes les huit minutes), transfère les appels dans la base de données CDR, puis supprime le fichier.

La conservation est limitée. Chaque nuit, le job cdr:csv écrit dans un fichier CSV tous les appels plus anciens que le nombre de jours configuré et les supprime de la base de données (par défaut : 02:00). Si l’export est activé, EasyUC transfère ce fichier vers votre serveur via SFTP, puis le supprime localement.

Prérequis

• Licence avec le module cucm et la fonction provisioning. Sans provisioning, l’entrée est absente du menu Actions.
• Compte EasyUC avec le rôle ROLE_APP_ADMIN. Seuls les administrateurs voient le menu Administration.
• La connexion CUCM a été créée et activée. Pour une connexion désactivée, Actions n’affiche que Enable Connection.
• Dans le CUCM, EasyUC est enregistré comme serveur de facturation pour la remise des CDR, avec l’utilisateur cdr-<ID de connexion> et le mot de passe attribué ici. La boîte de dialogue affiche le nom d’utilisateur et, comme destination, sftp:// suivi de l’adresse de l’appliance EasyUC.
• Dans le CUCM, l’écriture des CDR est activée (paramètre de service CDR Enabled Flag).
• Pour l’export : un serveur SFTP avec utilisateur et mot de passe, joignable par EasyUC.
• Les jobs d’arrière-plan cdr:import, cdr:csv et cdr:old:data sont actifs sous Administration → System & Operations → Background Jobs.

Procédure pas à pas

1. Dans l’en-tête, sélectionnez l’espace de travail EasyUC Cisco.
2. Dans le menu, ouvrez Administration → CUCM & Provisioning → CUCM Connections. La page Manage CUCM Connections liste toutes les connexions.
3. Dans la ligne de la connexion souhaitée, cliquez sur Actions. La fenêtre contextuelle Menu s’ouvre.
4. Cliquez sur CDR. La boîte de dialogue CDR s’ouvre.
5. Activez Enable. Les autres champs apparaissent.
6. Sous Number of Digits to make anonymous, sélectionnez une valeur de 0 à 15.
7. Notez le nom d’utilisateur indiqué dans le titre de la zone FTP (cdr- suivi de l’ID de connexion). Le champ FTP User est verrouillé.
8. Saisissez FTP Password et Ftp Retype Password.
9. Dans la zone Delete Old Data, saisissez la durée de conservation en jours sous How many days to keep the data.
10. Si les anciennes données doivent être sauvegardées avant leur suppression, activez Export Deleted Data to a sFTP Server? et renseignez Ftp Ip, FTP User, FTP Password et Ftp Retype Password pour votre serveur.
11. Cliquez sur Save (en haut à droite ou en bas de la boîte de dialogue). La boîte de dialogue se ferme et EasyUC affiche un message de réussite (« Success »). Cancel ferme la boîte de dialogue sans modification.
12. Dans le CUCM, enregistrez le serveur de facturation avec l’utilisateur cdr-<ID de connexion> et le mot de passe attribué.
13. Après quelques appels de test, cliquez sur Logs dans la colonne CDR de la liste Manage CUCM Connections et vérifiez les onglets Pending Files et Processed Files.

Procédure pas à pas : vider immédiatement la base de données CDR

1. Ouvrez la boîte de dialogue CDR comme décrit ci-dessus.
2. Dans la zone Delete Old Data, activez l’interrupteur Clear NOW CDR Database?. Un avertissement apparaît : « Delete all the CDR files and also delete all the calls from the CDR Database » et « This process will start now and run in the background ».
3. Cliquez sur Save. EasyUC démarre immédiatement le job cdr:csv. Il écrit tous les appels dans un fichier CSV, les supprime de la base de données et réinitialise l’interrupteur.

Champs et options

Vérifier le résultat et circonscrire les erreurs

• Réussite : dans la liste Manage CUCM Connections, la colonne CDR affiche l’état et le lien Logs. La boîte de dialogue CDR Logs affiche sous Pending Files les fichiers reçus qui n’ont pas encore été lus, avec leur taille et l’heure, sous Processed Files les fichiers qui ont été lus et sous Old CDR Data les fichiers CSV du nettoyage.
• Pending Files reste vide : le CUCM ne livre rien. Dans le CUCM, vérifiez le serveur de facturation, le nom d’utilisateur et le mot de passe, ainsi que la joignabilité d’EasyUC.
• Des fichiers restent sous Pending Files : sous Background Jobs, vérifiez que cdr:import s’exécute et consultez son journal.
• Message « This value should not be blank. » dans la zone d’export : lorsque l’export est activé, l’adresse, l’utilisateur et le mot de passe sont obligatoires.
• L’enregistrement échoue à cause du mot de passe : le mot de passe et sa confirmation ne correspondent pas.
• Les fichiers CSV n’arrivent pas sur le serveur d’export : la connexion SFTP a échoué. Les fichiers restent alors en local sous Old CDR Data.
• Les rapports sont vides : les causes possibles sont des fichiers manquants, un import qui ne s’est pas encore exécuté, le filtre de temps du rapport ou la durée de conservation.