Diagnose & Überwachung
CUCM-Knotendetails per SSH und SSH-Zugangsdaten
Version, Hardware, Netzwerk und Dienste eines CUCM-Knoten per SSH lesen; Zugangsdaten hinterlegen.
In EasyUC: EasyUC Cisco → Dashboard → CUCM-Knotenkarte → Details (SSH)
Wozu dient das
Über Details (SSH) liest EasyUC den Zustand eines einzelnen CUCM-Knotens direkt von dessen Plattform-CLI: aktive und inaktive Version, Hardware, IP-Konfiguration und DNS sowie den Status der Feature- und Network-Services. Das hilft, wenn ein Knoten auffällig ist und Sie wissen wollen, ob ein Dienst steht oder welche Version tatsächlich aktiv ist.
EasyUC verbindet sich dafür per SSH mit dem Knoten. Seit Version 4.8.3 müssen die SSH-Zugangsdaten eigens hinterlegt werden. Benötigt wird ein Plattform- bzw. OS-Administrator des CUCM, nicht der AXL-Benutzer. Das Kennwort wird verschlüsselt gespeichert und nie wieder angezeigt.
Beim ersten Kontakt speichert EasyUC den SSH-Host-Key des Knotens. Ändert sich der Schlüssel später, verbindet EasyUC nicht mehr und sendet kein Kennwort, bis ein Berechtigter den neuen Schlüssel geprüft und bestätigt hat.
Voraussetzungen
- Lizenzmodul
cucm. - Zum Ansehen: Recht CUCM-Knotendetails (SSH) ansehen (
ROLE_APP_CUCM_NODE_DETAILS). - Zum Hinterlegen, Ändern, Entfernen und Testen der Zugangsdaten sowie zum Bestätigen eines neuen Host-Keys: Recht SSH-Zugangsdaten ändern (
ROLE_APP_CUCM_NODE_DETAILS_EDIT). - Administratoren (
ROLE_APP_ADMIN,ROLE_OWNER,ROLE_ADMIN,ROLE_SUPER_ADMIN) haben beide Rechte. Helpdesk-Rollen erhalten sie nur, wenn sie im Rolleneditor ausdrücklich vergeben werden. - Benutzer ohne Administratorrolle sehen die Details nur für CUCM-Verbindungen, die ihnen zugewiesen sind.
- Ein Plattform-/OS-Administratorkonto des CUCM. Für IM&P-Knoten mit eigenem OS-Administrator lässt sich je Knoten ein abweichender Zugang hinterlegen.
- EasyUC erreicht den Knoten per SSH (Standardport 22). Der Knotenname aus dem CUCM muss aus EasyUC auflösbar sein, sonst tragen Sie eine Adresse ein.
Schritt für Schritt: SSH-Zugangsdaten hinterlegen
Schritt für Schritt: Geänderten Host-Key bestätigen oder Adresse eintragen
Felder und Optionen
| Feld / Aktion | Bedeutung und Verwendung |
|---|---|
| Benutzername / Kennwort | Plattform-/OS-Administrator des CUCM. Beim Ändern gilt: Kennwort leer lassen, um das gespeicherte zu behalten. |
| Gültig für | alle Knoten dieser CUCM-Verbindung oder nur diesen Knoten. Ein Zugang für einen einzelnen Knoten hat Vorrang. |
| Verbindung testen | Baut eine SSH-Verbindung auf und zeigt aktive Version und Host-Key. |
| Zugangsdaten entfernen | Löscht den hinterlegten Zugang. Für einen einzelnen Knoten gelten danach die Zugangsdaten der Verbindung, falls hinterlegt. |
| Adresse … | Manuelle IP-Adresse (IPv4 oder IPv6) oder auflösbarer Hostname des Knotens, ohne Port und ohne https://. Gilt für „Details (SSH)“ und für die Abfrage der Kachel CUCM Informationen. Zurücksetzen verwendet wieder den Namen aus dem CUCM. |
| Neuen Schlüssel übernehmen | Ersetzt den gespeicherten SSH-Host-Key des Knotens durch den jetzt gemeldeten. |
So lesen Sie die Detailseite
| Feld / Aktion | Bedeutung und Verwendung |
|---|---|
| Aktive Version / Inaktive Version | Laufende Softwareversion des Knotens und die Version der inaktiven Partition. |
| Hardware | Angaben der Plattform zur (virtuellen) Hardware. |
| IP-Konfiguration & DNS | Netzwerkeinstellungen des Knotens. |
| Feature- & Network-Services | Je Service der Status, wie ihn die Plattform meldet. „Keine Services zurückgegeben“ heißt, dass die Abfrage keine Liste lieferte. |
| SSH-Host | Adresse, über die EasyUC den Knoten anspricht, mit dem Zusatz „(manuell eingetragen)“ bei einer hinterlegten Adresse. |
| SSH-Host-Key | Fingerabdruck des Knotens mit Herkunft: „beim ersten Kontakt am … gespeichert“ oder „bestätigt am … von …“. |
| Zugangsdaten: … | Zeigt, ob die Zugangsdaten für alle Knoten der Verbindung oder nur für diesen Knoten gelten. |
Ergebnis prüfen und Fehler eingrenzen
- Erfolg erkennen Sie daran, dass die Detailseite Version, Hardware, Netzwerk und Services zeigt.
- „Für diesen Knoten sind keine SSH-Zugangsdaten hinterlegt.“ bzw. ohne Änderungsrecht „Zugangsdaten fehlen – bitte einen Administrator bitten …“: Zugangsdaten wie oben hinterlegen.
- „Anmeldung am Knoten abgelehnt – Benutzername oder Kennwort des OS-Administrators prüfen.“: Es wurde vermutlich der AXL-Benutzer statt des OS-Administrators eingetragen, oder das Kennwort ist falsch.
- „Der SSH-Schlüssel des Knotens hat sich geändert. Aus Sicherheitsgründen wurde keine Anmeldung versucht.“: Normal nach Neuinstallation oder Wiederherstellung des Knotens. Fingerabdruck prüfen und neuen Schlüssel übernehmen.
- „Die gespeicherten SSH-Zugangsdaten sind nicht mehr lesbar … und müssen neu eingegeben werden.“: Tritt nach einer Wiederherstellung auf eine andere Instanz auf. Zugangsdaten neu eingeben.
- „Die Adresse dieses Knotens ist neu oder wurde geändert. Aus Sicherheitsgründen sendet EasyUC das gespeicherte SSH-Kennwort erst dorthin, wenn es für diese Adresse erneut eingegeben oder mit Kennwort erfolgreich getestet wurde.“: Kennwort im Dialog erneut eingeben und testen.
- „Der Knoten ist per SSH nicht erreichbar.“: Firewall und SSH-Port zwischen EasyUC und Knoten prüfen.
- „Keine sichere SSH-Verbindung möglich (Schlüsselaustausch fehlgeschlagen).“: EasyUC unterstützt RSA-Host-Keys, wie der CUCM sie verwendet. Ein Ziel, das nur ECDSA oder Ed25519 anbietet, wird abgelehnt.
- „Der Knotenname ist ein Kurzname ohne Domain. Bitte im CUCM die IP-Adresse oder den FQDN als Servernamen pflegen.“: Adresse über Adresse … eintragen oder den Servernamen im CUCM korrigieren.
- Jede Verwendung von „Details (SSH)“ und jede Änderung an Zugangsdaten oder Host-Key steht im Änderungsprotokoll, ohne Kennwort.