So erfassen Sie Traces für CUCM 9.x oder höher
Inhalt
Einführung
Voraussetzungen Anforderungen
Verwendete Komponenten Hintergrundinformationen
Installieren der RTMT-Anwendung
Detaillierte Ablaufverfolgung für den CallManager-Dienst konfigurieren oder bestätigen Detaillierte Ablaufverfolgung für den CTI Manager-Service konfigurieren oder bestätigen Reproduzieren Sie das Problem, und nehmen Sie Notizen auf.
Sammeln der angeforderten Spuren
Nachverfolgungsdateiabdeckung überprüfen
Hinzufügen eines Ablaufverfolgungspakets zu Ihrer Serviceanfrage Analyse
Zusammenfassung
Einführung
In diesem Dokument werden die Schritte beschrieben, die Sie beim Aufzeichnen der
Ablaufverfolgung von Cisco Unified Communications Manager (CUCM/CallManager) effizient unterstützen. Ein gängiges Szenario wird zur Veranschaulichung verwendet.
Voraussetzungen
Anforderungen
Cisco empfiehlt, über Kenntnisse in folgenden Bereichen zu verfügen:
RTMT-Anwendung (Real-Time Monitoring Tool)
●
Detaillierte Ablaufverfolgung für den CallManager-Service
●
Detaillierte Nachverfolgung des CTI Manager-Service
●
Verwendete Komponenten
Die Informationen in diesem Dokument basieren auf aktuellen Versionen von CUCM.
Versionen vor CUCM 9.x finden Sie unter Erfassen von CUCM-Traces von CUCM 8.6.2 für einen TAC-SR.
Die Informationen in diesem Dokument wurden von den Geräten in einer bestimmten
Laborumgebung erstellt. Alle in diesem Dokument verwendeten Geräte haben mit einer leeren
(Standard-)Konfiguration begonnen. Wenn Ihr Netzwerk in Betrieb ist, stellen Sie sicher, dass Sie die potenziellen Auswirkungen eines Befehls verstehen.
Hintergrundinformationen
Wenn Sie bei einem Communications Manager-Problem mit einem Technical Assistance Engineer (TAC) zusammenarbeiten, müssen Sie möglicherweise CUCM-Ablaufverfolgungen erfassen. Dies kann eine Aufgabe sein, die Sie selten oder noch nie zuvor erledigt haben.
In diesem Szenario beheben Sie Anrufe, die nicht aufgezeichnet wurden, obwohl die CUCM- seitige Konfiguration scheinbar korrekt ist. Der Administrator erhält für jeden Anruf, der nicht
aufgezeichnet werden konnte, eine Warnmeldung. Der TAC-Techniker hat Sie daher gebeten, das Problem zu reproduzieren und detaillierte CallManager-Ablaufverfolgungen, detaillierte CTI
Manager-Ablaufverfolgungen und Event Viewer-Protokolle von der CUCM-Seite zu sammeln.
Diese Protokolle erfassen die Anrufsignalisierungsereignisse, die CTI-Nachrichten, die mit dem Server ausgetauscht werden, der die Anrufe aufzeichnet, und die Alarme des Anrufs, der nicht aufgezeichnet werden konnte.
Um diese Aufgabe durchzuführen, müssen Sie:
Installieren der RTMT-Anwendung
●
Detaillierte Ablaufverfolgungen für den CallManager-Dienst konfigurieren oder bestätigen
●
Detaillierte Ablaufverfolgungen für den CTI Manager-Service konfigurieren oder bestätigen
●
Reproduzieren Sie das Problem, und nehmen Sie Notizen auf.
●
Erfassen der angeforderten Ablaufverfolgungen
●
Überprüfung der Ablaufverfolgungsdateiabdeckung
●
Anhängen eines Ablaufverfolgungspakets an Ihre Dienstanforderung
●
Installieren der RTMT-Anwendung
In CUCM wird die RTMT-Anwendung zum Erfassen von Ablaufverfolgungen für die meisten Problemtypen verwendet. Jede Haupt- und Nebenversion von CUCM verfügt über eine
zugeordnete Version der RTMT-Anwendung. Wenn Sie auf Ihrem PC unter Start > Programme >
Cisco keine Unified RTMT-Programmgruppe sehen oder wenn die RTMT-Version nicht mit Ihrem CUCM-Cluster übereinstimmt, müssen Sie das RTMT-Tool für Ihre CUCM-Version installieren, bevor Sie fortfahren.
Melden Sie sich auf der Cisco Unified CM-Verwaltungsseite an.
1.
Wählen Sie Anwendung > Plugins aus.
2.
Klicken Sie auf Suchen.
3.
Klicken Sie auf den Download-Link für das Cisco Unified Real-Time Monitoring Tool - Windows-Plugin.
4.
Speichern Sie die Datei CcmServRtmtPlugin.exe.
5.
Führen Sie CcmServRtmtPlugin.exe aus.
6.
Folgen Sie den Anweisungen des Installationsassistenten von InstallAnywhere, akzeptieren Sie die Lizenzvereinbarung, und installieren Sie sie am standardmäßigen Speicherort des Ordners. Wenn Sie eine ältere Version von RTMT installiert haben, werden Sie vom
Installationsassistenten angewiesen, die alte Version zu deinstallieren, bevor Sie fortfahren.
7.
Wählen Sie Start > Programme > Cisco > Unified RTMT und starten Sie das Cisco Unified Real-Time Monitoring Tool.
8.
Geben Sie im Anmeldefenster des Real-Time Monitoring Tool die IP-Adresse für Ihren CUCM Publisher ein.
9.
Klicken Sie im Fenster Zertifikat zum Vertrauensspeicher hinzufügen auf Akzeptieren.
10.
Geben Sie im Fenster Authentication Required (Authentifizierung erforderlich) denselben Benutzernamen und dasselbe Kennwort ein, wie Sie sich auf der Seite CUCM
Administration (CUCM-Verwaltung) anmelden.
11.
Wenn Sie sich nicht anmelden können, fügen Sie Ihrem Benutzerkonto dieRealtime-
Berechtigung und die TraceCollection-Berechtigung hinzu, oder verwenden Sie das bei der Installation des Systems erstellte Administratorkonto, und versuchen Sie es erneut.
Die Anwendung wird geöffnet, und das Fenster "Konfiguration auswählen" wird angezeigt.
Klicken Sie auf OK, um die Standardkonfiguration auszuwählen.
Die Seite Systemübersicht wird geöffnet.
12.
Sie haben nun überprüft, ob RTMT installiert ist und dass Sie sich mit dem Tool bei Ihrem CUCM- Cluster anmelden können.
Detaillierte Ablaufverfolgung für den CallManager-Dienst konfigurieren oder bestätigen
In CUCM 9.x und höher ist die detaillierte Ablaufverfolgung standardmäßig für den CallManager- Dienst aktiviert. Bevor Sie fortfahren, überprüfen Sie, ob die detaillierte Ablaufverfolgung noch konfiguriert ist. Falls nicht, konfigurieren Sie es.
Melden Sie sich auf der Seite Cisco Unified Serviceability an.
1.
Wählen Sie Trace > Configuration aus.
2.
Wählen Sie in der Dropdown-Liste Server den CUCM Publisher aus, und klicken Sie auf Go (Los).
3.
Wählen Sie in der Dropdown-Liste "Servicegruppe" die Option CM-Dienste aus, und klicken Sie auf Los.
4.
Wählen Sie in der Dropdown-Liste Service die Option Cisco CallManager aus, und klicken Sie auf Go.
5.
Das System ist für die standardmäßige detaillierte Ablaufverfolgung konfiguriert, wie in diesem Bild gezeigt:
Trace On ist aktiviert.Die Debug Trace-Ebene ist auf Detailed festgelegt.Alle Trace-Filter sind aktiviert, mit Ausnahme: Verschiedene Spuren aktivierenSoftKey-Trace aktivierenRoute- oder Sammelanschlusslistenverfolgung aktivierenAlle GateWay-Ablaufverfolgungen aktivierenSCCP Keep Alive Trace aktivierenSpeedDial Trace aktivierenSIP-Keep-Alive- Funktion aktivieren (REGISTER-Aktualisierung)
Wenn das System nicht mit mindestens den detaillierten Standardeinstellungen für die Ablaufverfolgung konfiguriert ist und Sie CUCM 9.x oder höher verwenden:
Klicken Sie auf Standard festlegen. Dadurch wird die Ablaufverfolgungskonfiguration für 6.
diesen Dienst auf die Standardeinstellungen zurückgesetzt.Wählen Sie Auf alle Knoten anwenden aus.Klicken Sie auf Speichern.
Überprüfen Sie die Ablaufverfolgungskonfiguration auf den anderen Servern im Cluster.
7.
Wenn Sie eine frühere Version von CUCM verwenden, müssen Sie die
Ablaufverfolgungseinstellungen manuell so konfigurieren, dass sie der Abbildung entsprechen. Die Schaltfläche Standard für frühere Versionen festlegen setzt die Debug Trace Level auf Error, nicht Detailed.
Detaillierte Ablaufverfolgung für den CTI Manager-Service konfigurieren oder bestätigen
In CUCM 9.x und höher ist die detaillierte Ablaufverfolgung standardmäßig auch für den CTI Manager-Dienst aktiviert. Da dies möglicherweise geändert wurde, bestätigen oder konfigurieren Sie dies, bevor Sie fortfahren.
Melden Sie sich auf der Seite Cisco Unified Serviceability an.
1.
Wählen Sie Trace > Configuration aus.
2.
Wählen Sie aus der Server-Dropdown-Liste den CUCM Publisher aus, und klicken Sie auf Go.
3.
Wählen Sie in der Dropdown-Liste "Servicegruppe" die Option CM-Dienste aus, und klicken Sie auf Los.
4.
Wählen Sie in der Dropdown-Liste Service die Option Cisco CallManager aus, und klicken Sie auf Go.
Das System ist für die standardmäßige detaillierte Ablaufverfolgung konfiguriert, wie in diesem Bild gezeigt:
5.
Trace On ist aktiviert.Die Debug Trace-Ebene ist auf Detailed festgelegt.Alle Trace aktivieren ist aktiviert.
Wenn diese Einstellungen geändert wurden und Sie CUCM Version 9.x oder höher verwenden:
Klicken Sie auf Standard festlegen, um die Ablaufverfolgungskonfiguration auf die
Standardeinstellungen zurückzusetzen.Aktivieren Sie das Kontrollkästchen Auf alle Knoten anwenden.Klicken Sie auf Speichern.
6.
Überprüfen Sie die Ablaufverfolgungskonfiguration auf den anderen Servern im Cluster.
7.
Wie bei den CallManager-Ablaufverfolgungseinstellungen müssen Sie, wenn Sie eine ältere Version von CUCM verwenden, für die dieses Dokument vorgesehen ist, die
Ablaufverfolgungseinstellungen manuell konfigurieren, um der Abbildung zu entsprechen. Klicken Sie auf Standard für frühere Versionen festlegen, wenn Sie die Debug Trace Level auf Error festlegen müssen.
Hinweis: Aber was ist mit den Ereignisanzeige-Protokollen? Sie müssen die Debug-Ebenen weder für die Ereignisanzeige - Anwendungsprotokolle noch für die Ereignisanzeige - Systemprotokolle ändern. Sie fahren mit der Problemwiedergabe fort.
Reproduzieren Sie das Problem, und nehmen Sie Notizen auf.
In diesem Szenario führen Sie Testaufrufe aus, um einen Ausfall zu generieren. Wenn Sie dem TAC-Techniker jedoch eine Reihe von Ablaufverfolgungen ohne Informationen zu den Testanrufen bereitstellen, können diese die zu analysierenden Anrufe möglicherweise nicht finden. Sie
riskieren auch die Erfassung von Daten für den falschen Zeitraum und müssen von vorne beginnen.
Notieren Sie für jeden Testaufruf folgende Informationen:
Telefonnummer des anrufenden Teilnehmers
●
Telefonnummer des angerufenen Teilnehmers
●
Startzeit des Anrufs
●
Anrufendzeit
●
Zeit und Beschreibung für alle während des Anrufs aufgetretenen Probleme
●
Da CUCM-Traces sehr lang sein können, benötigt das TAC diese Anrufdetails, um Testanrufe in den Daten zu finden.
Sammeln der angeforderten Spuren
Nachdem das Problem reproduziert wurde, sammeln Sie sofort die vom TAC angeforderten
Spuren. Dadurch wird verhindert, dass die Ablaufverfolgungsdateien überschrieben werden, bevor Sie sie sammeln können.
In diesem Szenario müssen Sie CallManager-Ablaufverfolgungen, CTI Manager-
Ablaufverfolgungen und alle Ereignisanzeige-Protokolle sammeln. Sofern Ihnen das TAC keine anderen Anweisungen gegeben hat, sammeln Sie diese Dateien von allen Servern für den
gesamten Zeitraum, der Ihren Testanruf oder Ihre Anrufe abdeckt. Dadurch wird verhindert, dass Traces von einem Server fehlen, von dem Sie nicht wussten, dass er sich im Anruffluss befindet.
Starten Sie das RTMT.
1.
Stellen Sie eine Verbindung zur IP-Adresse Ihres CUCM Publisher her.
2.
Melden Sie sich mit den gleichen Anmeldeinformationen an, die Sie für die CUCM- Administration-Webseite verwenden.
3.
Wählen Sie System > Tools > Trace & Log Central aus.
4.
Doppelklicken Sie auf Dateien sammeln. Das Fenster Dateien sammeln wird geöffnet, und Sie können UCM-Dienste/Anwendungen auswählen.
5.
Klicken Sie unter Wählen Sie UCM-Dienste/Anwendungen aus in der Spalte Alle Server für:
auf das Kontrollkästchen.
Cisco CTIManagerCisco CallManager 6.
Klicken Sie auf Weiter. Im Fenster Dateien sammeln wird die Option Systemdienste/Anwendungen auswählen angezeigt.
7.
Klicken Sie in Select System Services/Applications (Systemdienste/Anwendungen auswählen) in der Spalte All Servers (Alle Server) für:
Ereignisanzeige-AnwendungsprotokollEreignisanzeige - Systemprotokoll 8.
Klicken Sie auf Weiter. Das Fenster "Dateien sammeln" wird zum Bildschirm "Dateioptionen sammeln" weitergeleitet.
9.
Konfigurieren Sie die Erfassungszeit: Wenn Sie Zeitstempel für Ihre Testanrufe haben, klicken Sie auf das Optionsfeld Absolute Range.Wählen Sie aus der Dropdown-Liste Von Datum/Uhrzeit die Uhrzeit für eine Minute vor dem ersten Testanruf aus.Wählen Sie aus der Dropdown-Liste Datum/Uhrzeit die Uhrzeit für eine Minute nach dem letzten Testanruf aus.
10.
Konfigurieren Sie Ihre Download-Dateioptionen. Klicken Sie auf Durchsuchen, um das Dateiverzeichnis herunterladen zu konfigurieren und ein neues Verzeichnis für jede Auflistung von Ablaufverfolgungsdateien anzugeben. Sie können diese Dateien
beispielsweise auf Desktop\TAC\callrectest01 herunterladen. Spuren für einen späteren Test finden Sie unter Desktop\TAC\callrectest02. Dadurch werden die gesammelten Dateisätze für jede Ausgabe-Wiedergabe organisiert und getrennt.Behalten Sie alle anderen Standardeinstellungen bei.
11.
Klicken Sie auf Fertig stellen.
12.
Sie werden feststellen, dass das Fenster Dateien sammeln den Status der
Ablaufverfolgungsauflistung aktualisiert. Während die Ablaufverfolgungsauflistung läuft, wird eine Cancel-Schaltfläche angezeigt. Wenn die Auflistung abgeschlossen ist, wird die Schaltfläche Abbrechen deaktiviert.
Nachverfolgungsdateiabdeckung überprüfen
Überprüfen Sie die von Ihnen gesammelten Dateien, um sicherzustellen, dass sie den Problemzeitrahmen abdecken. Die einfachste Methode hierfür ist die Überprüfung der TraceCollectionResult*.xml-Dateien.
Wenn RTMT eine Gruppe von Dateien sammelt, schreibt es eine TraceCollectionResult*.xml- Datei für jeden Server, von dem es Daten sammelt, in das Download-Dateiverzeichnis. Diese Dateien werden zusammen mit Unterverzeichnissen für jeden CUCM-Server angezeigt. Die TraceCollectionResult*.xml-Dateien geben an, welche Dateien erfolgreich von jedem Server heruntergeladen wurden. Die Unterverzeichnisse enthalten die eigentlichen Ablaufverfolgungs- und Protokolldateien.
Öffnen Sie jede TraceCollectionResult-Datei, und überprüfen Sie, ob das geänderte Datum für die aufgelistete Datei oder die aufgeführten Dateien dem Datums- und Zeitbereich für die Trace- Auflistung zugeordnet ist. Wenn Ablaufverfolgungsdateien nicht gesammelt werden konnten, z. B.
weil sie überschrieben wurden, fehlen sie.
Wenn Sie mit früheren Versionen von CUCM vertraut sind, stellen Sie fest, dass die Cisco
CallManager-Ablaufverfolgungen nur eine einzige Gruppe von SDL* Traces sind, nicht eine Reihe von SDL* Traces und eine Reihe von ccm* Traces. Dies liegt daran, dass Ablaufverfolgungen in CUCM 9.x und höher zur einfacheren Fehlerbehebung in einem einzelnen Dateisatz
zusammengefasst sind. Dasselbe gilt für den Cisco CTI Manager-Service. Anstatt sowohl SDL*
Traces als auch cti* Traces zu verwenden, werden alle Daten in den SDL* Traces für diesen Service gespeichert.
Probleme mit der Trace-Erfassung können in der Regel vermieden werden, wenn Sie Spuren unmittelbar nach der Reproduktion eines Problems sammeln.
Hinweis: Die TraceCollectionResult*.xml-Dateien enthalten einfach eine Liste von Dateien, die erfolgreich von jedem CUCM-Server gesammelt wurden. Das TAC muss die
gesammelten Trace- und Protokolldateien überprüfen.
Hinzufügen eines Ablaufverfolgungspakets zu Ihrer Serviceanfrage
Nachdem Sie nun alle Traces für Ihren Anruf zur Problemwiedergabe haben, müssen Sie diese an Ihren TAC-Techniker weiterleiten.
Wenn Sie die Traces heruntergeladen haben, haben Sie ein neues Download-Dateiverzeichnis angegeben. Dieses Verzeichnis enthält nun alle Protokoll- und Ablaufverfolgungsdateien sowie die TraceCollectionResult*.xml-Dateien. TAC wird in der Regel alle Inhalte des Download-
Dateiverzeichnisses, nicht nur eine oder zwei Dateien.
Um dies zu vereinfachen, laden Sie eine einzelne ZIP-Datei mit unserem Uploader für Ticket- Dateien hoch.
Komprimieren Sie das gesamte Download-Dateiverzeichnis in eine einzelne ZIP-Archivdatei.
1.
Navigieren Sie zu https://cway.cisco.com/csc.
Sie werden zu einer Anmeldeseite umgeleitet. Melden Sie sich mit Ihrem CCO- Benutzernamen und -Kennwort an.
Dadurch gelangen Sie zum Uploader für Ticket-Dateien.
2.
Geben Sie die Nummer Ihrer Serviceanfrage ein.
3.
Fügen Sie die ZIP-Datei hinzu.
4.
Fügen Sie eine Dateibeschreibung für Ihren TAC-Techniker hinzu. Dies ist eine gute Gelegenheit, Ihre Reproduktionsnotizen zu veröffentlichen.
5.
Klicken Sie auf Hochladen. Das Uploader für Ticket-Dateien zeigt den Upload-Status an.
Warten Sie, bis der Upload abgeschlossen ist.
6.
Schließen Sie das Browserfenster.
7.
Stellen Sie außerdem sicher, dass Sie Ihrem TAC-Techniker alle Reproduktionshinweise zu Problemen mitgeteilt haben, unabhängig davon, ob diese über das Upload-Tool, per E-Mail oder mündlich auftraten. So können sie mit der Analyse der Daten für Sie beginnen.
8.
Analyse
Die Cisco CallManager/CTI Manager-Ablaufverfolgungen für den jeweiligen Anruf können mithilfe des Collaboration Solutions Analyzer-Tools analysiert werden
(Verzeichnisdiagramm/Anmerkungen/gefilterte Protokolle/Diagnosesignaturen). Lesen Sie die Dokumentation zur Verwendung des Tools:
Benutzerdokumentation für Collaboration-Lösungen Analyzer
●
Analyzer für Collaboration-Lösungen
●
Zusammenfassung
In diesem Dokument wird erläutert, wie Sie das RTMT verwenden, um die gebräuchlichsten detaillierten Ablaufverfolgungen zur Fehlerbehebung für CUCM zusammen mit Ihrem TAC- Techniker zu sammeln, RTMT zu installieren, die Ablaufverfolgungskonfiguration in CUCM nachzuverfolgen, Probleme zu reproduzieren, Ablaufverfolgungsdateien zu sammeln und zu überprüfen und diese Dateien effizient an eine Serviceanfrage anzuhängen.
