Introduction
Ce document décrit le processus de collecte des journaux du connecteur de passerelle gérée Cisco IOS en mode de débogage.
Conditions préalables
Exigences
Accès au Control Hub avec des autorisations d'administrateur complet.
Accès à l'interface de ligne de commande (CLI) de la passerelle locale.
Accès au connecteur GuestShell.
Composants utilisés
Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :
- Application de connecteur (GuestShell)
- Version du logiciel Cisco IOS XE : 17.15.01a
- Version du script : 3.1.1
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.
Informations générales
Les connecteurs de passerelle sont de petites applications installées et exécutées sur le conteneur Cisco IOS XE GuestShell et permettent de maintenir une connexion sécurisée au Control Hub, de coordonner les événements et de collecter des informations d'état.
Lorsque vous rencontrez un problème avec le connecteur, les journaux de connexion au niveau de débogage sont requis pour le dépannage.
Étapes de collecte des journaux du connecteur de passerelle dans le niveau de débogage
Étape 1. Connectez-vous à la passerelle à l’aide d’une console ou d’une connexion SSH, copiez et collez la commande suivante à l’invite de commandes du mode d’exécution du routeur :
tclsh https://binaries.webex.com/ManagedGatewayScriptProdStable/gateway_onboarding.tcl
Remarque : Vous pouvez lancer (ou relancer) le script TCL directement en utilisant tclsh bootflash:gateway_connector/gateway_onboarding.tcl ou tclsh https://binaries.webex.com/ManagedGatewayScriptProdStable/gateway_onboarding.tcl à n'importe quel moment.
Étape 2. Le menu principal du connecteur apparaît :
===============================================================
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:
Appuyez sur v pour sélectionner l'option View and Modify Cloud Connector Settings.
Étape 3. Dans le menu suivant, appuyez sur l pour modifier le niveau de consignation du connecteur cloud.
===============================================================
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:
Étape 4. Dans le menu suivant, sélectionnez le niveau de journalisation du connecteur cloud.
===============================================
Number Log Level
===============================================
1 DEBUG
2 INFO
3 WARNING
4 ERROR
5 CRITICAL
===============================================
Étape 5. Appuyez sur 1 pour définir le niveau de journalisation sur DEBUG.
===============================================================
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:
Étape 6. Appuyez sur h pour accéder au menu principal.
===============================================================
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:
Étape 7. Répliquez le problème, puis sélectionnez l pour obtenir les journaux du connecteur. Une fois terminée, la ligne de commande affiche :
===============================================================
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:
Étape 8. Copiez l'URL bootlflash et appuyez sur q pour quitter GuestShell.
Remarque : Vous pouvez relancer le script TCL directement à partir de la mémoire bootflash en utilisant tclsh bootflash:gateway_connector/gateway_onboarding.tcl empêchant la passerelle de télécharger le script chaque fois que la commande est exécutée.
Exporter les journaux des connecteurs
Les journaux du connecteur sont enregistrés dans le répertoire bootflash. Vous pouvez utiliser FTP, SCP, TFTP, SFTP et tout autre protocole réseau de transfert de fichiers, cela dépend de vos préférences.
Cet exemple suppose qu'un serveur TFTP est utilisé pour transférer le journal du connecteur et le modifier si nécessaire.
Étape 1 : ajout de la commande suivante dans l’interface CLI de la passerelle
Router#copy bootflash:/guest-share/gateway_webex_cloud_logs_2025025014034.tar.gz tftp:///.tar.gz
Étape 2 : saisissez l’adresse du serveur TFTP.
Address or name of remote host []?
Étape 3. Confirmez le nom du fichier, puis appuyez sur Entrée.
Destination filename [gateway_webex_cloud_logs_2025025014034.tar.gz]?
!!
32137 bytes copied in 4.714 secs (6817 bytes/sec)
Router#
Étape 4 : Téléchargez le fichier .tar dans le dossier Cisco TAC.