Easy UC für Cisco · Dokumentation

Einführung

Easy UC ist eine Virtual Appliance, die die Verwaltung Ihrer Cisco Unified Communications Umgebung radikal vereinfacht. Sparen Sie bis zu 90 % der manuellen Konfigurationsarbeit.

Konzept im Überblick

Hauptkomponenten

• Easy UC Core – Provisioning Engine, Web-Interface, Job-Scheduler
• LDAP-Sync-Service – Erkennt Änderungen in AD/LDAP in Echtzeit
• Template Engine – Verwaltet Konfigurations-Snapshots der CUCM-Geräte
• Enduser-Portal – Eigene Subdomain für Endbenutzer-Selbstverwaltung

Voraussetzungen

Easy UC benötigt einige technische Voraussetzungen, um in Ihrer CUCM-Umgebung zu funktionieren.

Virtual Machine

Cisco UC Umgebung

Netzwerk-Anforderungen

Easy UC kommuniziert mit verschiedenen Cisco-Services. Folgende Ports müssen von Easy UC zu CUCM erreichbar sein:

OVA-Installation

Die Installation von Easy UC erfolgt in wenigen Schritten. Die typische Setup-Zeit beträgt etwa 1 Stunde.

Schritt für Schritt

Netzwerk-Konfiguration

Nach dem ersten Boot konfigurieren Sie die statische IP-Adresse direkt in der VM-Konsole.

Statische IP setzen

1. Öffnen Sie die VM-Konsole in vSphere
2. Melden Sie sich mit dem Default-Konto an: easyuc / easyuc
3. Starten Sie das Netzwerk-Setup-Tool: sudo easyuc-network
4. Geben Sie die folgenden Werte ein:

Nach Bestätigung startet der Netzwerk-Stack neu. Easy UC ist anschließend unter der konfigurierten IP per Browser erreichbar.

Webinstaller

Der Webinstaller ist ein browser-basierter Wizard, der durch die initiale Konfiguration von Easy UC führt.

Konfigurationsphasen

Webinstaller aktualisieren

Easy UC und der Webinstaller werden in unabhängigen Zyklen aktualisiert. Über das Admin-Interface unter System → Updates kann der Webinstaller manuell auf die aktuellste Version gebracht werden.

Lizenzierung

Easy UC ist als Demo- und Produktivlizenz erhältlich. Beide gewähren den vollen Funktionsumfang.

Lizenztypen

Lizenz-Request erstellen

1. Im Webinstaller (oder unter System → License) auf „Lizenz-Request erstellen" klicken
2. Easy UC generiert eine signierte Anfrage mit Server-ID und gewünschten Modulen
3. Datei herunterladen und an unser Team senden
4. Innerhalb eines Werktages erhalten Sie die Lizenzdatei zurück
5. Im selben Menü unter „Lizenz einspielen" hochladen

Disk-Vergrößerung

Sollte die Disk durch CDR-Importe oder Logs voll werden, kann die virtuelle Disk vergrößert werden:

1. VM in vSphere herunterfahren
2. Unter VM-Hardware → Disk die neue Größe setzen
3. VM neu starten
4. In der Konsole: sudo easyuc-disk-extend ausführen
5. Das Filesystem wird automatisch erweitert

Locations

Locations bilden physische Standorte auf Cisco-CUCM-Konzepte wie Device Pools und Rufnummernbereiche ab.

Konzept

Jede Location bündelt:

• Geografische Daten (Stadt, Land, Adresse) – auch für Notfallrouting nutzbar
• CUCM Device Pool – auf den alle erstellten Geräte zugewiesen werden
• E.164-Nummernbereiche – aus denen Easy UC freie Rufnummern beim Onboarding zieht
• Default Package – die Konfiguration, die neue Benutzer dieses Standorts standardmäßig erhalten
• Zuweisungsregeln – nach welcher Logik werden Benutzer dieser Location zugeordnet

Drei Zuweisungs-Modi

Location erstellen

Packages & Templates

Templates sind Konfigurationsabbilder Ihrer CUCM-Geräte. Packages gruppieren Templates logisch.

Templates verstehen

Ein Template ist ein Snapshot eines existierenden CUCM-Geräts. Easy UC liest die komplette Gerätekonfiguration aus CUCM aus und speichert sie als Vorlage. Beim Provisioning eines neuen Geräts wird das Template kopiert und nur die benutzerspezifischen Felder (MAC, Description, Owner) überschrieben.

Templates werden empfohlen für jeden Gerätetyp und Standort:

• IP Phone Templates – Cisco 7841, 8841, 8851, 9971 etc.
• Softphone Templates – Jabber Windows (CSF), Mac (TCT), Mobile (TAB / BOT)
• Remote Destination Templates – für Single Number Reach

Template erstellen

1. Erstellen Sie ein Referenz-Gerät direkt im CUCM mit der gewünschten Konfiguration
2. In Easy UC unter Templates → New Template
3. Wählen Sie den Gerätetyp und das Quell-Gerät aus dem CUCM-Cluster aus
4. Easy UC liest die Konfiguration aus und speichert sie als Template
5. Benennen Sie das Template aussagekräftig (z.B. HH_8841_Standard)

Templates kopieren

Templates können zwischen Standorten dupliziert werden – ohne erneutes Anlegen eines Referenz-Geräts. Beim Kopieren werden standortspezifische Felder (Device Pool, CSS, Locations) automatisch auf den Zielstandort angepasst.

Packages verstehen

Ein Package ist eine logische Gruppe von Templates. Beispiele:

Pro Standort kann ein Default Package hinterlegt werden, das beim Auto User Setup automatisch verwendet wird.

Benutzer-Verwaltung

Die zentrale Benutzerseite zeigt alle Aspekte eines CUCM-Benutzers an einem Ort.

User Basics

Im Bereich <em>User Basics</em> verwalten Sie die zentralen Eigenschaften eines Benutzers, die normalerweise über das CUCM Admin-Interface gepflegt werden:

Directory Number Settings

Jede zugewiesene Rufnummer (Directory Number) hat eigene Einstellungen:

• Display Caller ID – Wie wird die Nummer beim Empfänger angezeigt
• External Phone Number Mask – Maskierung für ausgehende Anrufe
• Call Forward – No Answer, Busy, All Calls (Ziel und Voice Mailbox)
• Voicemail Profile – Welches Unity-Profil ist aktiv
• Calling Search Space – Welche Routen darf diese Nummer nutzen
• Maximum Number of Calls / Busy Trigger – Anrufverhalten

Geräte

Pro Benutzer können beliebig viele Geräte zugewiesen werden – IP Phones, Softphones und Remote Destinations.

Gerät anlegen

Phone Recreation

Wurde ein Gerät versehentlich aus CUCM gelöscht, kann es über die Funktion Recreate mit einem Klick wiederhergestellt werden. Easy UC speichert die letzte bekannte Konfiguration und kann sie 1:1 zurückspielen.

Pickup & Hunt Groups

Pickup Groups und Hunt Groups sind CUCM-Konzepte zur Anrufverteilung. Easy UC vereinfacht deren Verwaltung.

Pickup Groups

Eine Pickup Group ermöglicht das Annehmen eines Anrufs, der bei einem Kollegen klingelt – per Tastenkombination oder Soft-Key am Telefon.

• Im Benutzerprofil unter „Pickup Groups" kann der Benutzer einer oder mehreren Gruppen zugewiesen werden
• Neue Pickup Groups werden direkt im CUCM angelegt und stehen sofort zur Verfügung
• Easy UC zeigt für jede Pickup Group die zugewiesenen Mitglieder an

Hunt Groups

Eine Hunt Group verteilt eingehende Anrufe auf mehrere Mitglieder (Sequential, Longest Idle, Broadcast, Circular).

• Hunt Pilot, Hunt List und Line Group werden über Easy UC gemeinsam verwaltet
• Mitglieder können per Drag-and-Drop hinzugefügt oder entfernt werden
• Easy UC zeigt für jeden Benutzer auf einen Blick, in welchen Hunt Groups er Mitglied ist

Call Detail Records (CDRs)

CUCM erzeugt für jeden Anruf einen CDR. Easy UC importiert diese Daten und stellt sie direkt im Benutzerprofil dar.

Datenquelle

CDRs werden vom CUCM per FTP/SFTP an Easy UC übergeben. Im CUCM unter Serviceability → CDR Management wird Easy UC als Billing Server eingetragen. Easy UC importiert die Dateien stündlich und parst sie in die interne Datenbank.

Auswertungen

• Pro Benutzer – Anrufhistorie direkt im Benutzerprofil
• Hunt Group Reporting – Wie viele Anrufe gingen ein, wer hat angenommen, durchschnittliche Wartezeit
• Globale Berichte – Top-Anrufer, Top-Ziele, Auslastung pro Standort

Quick Tasks

Wiederkehrende Aufgaben sind als Quick Tasks verfügbar – mit wenigen Klicks erledigt.

Copy User – Schritt für Schritt

1. Wählen Sie den Quell-Benutzer aus
2. Klicken Sie auf Quick Tasks → Copy User
3. Wählen Sie den Ziel-Benutzer aus (muss bereits in LDAP existieren)
4. Selektieren Sie, welche Elemente übernommen werden:
   • ☑ Devices & Templates
   • ☑ Directory Number Settings
   • ☑ Pickup Groups / Hunt Groups
   • ☐ Voicemail Box (separate Provisionierung empfohlen)
5. Bestätigen – Easy UC führt alle Schritte automatisch durch

Auto User Setup

Sobald ein neuer Benutzer per LDAP in CUCM importiert wird, provisioniert Easy UC automatisch alle Ressourcen.

Workflow

LDAP-Namensänderungen synchronisieren

Wenn ein Benutzer in LDAP umbenannt wird (Hochzeit, Scheidung, etc.), erkennt Easy UC das beim nächsten Sync und aktualisiert automatisch:

• Display Name auf allen Geräten des Benutzers
• Caller ID-Konfiguration
• Display Caller ID auf Hunt Groups, in denen der Benutzer Mitglied ist
• Voicemail Display Name

Wizard / Bulk-Operationen

Für umfangreiche Rollouts oder Standort-Umzüge bietet Easy UC einen Wizard für Bulk-Aktionen.

Benutzer auswählen

userid,department,location
mmueller,Sales,Hamburg
aschmidt,Marketing,Berlin
tklein,Support,Hamburg

Bulk-Aktionen

• Apply Package – Ein Package auf alle ausgewählten Benutzer anwenden
• Move Location – Standort-Wechsel für alle (inkl. neuer Rufnummer aus dem Pool)
• Change Template – Template auf allen Geräten austauschen
• Add to Pickup/Hunt Group – Massenhafte Gruppenzuweisung
• Mass Voicemail Reset – PIN zurücksetzen, Mailbox neu initialisieren

Voicemail

Voicemail-Postfächer in Cisco Unity Connection lassen sich direkt aus Easy UC verwalten.

Voicemailbox erstellen

1. Im Benutzerprofil → Tab „Voicemail"
2. „Create Voicemailbox" anklicken
3. Template auswählen (z.B. Standard_DE mit deutscher Sprache und Standard-Grüßen)
4. Extension wird automatisch aus der primären Rufnummer übernommen
5. Initial-PIN wird automatisch generiert und kann per E-Mail an den Benutzer versendet werden

Greetings (Grüße)

Easy UC ermöglicht das zentrale Hochladen und Zuweisen von Voicemail-Grüßen:

• Standard Greeting – Reguläre Grußnachricht
• Closed Greeting – Außerhalb der Geschäftszeiten
• Busy Greeting – Bei besetzter Leitung
• Internal Greeting – Nur für interne Anrufer hörbar
• Alternate Greeting – Z.B. Urlaubsmeldung

Mailbox-Zugriff

Easy UC bietet einen Quick-Action „Send Mailbox Access Link" – der versendet eine E-Mail mit den Anmeldedaten und einem direkten Link zum Unity Connection Webinterface an den Benutzer.

Numberplan

Der grafische Numberplan visualisiert alle Rufnummern Ihres CUCM-Clusters auf einen Blick.

Funktionen

• Filter nach Standort – Nur Nummern des gewählten Standorts anzeigen
• Status – Frei / Belegt / Reserviert / Hunt Pilot / Conference Bridge etc.
• Zuweisung – Wer hat die Nummer, welches Gerät
• Free-Range-Anzeige – Auf einen Blick sehen, wo lückenhafte Bereiche entstanden sind
• Bulk-Reservation – Mehrere Nummern auf einmal für ein Projekt reservieren

Rufnummern in LDAP zurückschreiben

Easy UC kann zugewiesene Rufnummern automatisch in das LDAP-Attribut telephoneNumber (oder ein konfigurierbares Feld) zurückschreiben. So bleibt das Verzeichnis konsistent und Outlook / Teams zeigen die korrekten Nummern an.

Tägliche Provisioning-Aufgaben

Die häufigsten Provisioning-Aufgaben Schritt für Schritt erklärt.

Benutzer erstellen

Reguläre Benutzeranlage erfolgt über den LDAP-Sync und Auto User Setup. Manuelle Anlage:

1. Users → New User
2. UserID (muss eindeutig sein) und Anzeigename eingeben
3. Standort und Package wählen
4. Eventuelle Sonderwünsche (PIN, Sprache, Berechtigungen) anpassen
5. „Create" – Easy UC legt User & Geräte in CUCM an

Rufnummer ändern

1. Benutzer öffnen → Tab „Directory Number"
2. Aktuelle Nummer aus Dropdown wählen → „Change Number"
3. Neue Nummer aus dem Pool wählen (nur freie Nummern sichtbar)
4. Optional: LDAP-Eintrag aktualisieren-Checkbox aktivieren
5. Bestätigen – Easy UC aktualisiert DN auf allen Geräten und in CUCM

Namen auf Telefonen ändern

Easy UC aktualisiert den Display Name (z.B. nach Hochzeit) auf allen Geräten und Pickup/Hunt Groups eines Benutzers mit einem Klick. Quick Tasks → Update Display Name.

CallForward einstellen

1. Benutzer öffnen → Tab „Directory Number"
2. Im Bereich „Call Forward" eines der Profile wählen (All Calls / Busy / No Answer)
3. Ziel-Nummer eingeben (extern: mit Vorwahl, intern: nur Extension)
4. „Voice Mail" als Ziel ist über Checkbox direkt wählbar
5. Save – CUCM-Konfiguration wird sofort aktualisiert

Single Number Reach einrichten

SNR ermöglicht, dass ein eingehender Anruf auf der Bürorufnummer parallel auch auf dem Mobiltelefon klingelt:

1. Benutzer öffnen → Tab „Remote Destinations"
2. „+ Add Remote Destination" → Mobile Number eingeben
3. Optional: Klingelzeiten festlegen (z.B. nur Mo-Fr 08:00–18:00)
4. Template Mobile_SNR_Standard auswählen
5. Save – SNR ist sofort aktiv

Pickup / Hunt Group hinzufügen

Benutzer öffnen → Tab „Groups" → Gruppe per Suche selektieren → „Add". Easy UC aktualisiert die Mitgliederliste in CUCM in Echtzeit.

IP Phone ohne Benutzer

Für Konferenzraum-Telefone, Lobby-Phones etc. können Geräte ohne Benutzerzuordnung erstellt werden:

1. Devices → New Device → Standalone
2. Template wählen, MAC-Adresse eingeben
3. Beschreibung pflegen (z.B. „Konferenzraum Mond, 4. OG")
4. Optional: Pickup-Gruppe oder Hunt-Group-Mitgliedschaft

Endbenutzer-Portal

Das Self-Service-Portal gibt Endbenutzern Kontrolle über ihre eigene Konfiguration – ohne IT-Ticket.

Funktionen für Endbenutzer

Authentifizierung

Anmeldung erfolgt entweder per LDAP/AD (Single Sign-On) oder per SAML/OAuth mit Ihrem Identity Provider (Azure AD, Okta, Keycloak). Optional ist klassisches Login mit CUCM End-User-Credentials möglich.

Berechtigungen konfigurieren

Pro Standort oder pro Benutzergruppe kann eingestellt werden, welche Funktionen im Enduser-Portal verfügbar sind. So können z.B. Außendienstmitarbeiter SNR selbst aktivieren, während Innendienst nur Speed Dials konfigurieren darf.

Dashboard & Logs

Das Easy UC Dashboard bietet jederzeit Überblick über den Zustand der Umgebung.

Easy UC Logs

Alle Aktivitäten im System werden geloggt:

• Provisioning Log – Welche Geräte/User wurden wann angelegt/geändert/gelöscht
• Admin Audit – Wer hat sich angemeldet, welche Konfigurationsänderungen vorgenommen
• System Log – Verbindungsfehler, Service-Restarts, Update-Vorgänge
• API Calls – Eingehende und ausgehende API-Aufrufe (für Troubleshooting)

Automatically Setup Log

Spezielles Log für Auto User Setup. Zeigt für jede automatisch durchgeführte Provisionierung:

• LDAP-Sync-Zeitpunkt
• Erkannte neue Benutzer
• Anwendete Standort- und Package-Zuweisung
• Erstellte Geräte mit Erfolg/Fehler-Status
• Versendete E-Mail-Berichte

Phone Registration History

Welche Telefone sind aktuell beim CUCM registriert? Easy UC sammelt diese Information über die RIS-API:

• Status: Online / Offline / Unregistered
• Letzter Registrationszeitpunkt
• IP-Adresse des Telefons
• Firmware-Version
• Verbundener Switch-Port (LLDP)

Troubleshooting

AXL-Verbindung schlägt fehl

Ursache: Falsche Anmeldedaten oder fehlende Berechtigungen des Service-Users.
Lösung: Im CUCM sicherstellen, dass der Application User die Rollen Standard AXL API Access, Standard CCM Admin Users und Standard CTI Enabled hat. Passwort darf keine Sonderzeichen enthalten, die URL-Encoding benötigen.

LDAP-Sync findet keine Benutzer

Ursache: Search-Base zu restriktiv oder Bind-User ohne Leserechte.
Lösung: Search-Base auf höhere OU setzen, mit ldapsearch von der Easy UC Konsole testen, Bind-User-Berechtigungen prüfen.

Disk voll

Ursache: CDR-Import oder Logs füllen die Disk.
Lösung: Aufbewahrungsrichtlinien unter System → Retention anpassen, oder Disk wie unter „Disk-Vergrößerung" beschrieben erweitern.

Webinstaller startet nicht

Ursache: Veraltete Version oder beschädigte Installation.
Lösung: In der VM-Konsole sudo systemctl restart easyuc-webinstaller ausführen. Falls weiter Fehler: Easy UC Support kontaktieren.

Telefon zeigt „Configuration mismatch"

Ursache: Template-Konfiguration in Easy UC weicht von der TFTP-Konfiguration in CUCM ab.
Lösung: Im CUCM auf das Telefon klicken → „Apply Config" → „Reset". Easy UC syncronisiert die Konfiguration im Hintergrund neu.

Brauchen Sie weitere Hilfe?

Unser Support-Team unterstützt Sie bei allen Fragen rund um Setup und Betrieb. Während der Demo-Phase ist der Support vollständig kostenfrei. → Kontakt aufnehmen