Einleitung
In diesem Dokument wird der Prozess zum Sammeln der von Cisco IOS verwalteten Gateway-Connector-Protokolle im Debugmodus beschrieben.
Voraussetzungen
Anforderungen
Zugriff auf Control Hub mit vollständigen Administratorberechtigungen
Zugriff auf die CLI (Command Line Interface) des lokalen Gateways.
Zugriff auf die Connector GuestShell
Verwendete Komponenten
Die Informationen in diesem Dokument basierend auf folgenden Software- und Hardware-Versionen:
- Connector-Anwendung (GuestShell)
- Cisco IOS XE-Softwareversion: 17.15.01a
- Skriptversion: 3.1.1
Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell eingerichteten Testumgebung. Alle Geräte, die in diesem Dokument benutzt wurden, begannen mit einer gelöschten (Nichterfüllungs) Konfiguration. Wenn Ihr Netzwerk in Betrieb ist, stellen Sie sicher, dass Sie die möglichen Auswirkungen aller Befehle kennen.
Hintergrundinformationen
Gateway-Connectors sind kleine Anwendungen, die im Cisco IOS XE GuestShell-Container installiert und ausgeführt werden und eine sichere Verbindung zum Control Hub gewährleisten, Ereignisse koordinieren und Statusinformationen erfassen.
Wenn Sie ein Problem mit dem Connector haben, sind zur Fehlerbehebung Connector-Protokolle auf Debugging-Ebene erforderlich.
Schritte zum Erfassen von Gateway-Connector-Protokollen auf Debugging-Ebene
Schritt 1: Melden Sie sich über eine Konsole oder eine SSH-Verbindung beim Gateway an, kopieren Sie den nächsten Befehl, und fügen Sie ihn in die Eingabeaufforderung von router exec ein:
tclsh https://binaries.webex.com/ManagedGatewayScriptProdStable/gateway_onboarding.tcl
Anmerkung: Sie können das TCL-Skript direkt starten (oder neu starten), indem Sie tclsh bootflash:gateway_connector/gateway_onboarding.tcl oder tclsh https://binaries.webex.com/ManagedGatewayScriptProdStable/gateway_onboarding.tcl an einem beliebigen Punkt verwenden.
Schritt 2: Das Hauptmenü des Steckverbinders wird angezeigt:
===============================================================
Webex Managed Gateway Connector
===============================================================
Options
s : Display Status Page
v : View and Modify Cloud Connector Settings
e : Enable Guestshell
d : Disable Guestshell
l : Collect Logs
r : Clear Logs
u : Uninstall Connector
p : Apply Patch
q : Quit
===============================================================
Select an option from the menu:
Drücken Sie v, um die Option Cloud Connector-Einstellungen anzeigen und ändern auszuwählen.
Schritt 3: Drücken Sie im nächsten Menü l, um die Protokollstufe für Cloud Connector zu ändern.
===============================================================
Webex Managed Gateway Connector
===============================================================
Script Version : 3.1.1
Hostname/IP Addr : X.X.X.X
DNS Server(s) : X.X.X.X 8.8.8.8
X.X.X.X
Gateway Username : doctorx
External Interface : GigabitEthernet2
===============================================================
Options
c : Update Gateway Credentials
e : Update External Interface
p : Update Proxy Details
n : Update DNS Server
k : Update Connector Package Verification Key
l : Modify log level for Cloud Connector
h : Go to home menu
q : Quit
===============================================================
Select an option from the menu:
Schritt 4: Wählen Sie aus dem nächsten Menü die Protokollstufe für den Cloud Connector aus.
===============================================
Number Log Level
===============================================
1 DEBUG
2 INFO
3 WARNING
4 ERROR
5 CRITICAL
===============================================
Schritt 5. Drücken Sie 1, um die Protokollstufe auf DEBUG einzustellen.
===============================================================
Webex Managed Gateway Connector
===============================================================
Cloud Connector log level is set to : 1
===============================================
Number Log Level
===============================================
1 DEBUG
===============================================
===============================================================
Select option h for home menu or q to quit:
Schritt 6. Drücken Sie h, um zum Startmenü zu wechseln.
===============================================================
Webex Managed Gateway Connector
===============================================================
Options
s : Display Status Page
v : View and Modify Cloud Connector Settings
e : Enable Guestshell
d : Disable Guestshell
l : Collect Logs
r : Clear Logs
u : Uninstall Connector
p : Apply Patch
q : Quit
===============================================================
Select an option from the menu:
Schritt 7: Replizieren Sie das Problem, und wählen Sie dann l, um die Connector-Protokolle abzurufen. Nach Abschluss dieses Vorgangs wird in der Befehlszeile Folgendes angezeigt:
===============================================================
Webex Managed Gateway Connector
===============================================================
Log files are collected and stored at location
bootflash:/guest-share/gateway_webex_cloud_logs_2025025014034.tar.gz
===============================================================
Select option h for home menu or q to quit:
Schritt 8: Kopieren Sie die URL bootlashh, und drücken Sie q, um die GuestShell zu beenden.
Anmerkung: Sie können das TCL-Skript direkt aus dem Bootflash-Speicher mit tclsh bootflash:gateway_connector/gateway_onboarding.tcl neu starten, sodass das Gateway das Skript nicht herunterladen kann, wenn der Befehl ausgeführt wird.
Connector-Protokolle exportieren
Die Connector-Protokolle werden im Bootflash-Verzeichnis gespeichert. Sie können FTP, SCP, TFTP, SFTP und andere Netzwerkprotokolle für die Dateiübertragung verwenden. Dies hängt von Ihrer Präferenz ab.
In diesem Beispiel wird davon ausgegangen, dass ein TFTP-Server verwendet wird, um das Connector-Protokoll zu übertragen und ggf. zu ändern.
Schritt 1: Fügen Sie den nächsten Befehl in der Gateway-CLI hinzu.
Router#copy bootflash:/guest-share/gateway_webex_cloud_logs_2025025014034.tar.gz tftp:///.tar.gz
Schritt 2: Geben Sie die TFTP-Serveradresse ein.
Address or name of remote host []?
Schritt 3. Bestätigen Sie den Dateinamen, und drücken Sie die Eingabetaste.
Destination filename [gateway_webex_cloud_logs_2025025014034.tar.gz]?
!!
32137 bytes copied in 4.714 secs (6817 bytes/sec)
Router#
Schritt 4: Laden Sie die TAR-Datei in das Cisco TAC-Ticket hoch.