CUCM-Verbindung einrichten

Wozu dient das

Eine CUCM-Verbindung beschreibt, wie EasyUC einen Cisco Unified Communications Manager erreicht: Adresse des Publishers, AXL-Benutzer, AXL-Version und optional der Sprachbox-Server (Cisco Unity Connection). Jede Verbindung steht für einen CUCM-Cluster. Alle Arbeiten im Bereich EasyUC Cisco laufen über die Verbindung, die in der Kopfzeile ausgewählt ist.

Aus der eingetragenen Adresse leitet EasyUC selbst die Adressen für AXL, den Echtzeit-Dienst (RIS), Extension Mobility und die Protokollsammlung ab. Beim Speichern meldet sich EasyUC per AXL am CUCM an, liest die CUCM-Version und zählt Endbenutzer und Telefone. Ist ein Sprachbox-Server eingetragen, wird auch dessen Anmeldung geprüft.

Über Aktionen an einer Verbindung erreichen Sie alle weiteren Einstellungen dieses Clusters, zum Beispiel Namensregeln, CDR, CUCM-Sicherung und CUCM-Änderungsprotokoll. Diese Einträge haben eigene Kapitel.

Voraussetzungen

Anmeldung als Administrator (ROLE_APP_ADMIN). Anlegen und Ändern von Verbindungen ist keiner anderen Rolle zugeordnet.
Lizenz mit dem Modul cucm. Der Bereich Anrufbeantworter im Formular und die meisten Einträge unter Aktionen erscheinen nur, wenn die Lizenz die Bereitstellung (provisioning) enthält.
Ein Anwendungsbenutzer im CUCM mit AXL-Zugriff. Für die Knotenkarten auf dem Dashboard braucht er zusätzlich Serviceability-Rechte, zum Beispiel über die Gruppe „Standard CCM Server Monitoring“.
Der CUCM-Publisher ist von der EasyUC-Appliance aus per HTTPS erreichbar.
Für die Sprachbox: Benutzer, Passwort und Adresse des Unity-Connection-Servers sowie die Anrufbeantworter-Nummer.
Während der Ersteinrichtung lässt sich nur eine Verbindung anlegen. Weitere folgen nach Abschluss des Einrichtungsassistenten.

Schritt für Schritt: Verbindung anlegen

Wählen Sie in der Kopfzeile den Arbeitsbereich EasyUC Cisco.
Öffnen Sie im Menü Verwaltung → CUCM & Bereitstellung → CUCM-Verbindungen. Die Seite heißt CUCM-Verbindungen verwalten.
Klicken Sie oben rechts auf Erstellen. Der Dialog CUCM Verbindung erstellen öffnet sich.
Tragen Sie unter Alias einen eindeutigen Namen ein, zum Beispiel Zentrale.
Wählen Sie im Bereich CUCM die AXL-Version (11.5, 12.0, 12.5, 14.0 oder 15.0).
Tragen Sie AXL Benutzer und AXL Passwort ein.
Tragen Sie unter AXL-URL die Adresse des Publishers ein, zum Beispiel cucm-pub01.intern:8443. Ohne Angabe von https:// ergänzt EasyUC das Protokoll; ein Pfad wird verworfen.
Wählen Sie unter Einstellungen den Gerätetyp: Phones, Device Profiles oder Phones and Device Profiles.
Lassen Sie Interne Durchwahl (Ziffern) auf 0, oder tragen Sie eine Länge von 2 bis 10 ein, wenn interne Durchwahlen im Cluster eindeutig sind.
Setzen Sie bei Bedarf Kann sich ein Benutzer an mehreren Geräten anmelden? (nur sichtbar, wenn der Gerätetyp Device Profiles enthält) und Geräteaktivierungsdienst aktiviert?.
Wählen Sie den Standorttyp: Normal oder Custom Enduser Attribute. Bei Custom Enduser Attribute wählen Sie zusätzlich das Benutzerdefinierte Endbenutzer-Attribut und tragen unter Nummernbereiche mindestens einen Bereich mit Von und Bis ein.
Wenn ein Sprachbox-Server angebunden wird: Lassen Sie den Schalter im Bereich Anrufbeantworter eingeschaltet und füllen Sie Sprachbox Benutzer, Sprachbox Passwort, Sprachbox URL und Anrufbeantworter-Nummer aus. Ohne Sprachbox schalten Sie den Schalter aus.
Klicken Sie auf Speichern. EasyUC prüft die Anmeldung am CUCM und am Sprachbox-Server. Bei Erfolg schließt sich der Dialog, es erscheint die Meldung Success, und die Verbindung steht mit dem Kennzeichen aktiviert in der Liste.
Wählen Sie die neue Verbindung in der Kopfzeile aus, bevor Sie Standorte, Vorlagen oder Geräte bearbeiten.

Schritt für Schritt: Verbindung aktualisieren

Öffnen Sie EasyUC Cisco → Verwaltung → CUCM & Bereitstellung → CUCM-Verbindungen.
Klicken Sie in der Zeile der Verbindung auf Aktionen. Das Fenster Menü öffnet sich.

Originalansicht zur Anleitung Zu Schritt 2
Das geöffnete Aktionsmenü gehört zur ausgewählten CUCM-Verbindung. Der Eintrag „Verbindung bearbeiten“ führt zu den Verbindungswerten. Der Screenshot zeigt den Weg zur Bearbeitung.

EasyUC · Lab-/Demoumgebung
Aktionen einer CUCM-Verbindung

Das geöffnete Aktionsmenü der Laborverbindung führt zu „Verbindung bearbeiten“ und den einzelnen Funktionsoptionen. Die Aufnahme zeigt die Navigation, keine Zugangsdaten oder gespeicherte Änderung.
Klicken Sie auf Verbindung aktualisieren. Der Dialog Verbindung aktualisieren zeigt die gespeicherten Werte.
Ändern Sie die gewünschten Felder. Zusätzlich zum Anlegen-Dialog gibt es im Bereich Anrufbeantworter das Feld Sprachbox Profil der Leitung. Der Standorttyp lässt sich hier nicht mehr umstellen.
Klicken Sie auf Speichern. EasyUC meldet sich erneut per AXL an und liest Version und Zählerstände neu. Bei Erfolg erscheint die Meldung Success.

Schritt für Schritt: Verbindung deaktivieren oder aktivieren

Öffnen Sie EasyUC Cisco → Verwaltung → CUCM & Bereitstellung → CUCM-Verbindungen.
Klicken Sie in der Zeile der Verbindung auf Aktionen.
Klicken Sie auf Verbindung deaktivieren. Die Änderung gilt sofort, ohne Rückfrage. Das Kennzeichen in der Spalte Alias wechselt auf deaktiviert.
Bei einer deaktivierten Verbindung enthält das Menü nur noch Verbindung aktivieren. Ein Klick darauf schaltet sie wieder ein.
War die deaktivierte Verbindung in der Kopfzeile ausgewählt, wechselt EasyUC auf die nächste aktivierte Verbindung.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
Alias	Name der Verbindung in der Kopfzeile und in Listen. Pflichtfeld, muss eindeutig sein.
AXL-Version	Version der AXL-Schnittstelle: 15.0, 14.0, 12.5, 12.0 oder 11.5. Pflichtfeld. Nach dem Speichern zeigt die Liste die vom CUCM gemeldete Version.
AXL Benutzer / AXL Passwort	Anwendungsbenutzer des CUCM für AXL. Pflichtfelder. EasyUC prüft die Anmeldung beim Speichern.
AXL-URL	Adresse des Publishers als Hostname oder IP-Adresse, optional mit Port und `https://`. Pflichtfeld. EasyUC speichert nur Protokoll, Host und Port und hängt die Pfade der CUCM-Dienste selbst an.
Gerätetyp	Legt fest, womit die Verbindung arbeitet: `Phones` (Telefone), `Device Profiles` (Geräteprofile für Extension Mobility) oder `Phones and Device Profiles`. Standard: `Phones and Device Profiles`.
Interne Durchwahl (Ziffern)	`0` = deaktiviert (Standard). Mit 2 bis 10 Ziffern zeigt EasyUC bei E.164-Rufnummern auch Weiterleitungen auf die interne Durchwahl an. Nur verwenden, wenn diese Durchwahlen im CUCM-Cluster eindeutig sind. Der Wert `1` ist nicht erlaubt: „Bitte 0 oder eine Länge von 2 bis 10 eingeben.“
Kann sich ein Benutzer an mehreren Geräten anmelden?	Nur bei den Gerätetypen mit Device Profiles sichtbar. Standard: aus.
Geräteaktivierungsdienst aktiviert?	Standard: ein. Ist die Option gesetzt, bietet EasyUC beim Anlegen von Tischtelefonen (zum Beispiel beim Kopieren oder Umziehen von Benutzern und in der automatischen Bereitstellung) die Auswahl zur automatischen Registrierung an.
Standorttyp	`Normal`: Standorte werden über Nummernbereiche zugeordnet (Standard). `Custom Enduser Attribute`: Standorte werden über ein benutzerdefiniertes Endbenutzer-Attribut des CUCM zugeordnet. Nur beim Anlegen wählbar.
Benutzerdefiniertes Endbenutzer-Attribut	Nur bei Standorttyp `Custom Enduser Attribute`. EasyUC liest die im CUCM definierten Attribute aus. Pflichtfeld für diesen Standorttyp.
Nummernbereiche	Nur bei Standorttyp `Custom Enduser Attribute`. Mit Hinzufügen legen Sie weitere Bereiche an, mit entfernen löschen Sie einen. Von und Bis sind Pflicht und dürfen nur Ziffern enthalten, optional mit führendem `+`. Ein Bereich darf höchstens 1.000.000 Nummern umfassen.
Prüfen, ob ein Translation Pattern oder Route Pattern vorhanden ist	Option je Nummernbereich. Standard: aus.
Für das automatische Einfügen verwenden	Option je Nummernbereich. Der Bereich wird für die automatische Nummernvergabe verwendet. Standard: ein.
Einen kürzeren Nummernbereich für das automatische Einfügen verwenden?	Nur sichtbar, wenn das automatische Einfügen aktiv ist. Blendet ein zweites Paar Von/Bis ein, das die automatisch vergebenen Nummern weiter einschränkt.
Anrufbeantworter (Schalter)	Schaltet die Sprachbox-Anbindung der Verbindung ein oder aus. Nur mit Bereitstellungslizenz sichtbar. Beim Ausschalten in Verbindung aktualisieren entfernt EasyUC Benutzer, Passwort, URL und Einstellungen der Sprachbox aus der Verbindung.
Sprachbox Benutzer / Sprachbox Passwort / Sprachbox URL	Zugang zum Unity-Connection-Server. Pflichtfelder, sobald der Schalter eingeschaltet ist. Für die URL gilt dieselbe Schreibweise wie bei der AXL-URL.
Anrufbeantworter-Nummer	Rufnummer der Sprachbox (Voicemail-Pilot).
Sprachbox Profil der Leitung	Nur in Verbindung aktualisieren. Auswahl eines Voicemail-Profils aus dem CUCM.
Ist auf dem Sprachbox-Server LDAP konfiguriert?	Muss zur Verzeichnisanbindung des Unity-Connection-Servers passen. Standard beim Anlegen: ein.
Sprachbox-Mailbox aktivieren	„Der EasyUC-Benutzer kann die Sprachnachrichten des Endbenutzers sehen.“ Standard: aus.
Anonyme Nachrichten aktivieren	„Der EasyUC-Benutzer kann Angaben zur Sprachnachricht wie Anrufer-ID oder Anrufernummer nicht sehen.“ Standard: aus.

Spalten der Liste

Spalten der Liste
Feld / Aktion	Bedeutung und Verwendung
Alias	Name der Verbindung mit dem Kennzeichen aktiviert oder deaktiviert. Bei Standorttyp `Custom Enduser Attribute` zusätzlich Attribut und Nummernbereiche, bei eingeschalteter Teams-Anbindung MS-Teams-Präfix und MS-Teams-Kürzung.
CUCM	Host der AXL-Adresse, CUCM-Version (`v.` …) und die Zähler Endbenutzer, Endbenutzer mit Telefon und Telefone. Bei aktivierten Verbindungen außerdem CUCM-Lizenz: Fahren Sie mit der Maus darüber, erscheint Lizenzbedarf nach Typ mit den Spalten Typ und Aktuelle Nutzung; die letzte Zeile nennt den Zeitpunkt der letzten Aktualisierung.
Anrufbeantworter	Host des Sprachbox-Servers oder ein rotes Kreuz, wenn keine Sprachbox angebunden ist.
Tel.-Sicherheit / Dir-URI / Tel.-Steuerung / CDR	Haken oder Kreuz je Funktion. Bei eingeschaltetem CDR öffnet der Link Logs die CDR-Protokolle der Verbindung.
MoH-Server	Ausgewählte MoH-Server oder Alle.
CURRI	Info-Symbol mit der Adresse des globalen CURRI-Dienstes für diese Verbindung.
Endbenutzer-Seite	Status der Endbenutzer-Seite: aktiviert, Nur CFA, Anfrage, Telefonbuch und die drei Sprachbox-Bereiche.
Aktionen	Schaltfläche Aktionen mit dem Menü der Verbindung.

Ergebnis prüfen und Fehler eingrenzen

Nach dem Speichern zeigt die Spalte CUCM die gelesene Version und die Zähler. Stehen dort Werte, funktioniert die AXL-Anmeldung.
„Could not connect to CUCM server or username/password do not match“: Der CUCM lehnt die AXL-Anmeldung ab oder antwortet nicht auf AXL. Prüfen Sie Benutzer, Passwort, AXL-Version und die AXL-Rolle des Benutzers.
„Could not connect to host“: Die Adresse ist von der Appliance aus nicht erreichbar. Prüfen Sie Hostname, Port, DNS und Firewall.
„This value should not be blank.“ unter einem Feld: Pflichtfeld ausfüllen. Bei eingeschaltetem Anrufbeantworter sind auch Benutzer, Passwort und URL der Sprachbox Pflicht.
„You cannot have all connections disabled“: Die letzte aktivierte Verbindung lässt sich nicht deaktivieren.
„You can add just one connection during install“: Während der Ersteinrichtung ist nur eine Verbindung möglich.
Fehlt ein Eintrag unter Aktionen, ist die Verbindung deaktiviert oder die Lizenz enthält die Bereitstellung nicht.
Nach einem Zertifikatswechsel am CUCM schlagen Abfragen fehl, bis das neue Zertifikat übernommen ist. Siehe Kapitel „CUCM-Zertifikat prüfen und übernehmen“.